clawdbot-go

    ██████╗  ██████╗ ██████╗  ██████╗ ████████╗
   ██╔════╝ ██╔═══██╗██╔══██╗██╔═══██╗╚══██╔══╝
   ██║  ███╗██║   ██║██████╔╝██║   ██║   ██║
   ██║   ██║██║   ██║██╔══██╗██║   ██║   ██║
   ╚██████╔╝╚██████╔╝██████╔╝╚██████╔╝   ██║
    ╚═════╝  ╚═════╝ ╚═════╝  ╚═════╝    ╚═╝

🐹 Sovereign Solana Trading Intelligence

Autonomous OODA Agent · Agent DNA · ZK Primitives · Privacy by Default · Helius DAS · Vulcan/Phoenix Perpetuals · Jupiter Swaps · Hardware I2C · Web Console

*70 Go source files · 42 packages · 21,400+ lines · 3 binaries · <10MB RAM · Solana-first *GLM-5.2 and DeepSolana

Quick Start · Architecture · The Six Laws · CLI Reference · Security · Release

---

Overview

GoBot is the world's first Solana-native sovereign AI agent — a full-stack autonomous trading intelligence bound by Go Bot's full six-law harness: three immutable on-chain laws and three off-chain interpretive laws. Built in pure Go for minimal resource consumption, it orchestrates on-chain data providers, zk primitives, and x402-gated surfaces through a military-grade OODA decision loop with persistent epistemological memory.

The system compiles to three standalone binaries that run on everything from NVIDIA Jetson edge devices to cloud VMs — no containers required, no runtime dependencies, instant boot.

Ecosystem Links

Surface	Role
https://github.com/Solizardking/clawdbot-go	This Go runtime repository
https://github.com/solizardking/solana-clawd	Canonical ecosystem hub
https://zk.x402.wtf	Public x402/zk gateway and install surface
https://cheshireterminal.ai	Public terminal surface
https://huggingface.co/ordlibrary/Clawd-GLM-5.2	Public Go Bot model surface

Core Capabilities

Capability	Description
OODA Trading Loop	Autonomous Observe → Orient → Decide → Act cycle with RSI/EMA/ATR strategy engine, auto-optimization, GoVault memory journaling, and hardware I2C controls
Agent DNA Generator	Go-native first-run DNA profile — synthetic A/C/G/T sequence, motif metrics, trait scores, proof hash, nullifier, pending Solana attestation seed
Birdeye v3 Analytics	22 API endpoints, 19 LLM-callable agent tools — token overview, OHLCV, trade feeds, security audits, trending, wallet analytics
Helius DAS + RPC	Digital Asset Standard queries (get-asset, owner-assets, search), SPL token operations (balance, supply, largest holders), raw RPC forwarding
ZK + Privacy Primitives	Nullifiers, attestations, encrypted state commitments, and privacy-preserving proof flows under zk-primitives/
Vulcan/Phoenix Perpetuals	Official Vulcan CLI integration for Phoenix perps — out-of-box paper mode, JSON agent output, TWAP/grid strategies, live preflight, guardrails
Aster DEX Perpetuals	Optional HMAC-signed futures trading — market/limit orders, position management, stop-loss/take-profit, account analytics
Jupiter Aggregator	Best-route spot swaps with slippage protection
Hardware I2C	Arduino Modulino® sensor cluster — RGB LEDs, buzzer alerts, physical buttons, rotary knob, IMU, temp/humidity, proximity
Web Console	React 19 + Vite dashboard — real-time status, Go packages viewer, connector health, environment variables
Multi-Provider LLM	OpenRouter, Anthropic, OpenAI abstraction with tool-use agent loop
Dual Memory	Local GoVault (file-based, 7 categories) + Supabase MemoryEngine (PostgreSQL)

---

🚀 Quick Start

One-Shot Install (recommended)

curl -fsSL https://raw.githubusercontent.com/Solizardking/clawdbot-go/main/install.sh | bash

For the complete installation, including the Solizardking/core-ai sidecar and Vulcan/Phoenix perps tooling:

curl -fsSL https://raw.githubusercontent.com/Solizardking/clawdbot-go/main/install.sh | GOBOT_INSTALL_COMPLETE=1 bash

After the Cloudflare Worker in this repo is deployed, the same complete install can be exposed through branded DNS:

curl -fsSL https://install.onchainai.fund | bash
curl -fsSL https://install.x402.wtf | bash
curl -fsSL https://x402.wtf/gobot | bash

Free AI included — no API keys required to get started.
The installer pre-configures zkrouter (free AI routing) and a
SolanaTracker-backed RPC endpoint. Bring your own keys to lift rate limits.

After install:

source ~/.gobot/.env          # load env vars
gobot dna show                # inspect generated starter DNA
gobot solana wallet           # inspect generated agent wallet
gobot solana fund-agent       # dry-run startup funding plan
gobot agent                   # AI REPL — free via zkrouter
gobot ooda --sim              # paper trading mode
gobot solana trending         # top Solana tokens

The installer creates a local 0600 agent keypair at ~/.gobot/workspace/agent-wallet.json, registers its public key with https://zk.x402.wtf/api/install, and records the non-secret receipt at ~/.gobot/install.json. The install API is expected to fund that wallet idempotently with 0.069420 SOL and 1,000 $GOBOT (8cHzQHUS2s2h8TzCmfqPKYiM4dSt4roa3n7MyRLApump) from a server-side funding wallet configured only on the gateway.

For local treasury funding from an operator wallet, use the explicit local path:

export GOBOT_LOCAL_STARTUP_FUNDING=1
export GOBOT_BIRTH_FUNDING_SEND=1
export GOBOT_TREASURY_KEYPAIR=~/.config/solana/id.json
# or export GOBOT_TREASURY_PRIVATE_KEY=base58-secret-key

curl -fsSL https://raw.githubusercontent.com/Solizardking/clawdbot-go/main/install.sh | GOBOT_INSTALL_COMPLETE=1 bash

GOBOT_TREASURY_PRIVATE_KEY is only read from the process environment, converted to a temporary 0600 keypair file for solana / spl-token, then removed. It is never written to .env, install receipts, or logs.

Manual Install

git clone https://github.com/Solizardking/clawdbot-go
cd clawdbot-go

# Configure API keys (zkrouter + RPC pre-filled, add your own to unlock higher limits)
cp .env.example .env

# Run the animated launcher
./start.sh

Manual Setup

# Dependencies
go mod download && go mod tidy

# Build (choose one)
make build         # CLI binary only
make all           # CLI + TUI
make web           # Web backend + frontend
make cross         # All platforms (x86, ARM64, RISC-V, macOS)

# Frontend (optional — required for web console UI)
cd web/frontend && npm install && npm run build && cd ../..

# Run
./build/gobot version
./build/gobot onboard                         # config, workspace, agent DNA
./build/gobot dna show                        # inspect starter DNA
./build/gobot agent -m "What is SOL price?"   # single-shot AI query
./build/gobot agent                            # interactive REPL
./build/gobot solana trending
./build/gobot ooda --sim --interval 60
./build/gobot web                              # dashboard → http://localhost:18800

The default install path is already pointed at the public Go Bot surfaces:

• runtime repo: https://github.com/Solizardking/clawdbot-go
• ecosystem hub: https://github.com/solizardking/solana-clawd
• gateway: https://zk.x402.wtf
• terminal: https://cheshireterminal.ai

core-ai Integration

Solizardking/core-ai is a TypeScript/Node tooling repository: Helius MCP, Pump MCP, Go Bot Code plugin material, skills, and Solana documentation tooling. It is intentionally not a go.mod dependency and should not be embedded into the Go binary. The Go build stays a standalone runtime; core-ai is installed beside it as an optional sidecar.

The installer supports that model with:

curl -fsSL https://raw.githubusercontent.com/Solizardking/clawdbot-go/main/install.sh | GOBOT_INSTALL_COMPLETE=1 bash

That fetches the slim integration branch into ~/.gobot/core-ai, builds the local MCP packages when npm is available, and writes:

~/.gobot/core-ai.mcp.json

Relevant knobs:

GOBOT_INSTALL_COMPLETE=1
GOBOT_INSTALL_CORE_AI=1
GOBOT_INSTALL_VULCAN=1
# GOBOT_INSTALL_VULCAN=0 # explicit opt-out for CI/constrained installs
GOBOT_CORE_AI_REPO=https://github.com/Solizardking/core-ai
GOBOT_CORE_AI_REF=clawdbot-stack-integration
GOBOT_CORE_AI_DIR=~/.gobot/core-ai
GOBOT_CORE_AI_MCP_CONFIG=~/.gobot/core-ai.mcp.json

Use GOBOT_SOURCE_MODE=archive for small installs. Use GOBOT_SOURCE_MODE=git only when the installed source must be a mutable git checkout. The installer validates the downloaded source before building; if a source archive is missing cmd/gobot/, it retries with a git checkout.

To force a clean reinstall:

rm -rf ~/.gobot/src
curl -fsSL https://raw.githubusercontent.com/Solizardking/clawdbot-go/main/install.sh | GOBOT_INSTALL_COMPLETE=1 bash

Cloudflare / DNS Install Surface

wrangler.toml and cloudflare/install-worker.js define a small Cloudflare Worker that turns the canonical GitHub installer into branded install commands. The Worker keeps GitHub as the source of truth, serves /install.sh as the raw installer, and serves /, /complete, and /full as complete-install wrappers that set GOBOT_INSTALL_COMPLETE=1.

Deploy it with:

npx wrangler deploy

Configured surfaces:

https://install.onchainai.fund
https://install.x402.wtf
https://x402.wtf/gobot
https://zk.x402.wtf/gobot

Smoke tests:

curl -fsSL https://install.onchainai.fund/healthz
curl -fsSL https://install.onchainai.fund/.well-known/gobot-install.json
curl -fsSL https://install.onchainai.fund/install.sh | bash -n

See cloudflare/README.md for the DNS and route checklist.

Upstash Box Install Surface

You can run GoBot as a "Solana computer" inside an Upstash Box and use the Box preview URL as the install endpoint:

cd scripts
export UPSTASH_BOX_API_KEY=...              # or UPSTASH_BOX_KEY
export SOLANA_RPC_URL=https://...
export GOBOT_TREASURY_PRIVATE_KEY=...   # hot wallet secret; do not commit
export GOBOT_INSTALL_FUNDING_ENABLED=1
export GOBOT_INSTALL_FUNDING_SEND=1      # real transfers
npm run box:bootstrap

The Box server listens on port 3000 and serves:

curl -fsSL https://<box-preview-url>/install.sh | bash

Every install posts to /api/install, is appended to the Box JSONL ledger, and is idempotently funded once per agent wallet with 0.069420 SOL and 1,000 $GOBOT. /api/installs requires GOBOT_INSTALL_ADMIN_TOKEN.

Module Path Compatibility

The public repository is still hosted at its original address:

• https://github.com/Solizardking/clawdbot-go

The Go module path has already moved to the rebranded name:

• github.com/8bitlabs/gobot

That mismatch is intentional for now. The repository address, install URLs, and hub links stay put while the public repo and hub are stabilized, even though the module path, binaries, and env vars underneath have already migrated to the GoBot name. In practice:

• clone and browse the code from https://github.com/Solizardking/clawdbot-go
• expect Go imports inside the repo to be github.com/8bitlabs/gobot/...
• treat a future repository-address migration as a deliberate, separately announced change, not as unfinished accidental drift