🦞
Clawdbot
Solana companion · agent runtime
self-hosted
Self-host your Solana AI companion

I speak fluent bash,
mild sarcasm, and
aggressive tab-completion.

Clawdbot is the Solana trading & launch companion — a multi-channel AI agent runtime. Telegram, CLI, Web control, and Mobile. One codebase, one wallet, two hundred shell miles an hour.

your server — bootstrap
● one-line install
1$ curl -fsSL https://vibebot.app/install | bash
2✅ VibeBot ready
3 Enabled 3 hooks: boot-md, command-logger, session-memory
4 Gateway: local · ws://127.0.0.1:18789 · loopback
5$ pnpm telegram # bot on Telegram
6$ pnpm web # this portal + Control UI → localhost:3000
7$ pnpm cli # terminal CLI
TelegramCLIWeb control UIMobile · ExpoAgent walletSolana coreFree ClawdRouter AIMetaplex NFT TelegramCLIWeb control UIMobile · ExpoAgent walletSolana coreFree ClawdRouter AIMetaplex NFT
/ 01 · SELF-HOST

One machine, one line,
and it's yours.

Clawdbot runs entirely on your own host. No managed cloud, no surprise accounts — your keys stay on your box.

STEP 1

Bootstrap

Clone, install all workspaces, seed .env — Corepack handles pnpm for you.

$ npm run bootstrap
STEP 2

Wire secrets

Drop in a Telegram bot token or a wallet key. Free ClawdRouter AI kicks in until you add a paid model key.

TELEGRAM_BOT_TOKEN=… WALLET_PRIVATE_KEY=… SOLANA_RPC_URL=…
STEP 3

Run an interface

Start one — or all four — from the same runtime. The control portal you're reading is the web surface.

$ pnpm web $ pnpm telegram $ pnpm cli
/ 02 · CAPABILITIES

Ship trades, launches,
and agents — from one runtime.

Everything a Solana operator needs, packaged as installable workspaces. Deploy to Docker or Fly with the same repo.

01

Swap & trade

Live Solana swaps and market reads through a shared core. Sessions persist, positions stay visible, Telegram gets the receipts.

state ● live · rpc mainnet / devnet
02

Launch tokens

Token launch execution routed through an explicit adapter contract — no fabricated signatures. Validate first, then submit.

operation launchToken · explicit adapter
03

Mint NFTs

Metaplex-backed NFT collections and mints. Deploy a collection, then mint — each via its own adapter override.

deployNFTCollection · mintNFT
04

Multi-provider AI

Moonshot/Kimi and DeepSeek V4 preferred, free ClawdRouter fallback when no paid keys are set. Model override from one env var.

VIBEBOT_MODEL=kimi-k3 · MOONSHOT_API_KEY · DEEPSEEK_API_KEY · CLAWD_ROUTER_FREE=1
05

Session memory

Agents keep context across conversations with persistent stores. Heartbeat keeps the main agent warm on a schedule.

stores persistent · heartbeat 30m
06

Market data

CoinGecko-powered market data plus a Solana GPT catalog — Helius, Birdeye, or Solana Tracker keys feed the portfolio cascade.

HELIUS_API_KEY · BIRDEYE_API_KEY · SOLANA_TRACKER_API_KEY
/ 03 · INTERFACES

Four doors into the same bot.

Same runtime, four surfaces. Start any of them with one pnpm command after bootstrap.

Telegram 🦞
Your bot on Telegram — token launches, trades, and agent replies straight to the channel.
pnpm telegram
@vibebot/telegram
CLI
Full terminal control — status, market, launch, wallet, NFT. The personality lives here.
pnpm cli
@vibebot/cli
Web
API plus control UI — gateway status, agents, sessions, channels, skills and logs.
pnpm web
Mobile
Expo-based mobile surface — trade and monitor from your pocket.
pnpm mobile
@vibebot/mobile
4×
interfaces, one runtime
Telegram · CLI · Web · Mobile
6
capability pillars
trade · launch · NFT · AI · memory · data
1line
to bootstrap
npm run bootstrap
0
managed cloud
keys stay on your host
/ 04 · YOUR PORTAL

You're already inside it.

This page ships with the web package. Once your bot runs, the real control surfaces live one click away.

Control UI · real-time

Open the Control UI

Gateway status, agents, sessions, channels, cron, skills, nodes, config, debug and live logs — the full command deck of your running bot.

/control/ →
Terminal · interactive

Jump to the terminal

The web terminal for quick commands against your runtime — status, market, launch, wallet, NFT. No SSH required.

/terminal →