🦞 Clawd Code CLI

A lobster-themed AI terminal operator for coding, system ops & Solana

🦞 "Claws that code, brains that deploy" 🦞

╔═══════════════════════════════════════════════════════════════╗
║                                                               ║
║   ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄      ║
║  ╱▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔╲     ║
║ ║  █████╗   ║                                              ║    ║
║ ║ ██╔══██╗  ║   🦞  CLAWD CODE CLI  🦞                   ║    ║
║ ║ ╚══█╔═╝  ║                                              ║    ║
║ ║   ██║     ║   "Claws that code, brains that deploy"     ║    ║
║ ║   ██║     ║                                              ║    ║
║ ║   ╚═╝     ║   Multi-Provider AI Terminal Operator        ║    ║
║ ║  ▄█████╗  ║   Grok · Ollama · OpenRouter · OpenAI       ║    ║
║ ║ ██╔══██╗║   Solana · MCP · File Tools                  ║    ║
║ ║ ╚══█╔═╝  ║                                              ║    ║
║ ║   ██║     ║   CLAWD Token: 8cHzQHUS2s2h8TzCmfqPKYiM4   ║    ║
║ ║   ╚═╝     ║   dSt4roa3n7MyRLApump                        ║    ║
║  ╲▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔╱     ║
║   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀      ║
╚═══════════════════════════════════════════════════════════════╝

🦞 About

Clawd Code CLI is a lobster-themed AI terminal agent built for Solana operators, developers, and degen builders. It speaks to you through a retro ASCII terminal, runs entirely in your terminal, and lets you switch between Grok, Ollama (local), OpenRouter, and OpenAI backends on the fly — no restart needed.

CLAWD Token: 8cHzQHUS2s2h8TzCmfqPKYiM4dSt4roa3n7MyRLApump

Features

• 🦞 Lobster-branded UI — ASCII art logo, per-provider spinner animations, themed loading messages
• ⚡ Multi-Provider Routing — Grok · Ollama · OpenRouter · OpenAI · custom, switched live via /models
• 🔧 AI File Operations — view_file, create_file, str_replace_editor (no overwrite accidents)
• 💻 Bash + Shell Tools — execute commands, grep, find, navigate
• 📋 Todo Lists — plan and track tasks with visual priority flags
• 🔌 MCP Support — extend with any Model Context Protocol server
• 🪙 Solana Tools — query assets, prices, wallet balances via Helius DAS API + Birdeye
• 📊 Full Birdeye Suite — token overview, metadata (single/multi), market data, trade data, search, trending, OHLCV, wallet portfolio
• 🦋 DFlow Trading — swap quotes + build across DFlow-aggregated venues, prediction-market init, priority fees (REST + WebSocket)
• 🔮 Prediction Markets — DFlow (Kalshi-on-Solana), Polymarket (Gamma + CLOB), Kalshi direct with RSA-PSS signing
• 🚀 Token Launches — pump.fun via PumpPortal local signing + Bags.fm fee-sharing launches
• 🔑 Local Signing Wallet — base58 / JSON-array keypair, signs versioned + legacy txs, confirmation-gated broadcasts
• 🌐 Web Search — real-time search for Grok models (auto-detected)
• 🔐 Persistent Settings — ~/.clawd/user-settings.json remembers your API keys and model preferences

Installation

# Recommended
npm install -g clawd-code-cli

# Or with bun
bun add -g clawd-code-cli

The clawd and claw aliases are registered automatically.

Quick Start

clawd

On first run it will prompt for your Grok API key (from xAI). Or set it once:

# From inside clawd:
/config grok key xai-your-key-here

# Or as environment variable
export GROK_API_KEY=xai-your-key-here
clawd

Multi-Provider Setup

OpenRouter (Claude, Gemini, Llama, DeepSeek...)

# Inside clawd:
/config openrouter key sk-or-v1-your-key-here

# Then switch to any OpenRouter model:
/models
# or
/config add model openrouter/anthropic/claude-opus-4.7
/config set defaultModel openrouter/anthropic/claude-opus-4.7

Ollama (Local Models)

# Inside clawd:
/config ollama baseURL http://localhost:11434/v1

# Default Ollama models are already in the list:
# ollama/gemma4:latest, ollama/DeepSolana:latest, etc.
/models

OpenAI

/config openai key sk-your-key-here
/config add model openai/gpt-4o
/config set defaultModel openai/gpt-4o

CLI Commands

| Command | Description | |---------|-------------| | /models | Open interactive model selector | | /models <name> | Switch directly to a model by name | | /config | Show all provider configs (keys masked) | | /config <provider> key <key> | Set API key for a provider | | /config <provider> baseURL <url> | Set base URL for a provider | | /config add model <name> | Add a model to the available list | | /config set defaultModel <model> | Set the default model (also switches active session) | | /provider | Show active model's provider, base URL, and masked key | | /clear | Clear chat history | | /help | Show full help | | /commit-and-push | AI-generated git commit + push | | /search <query> | Grok Live Search of the web with citations (xAI) | | /x <query> | Grok Live Search of X/Twitter with citations (xAI) | | /voice | Show voice status / usage | | /voice say <text> | Speak text aloud via xAI TTS (Grok voices) | | /voice last | Speak the last assistant message | | /voice on / /voice off | Toggle auto-speak of assistant responses | | /voice voice <name> | Pick a voice: eve, ara, rex, sal, leo | | /voice listen [n] | Record n sec from mic (default 5), transcribe via xAI STT, submit | | /exit | Exit |

Live Search — /search and /x

Both commands hit Grok's Live Search via the xAI chat completions endpoint and stream the model's answer plus citations back into the chat.

• /search <query> — search the open web
• /x <query> — search X / Twitter

Requirements: an xAI API key (XAI_API_KEY env var or /config grok key <xai-...>). Up to 10 citations are appended to each result.

Voice I/O — powered by Grok

/voice is two-way speech, fully on xAI:

• TTS: xAI's /v1/tts endpoint with the five Grok voices (eve, ara, rex, sal, leo). Audio plays via afplay on macOS or ffplay/mpg123/aplay on Linux. Falls back to macOS say only if no XAI_API_KEY is set.
• STT: records from the default mic via ffmpeg (avfoundation on macOS, ALSA on Linux), then transcribes through xAI's /v1/stt endpoint.

Requirements for /voice say and auto-speak:

• An xAI API key — XAI_API_KEY env var or /config grok key <xai-...>
• An audio player on PATH (macOS has afplay built-in; Linux: brew install ffmpeg or apt install mpg123)

Requirements for /voice listen:

• ffmpeg on PATH (macOS: brew install ffmpeg)
• An xAI API key (same as TTS)
• On macOS, grant mic permission to your terminal app the first time you run it

The transcribed text is fed straight into the agent as if you'd typed it.

Shortcuts: ↑/↓ navigate history, Tab complete suggestions, Shift+Tab toggle auto-edit, Esc abort.

Command Line Options

clawd [options]

Options:
  -V, --version           output the version number
  -d, --directory <dir>   working directory
  -k, --api-key <key>    Grok API key
  -u, --base-url <url>    Grok API base URL
  -m, --model <model>     default model
  -p, --prompt <prompt>   headless mode — one prompt, then exit
  --max-tool-rounds <n>   max tool loops (default: 400)
  -h, --help              show help

Provider Model Reference

Grok (xAI) — default

grok-4-1-fast-reasoning
grok-4-fast-reasoning
grok-4-fast-non-reasoning
grok-4
grok-3
grok-3-fast
grok-code-fast-1

OpenRouter

openrouter/anthropic/claude-opus-4.7
openrouter/anthropic/claude-sonnet-4
openrouter/anthropic/claude-3.5-sonnet
openrouter/google/gemini-2.5-pro
openrouter/google/gemini-2.0-flash
openrouter/meta-llama/llama-4-maverick
openrouter/deepseek/deepseek-chat-v3
openrouter/deepseek/deepseek-coder
openrouter/x-ai/grok-3
openrouter/qwen/qwen-3

OpenAI

openai/gpt-4.5
openai/gpt-4o
openai/gpt-4o-mini
openai/o3
openai/o3-mini
openai/o4-mini

Ollama (localhost:11434)

ollama/gemma4:latest
ollama/DeepSolana:latest
ollama/minimax-m2.7:cloud
ollama/glm-5.1:cloud
ollama/mxbai-embed-large:latest

Solana Integration

# Set environment variables
export HELIUS_API_KEY=your_helius_key
export BIRDEYE_API_KEY=your_birdeye_key

# Then inside clawd you can ask:
"show me my Solana wallet balance"
"get the price of $BONK"
"look up this NFT asset ..."

Birdeye Tool Suite

Every BIRDEYE_API_KEY-gated endpoint is wired as a tool the agent can call:

| Tool | Endpoint | |------|----------| | birdeye_token_overview | /defi/token_overview — price, market cap, FDV, liquidity, wallets, volume, holders | | birdeye_token_metadata / _multi | /defi/v3/token/meta-data/single + /multiple (up to 50) | | birdeye_token_market_data / _multi | /defi/v3/token/market-data + /multiple (up to 20) | | birdeye_token_trade_data / _multi | /defi/v3/token/trade-data/single + /multiple | | birdeye_search_token | /defi/v3/search — keyword search, sorted by 24h USD volume | | birdeye_token_list | /defi/tokenlist — paginated, configurable sort | | birdeye_trending | /defi/token_trending | | birdeye_ohlcv | /defi/ohlcv — 1m through 1M candles | | birdeye_wallet_portfolio | /v1/wallet/token_list |

Prompt examples:

"search birdeye for pepe tokens sorted by volume"
"get the 1h trade data for $BONK"
"show me the top 20 trending solana tokens right now"
"what's my wallet portfolio worth" (set SOLANA_PRIVATE_KEY)

Blockchain Trading + Prediction Markets

Turn on the signing wallet + DFlow and the CLI becomes a full trading terminal.

Environment

# Local signing wallet (DO NOT commit)
SOLANA_PRIVATE_KEY=   # base58 (Phantom export) or JSON array
SOLANA_RPC_URL=

# DFlow — Solana swap aggregation + Kalshi-on-Solana prediction markets
DFLOW_API_KEY=        # contact [email protected]
DFLOW_TRADING_URL=https://quote-api.dflow.net
DFLOW_METADATA_URL=https://dev-prediction-markets-api.dflow.net

# Bags.fm — launch tokens with fee sharing
BAGS_API_KEY=
BAGS_PARTNER_CONFIG_KEY=

# Kalshi direct (RSA-PSS signed requests)
KALSHI_KEY_ID=
KALSHI_PRIVATE_KEY=        # PEM with \n or use _FILE
KALSHI_PRIVATE_KEY_FILE=
KALSHI_ENV=prod            # or `demo`

DFlow — trading + prediction markets

Tools surface the Trading API (tokens, venues, priority fees, swap quote/build, order status, prediction-market init) and the Metadata API (events, markets, orderbook, trades, on-chain fills, live Kalshi data, series, tags, sports filters, candlesticks, search) plus a WebSocket priority-fee stream.

Three-step swap flow the agent will chain automatically:

"quote me a swap for 0.1 SOL -> USDC via DFlow"
  -> dflow_swap_quote
  -> dflow_build_swap
  -> wallet_sign_and_send  (gated by confirmation prompt)

Other DFlow examples:

"init a prediction market for outcome mint <mint>"
"show me the orderbook for market KXNBAGAME-..."
"get live Kalshi data for milestone ids a,b,c"
"stream 5 priority-fee updates from DFlow"

Polymarket

Read-only via the public Gamma + CLOB endpoints — no key required.

"find trending Polymarket events"
"get the polymarket orderbook for token <id>"
"what's the midpoint on this market"

Placing Polymarket orders requires L2 (EIP-712) signing with a Polygon key — not wired by default; the polymarket_place_order stub returns a clear "not enabled" error.

Kalshi direct

Full RSA-PSS request signing with KALSHI_KEY_ID + KALSHI_PRIVATE_KEY. Reads (markets, orderbook, balance, positions, fills, orders) and writes (place/cancel orders) are exposed; kalshi_place_order is confirmation-gated.

Token launches

• PumpPortal (pump_launch_token, pump_trade) — creates pump.fun SPL tokens, uploads metadata to pump.fun IPFS, generates mint, signs with your local keypair.
• Bags.fm (bags_launch_token, bags_swap, bags_claim_fees, bags_positions) — launch with fee-recipient splits and claim accumulated creator fees.

Example prompts:

"launch a pump.fun token called CLAWD2 with ticker CLW2, buy 0.2 SOL at launch"
"sell 50% of my position in <mint>"
"launch a bags.fm token with 50% fees to <wallet>"
"claim all my bags.fm fees"

Safety

Every action that moves SOL or places a trade routes through the existing ConfirmationTool — nothing fires until you approve the prompt in the terminal. The wallet loader refuses to start if SOLANA_PRIVATE_KEY is malformed, and DFlow / Kalshi / Bags endpoints return structured errors (not crashes) when keys are missing.

Local Development

git clone https://github.com/8bit/clawd-code-cli.git
cd clawd-code-cli
npm install
npm run build
npm link   # symlink locally for testing
clawd

🦞 CLAWD Token

CLAWD is the token of the Clawd ecosystem.持有 CLAWD to access premium features, agent minting, and governance.

• Mint: 8cHzQHUS2s2h8TzCmfqPKYiM4dSt4roa3n7MyRLApump
• Blockchain: Solana
• CLI Integration: Use the Solana tools in clawd to query CLAWD token data, balances, and more.

License

MIT