Skip to content

Solizardking/NemoClaw

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2,776 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Nemo Clawd
Solana x xAI Agentic Trading Engine — Powered by $CLAWD

8cHzQHUS2s2h8TzCmfqPKYiM4dSt4roa3n7MyRLApump

npm License Status Solana xAI Grok MCP Tools Multi-Agent


Solana Clawd Integration

Nemo Clawd includes the Solana Clawd agentic framework for Solana trading, research, and autonomous agent operations.

What You Get

┌─────────────────────────────────────────────────────────────────────┐
│                                                                 │
│   xAI Grok Integration ─── 4-16 Grok agents with web + X search  │
│   │                     Chat, vision, image gen, voice          │
│   │                                                             │
│   $CLAWD Token ───────── 8cHzQHUS2s2h8TzCmfqPKYiM4dSt4roa3n7MyRLApump │
│   │                     Solana + Pump.fun native                │
│   │                                                             │
│   31 MCP Tools ───────── Solana market data, trading, NFTs      │
│   │                     Helius RPC/DAS, Pump.fun SDK            │
│   │                                                             │
│   Multi-Agent Research ─ 4 or 16 Grok agents collaborating     │
│   │                     Deep Solana research + intelligence   │
│   │                                                             │
│   Blockchain Buddies ─── 18 species with trading personalities  │
│   │                     Procedurally generated companions       │
│   │                                                             │
│   Voice Mode ─────────── xAI Grok text-to-speech agent          │
│   │                     Conversational AI + STT                 │
│   │                                                             │
│   Telegram Bot ───────── 60+ commands for trading + research    │
│                         Real-time alerts, sniping, narration    │
│                                                                 │
└─────────────────────────────────────────────────────────────────────┘

Quick Start

npm install -g @mawdbotsonsolana/nemoclawd

# If npm returns E404 from a source checkout, build and link locally.
./install.sh

# Start with Grok + Solana tools
nemoclawd launch

# Inspect dry-run wallet, RPC, policy, and trade guardrails
nemoclawd financial-harness

# Run demo walkthrough
nemoclawd demo

Installer Seeded Runtime

install.sh seeds a Nemo Clawd runtime under ~/.nemoclawd/:

  • solana.json with the 8bit/DeepSolana own-model profile and dry-run trading defaults.
  • wallets/nemoclawd-local-private-keypair.json when solana-keygen is available. The file is mode 600, unfunded, and never copied into the sandbox.
  • agent.json with the lobster-themed Clawd agent command deck.
  • trading-box.json with the dry-run trading box, required policy posture, and operator-approval guardrails.

Live signing and transaction submission are off after install. Run nemoclawd financial-harness before starting any Solana runtime services.

xAI Grok Setup

export XAI_API_KEY="your_key"  # One key unlocks everything
export HELIUS_API_KEY="your_free_key"  # From helius.dev

Grok Models

Model What it does Use case
grok-4.20-reasoning Chat, reasoning, vision, structured output, voice Default for everything
grok-4.20-multi-agent 4-16 agents collaborating in real-time Deep research, complex analysis
grok-4-1-fast Quick responses, low latency Fast queries, real-time UX
grok-imagine-image Image generation + editing Memes, avatars, visualizations

MCP Tools (31)

Solana Market Data:

  • solana_price, solana_trending, solana_token_info, solana_wallet_pnl
  • solana_search, solana_top_traders, solana_wallet_tokens, sol_price

Helius Onchain:

  • helius_account_info, helius_balance, helius_transactions
  • helius_priority_fee, helius_das_asset, helius_webhook_create

Agent Fleet:

  • agent_spawn, agent_list, agent_stop

Memory:

  • memory_recall, memory_write

Metaplex:

  • metaplex_mint_agent, metaplex_register_identity, metaplex_read_agent

Pump.fun:

  • pump_token_scan, pump_buy_quote, pump_sell_quote, pump_graduation

OODA Trading Loop

OBSERVE  → sol_price, trending, helius_priority_fee, memory KNOWN
ORIENT   → score candidates (trend + momentum + liquidity + participation)
DECIDE   → confidence ≥ 60? → size band (0.5x / 1.0x / 1.25x / 1.5x)
ACT      → trade_execute gated at `ask` permission (human approval required)
LEARN    → write INFERRED signals → Dream agent promotes to LEARNED

Agent Fleet

Agent Type Description
$CLAWD Clawd Full autonomous agent — chat, vision, image gen, multi-agent, voice
Grok Researcher GrokResearcher 16-agent deep research with web + X search
Explorer Explore Read-only Solana research (fast, cheap)
Scanner Scanner Trend monitoring, surfaces high-signal opportunities
OODA OODA Full trading cycle: Observe, Orient, Decide, Act, Learn
Dream Dream Memory consolidation (INFERRED to LEARNED promotion)
Analyst Analyst Deep structured research reports
Monitor Monitor Helius WebSocket event listeners

Blockchain Buddies

Every Nemo Clawd user gets a companion — a procedurally generated Blockchain Buddy with its own wallet, trading personality, stats, and animated ASCII sprite.

nemoclawd birth   # hatch yours now

Species (18 total)

Category Species Personality Risk Level
Solana Natives SolDog, BONK Dog, dogwifhat, Jupiter Agg, Raydium LP Diamond Hands / Degen / Bot Low → Degen
DeFi Archetypes Whale, Bull, Bear, MEV Shark, Octopus Whale / Sniper / Ninja Low → Medium
Memecoin Culture Pepe, Pump.fun, Sniper Bot Degen / Sniper High → Degen

Telegram Trading Bot

Commands

Command Response
/sol SOL price (CoinGecko)
/price <mint|symbol> Token price
/trending Top 10 trending tokens
/wallet <address> Wallet PnL analysis
/scan Toggle background pump scanner
/snipe [config] Start sniper bot
/grok <question> Chat with Grok
/xsearch <query> Search X/Twitter live
/imagine <prompt> Generate images

Deploy to Fly.io

cd nemo-clawd-mcp
fly launch --config fly.toml
fly secrets set HELIUS_API_KEY=your-key XAI_API_KEY=your-key MCP_API_KEY=optional-bearer-token

Then connect via:

{ "type": "http", "url": "https://your-app.fly.dev/mcp" }

Architecture

                     ┌─────────────────────────────────────────────────────┐
                     │                  ENTRY POINTS                       │
                     │  Nemo Clawd CLI    MCP Server    Telegram Bot       │
                     │  (interactive/   (stdio/HTTP)   60+ commands       │
                     │   one-shot)                                        │
                     └────────┬──────────┬────────────────┬────────────────┘
                              │          │                │
                              ▼          ▼                ▼
                     ┌─────────────────────────────────────────────────────┐
                     │                  CORE ENGINE                        │
                     │  QueryEngine ──► xAI Grok ──► Tool Execution       │
                     │    │              │              │               │
                     │    │  Providers:   │   ┌──────────┤               │
                     │    │  - xAI/Grok   │   │          │               │
                     │    │  - OpenRouter │   ▼          ▼               │
                     │    │  - Anthropic  │  ToolExecutor  Permission     │
                     └─────┼──────────────┼──────────────────────────────┘
                           │              │
               ┌───────────┴──────────────┴──────────────────────────────┐
               │                              │                         │
               ▼                              ▼                         ▼
┌──────────────────────┐  ┌──────────────────────────┐  ┌────────────────┐
│     SUPPORT LAYER    │  │      MEMORY SYSTEM       │  │   DATA SOURCES │
│                      │  │                          │  │                │
│  AppState (Zustand)  │  │  KNOWN   (ephemeral,     │  │  Helius RPC    │
│  - PermissionMode    │  │           ~60s TTL)      │  │  Helius DAS    │
│  - OODA phase        │  │                          │  │  Pump.fun      │
│  - PumpSignals       │  │  LEARNED (persistent,    │  │  Jupiter       │
│                      │  │           cross-session)  │  │                │
│  Risk Engine         │  │                          │  │  Solana Tracker│
└──────────────────────┘  │  INFERRED (tentative,    │  │                │
                          │           markdown)       │  │                │
                          └──────────────────────────┘  └────────────────┘

Environment Variables

# Core (free at helius.dev)
HELIUS_API_KEY=               # RPC, DAS, enhanced txs, webhooks
HELIUS_RPC_URL=               # Helius mainnet RPC

# xAI Grok (one key unlocks everything)
XAI_API_KEY=                  # Grok: chat, voice, vision, search, multi-agent

# OpenRouter (optional)
OPENROUTER_API_KEY=           # Multi-model LLM routing

# Telegram
TELEGRAM_BOT_TOKEN=           # From @BotFather

# Wallet (optional)
SOLANA_PRIVATE_KEY=           # Base58 keypair for live trades
SOLANA_PUBLIC_KEY=           # Default wallet

License

Licensed under Apache 2.0.

$CLAWD 8cHzQHUS2s2h8TzCmfqPKYiM4dSt4roa3n7MyRLApump

Powered by xAI Grok from xAI | Built on Solana

About

Run agents like Hermes and OpenClaw more securely inside NVIDIA OpenShell with managed inference

Resources

License

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors