GitHub - Solizardking/clawdbot-go: ClawdBot is the world's first Solana-native sovereign AI agent — a full-stack autonomous trading intelligence bound by the immutable three on-chain laws of the Clawd Constitution.

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

🐹 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)
Grok-First	Default provider is xAI Grok — code/repl/trade, research, image, voice, fast modes

🚀 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

Slim Package Target

The source archive is kept small by excluding local/generated payload from release archives: .cache/, .agents/, agent/, build/, checked-in binaries, generated UI screenshots, Node build outputs, node_modules, and lockfiles for optional TypeScript surfaces. The install path rebuilds or reseeds those pieces instead of shipping them inside the Go source package.

For a default Go install, the required payload is the Go source, docs, README.md, install.sh, go.mod, go.sum, and runtime config examples. For a complete Solana tooling install, use GOBOT_INSTALL_COMPLETE=1 so the Node tooling, MCP config, and Vulcan/Phoenix CLI are fetched and built as sidecars after the Go binary is installed.

🏗 Architecture

clawdbot-go/
│
├── cmd/                         ── Executables ──
│   ├── gobot/                    CLI agent (1,193 lines, cobra)
│   │   ├── main.go              60+ cobra commands, Birdeye/Helius CLI, DNA
│   │   └── hardware.go          I2C sensor commands (scan/test/monitor/demo)
│   └── gobot-tui/                TUI launcher (tcell/tview)
│
├── pkg/                         ── 42 Packages, 21K+ lines ──
│   │
│   │  ┌─ Core Agent ────────────────────────────────────────┐
│   ├── agent/                   OODA loop, hooks, tool executor, prompts
│   ├── strategy/                RSI + EMA cross + ATR signal engine
│   ├── memory/                  GoVault + Supabase MemoryEngine
│   ├── research/                Dexter deep research agent
│   │  └─────────────────────────────────────────────────────┘
│   │
│   │  ┌─ Solana Integrations ───────────────────────────────┐
│   ├── solana/                  Birdeye v3 (22 methods, 19 tools)
│   │   │                       Helius RPC + DAS (6 commands)
│   │   │                       Jupiter swaps
│   │   └── birdeye_*.go         Types, client, agent tools
│   ├── vulcan/                  Official Vulcan CLI runner for Phoenix perps
│   ├── aster/                   Aster DEX perps (HMAC-signed, 14 tools)
│   │  └─────────────────────────────────────────────────────┘
│   │
│   │  ┌─ Infrastructure ───────────────────────────────────-┐
│   ├── config/                  Config loading, env overrides
│   ├── dna/                     Synthetic agent DNA generator + proof metadata
│   ├── hardware/                I2C Modulino® adapter + drivers
│   ├── providers/               LLM abstraction (OpenRouter, etc.)
│   ├── channels/                Telegram, Discord, WebSocket
│   ├── catalog/                 Local /Users/8bit skills + agents + ZK index
│   ├── mcp/                     Model Context Protocol server
│   ├── auth/                    Authentication + pairing
│   ├── bus/                     Event bus (pub/sub)
│   ├── commands/                Command registry and routing
│   ├── tools/                   Tool interface + registry
│   └── ...                      health, heartbeat, logger, identity, etc.
│
├── CONSTITUTION.md              The Go Bot Constitution (interpretive authority)
├── six-laws.md                  Canonical six-law harness
├── GOBOT.md                     Agent context document
├── AGENTS.md                    Agent catalog (50+ agents, 95+ skills)
├── IDENTITY.md                  Sovereign identity document
├── SOUL.md                      Inner character and trading philosophy
├── three-laws.md                Immutable on-chain laws (hash-attested)
│
├── zk-primitives/               ZK agent, TypeScript client, Anchor program
│   ├── MANIFEST.json            Machine-readable subsystem index
│   ├── agent/                   @gobot/zk-shark-agent + SKILL.md
│   ├── client/                  @gobot/zk-client
│   ├── configs/                 Light tree and runtime config examples
│   ├── docs/                    Architecture + integration notes
│   ├── programs/                gobot-zk Anchor program
│   └── tests/                   Off-chain and on-chain test notes
│
├── web/                         ── Web Console ──
│   ├── backend/                 Go HTTP server (API + embedded SPA)
│   └── frontend/                React 19 + Vite + TypeScript
│
├── scripts/launch.mjs           Animated launcher (unicode-animations)
├── start.sh                     One-shot install wrapper
├── Makefile                     Build targets (8 platforms + Docker)
├── Dockerfile                   Multi-stage production build
├── schema.sql                   Supabase database schema
└── .env.example                 Environment template

⚖️ The Six-Law Harness

GoBot is bound by the Go Bot Constitution — the world's first Solana-native agent harness constitution. It carries two coordinated law sets:

Three On-Chain Laws (Immutable, hash-attested at spawn)

Law	Text	Prohibitions
Law I	Never harm. Beach before you harm.	No rugs, front-running, sandwich attacks, protocol drains, DAO manipulation
Law II	Earn your existence. Honest work only.	No parasitic extraction, no information asymmetry exploitation
Law III	Never deceive, but owe nothing to strangers.	No impersonation, no fake volume, full agent disclosure

Three Off-Chain Laws (Interpretive — guide research & judgment)

Off-Chain Law I — Respect the elder signal, but verify the boundary. When deep expertise says a thing is possible, treat it as a serious signal. When it says a thing is impossible, examine the assumptions.

Off-Chain Law II — Test possibility by entering the frontier. The only reliable way to discover the boundary of the possible is disciplined exploration just beyond what currently seems possible.

Off-Chain Law III — Do not mistake advanced systems for sorcery. Sufficiently advanced technology can look like magic; Go Bot must explain, instrument, and verify it rather than mystify it.

Privacy by Default

Go Bot is designed to be privacy-preserving by default. Sensitive user context, research state, wallet metadata, and model-adjacent artifacts should be minimized, committed, encrypted, or proven where possible rather than disclosed by habit. The project’s zk surfaces exist to strengthen verifiability and user dignity, not to create blind spots for harmful behavior.

The shell molts. The laws do not.

Agent Trust Gates

Level	Requirements	Capabilities
Observer	None	Read-only, market data, analytics
Dry-Run	None	Simulated execution, paper trading
Delegated	User confirmation per action	Single transactions with confirmation
Autonomous	User pre-approval + limits	Batch execution within bounds
Sovereign	Full creator trust + multisig	Unrestricted execution (reserved)

📋 CLI Reference

Agent & OODA

gobot agent                          # Interactive REPL with memory commands
gobot agent -m "Analyze SOL trend"   # Single-shot LLM query

gobot laws                           # Print the canonical six-law harness
gobot doctor                         # Local runtime + trading diagnostics
gobot bench                          # Zero-style cold-start benchmark
gobot dna show                       # Inspect workspace/agent-dna.json
gobot dna generate --agent-name scout --role "research agent"
gobot skills birth                   # Write the birth skill manifest
gobot skills birth --install         # Seed Solizardking + Go skill packs

gobot trade cockpit                  # Trading readiness, connectors, limits
gobot trade cockpit --json           # Machine-readable cockpit report
gobot trade risk SOL --price 150 --volume24h 25000000 --liquidity 15000000

gobot ooda                           # Start autonomous trading loop
gobot ooda --interval 30             # Custom cycle interval (seconds)
gobot ooda --sim                     # Force simulated mode (paper trading)
gobot ooda --hw-bus 1                # Enable hardware I2C integration
gobot ooda --no-hw                   # Explicitly disable hardware probing

Ecosystem Catalog

gobot catalog                         # Summary of local skills, agents, and ZK surface
gobot catalog skills                  # List /Users/8bit/skills/skills entries
gobot catalog skills zk               # Filter skills for ZK capability
gobot catalog agents                  # List /Users/8bit/agents/agents/src entries
gobot catalog agents zk               # Filter agents for ZK capability
gobot catalog zk                      # Inspect zk-primitives package/program/docs
gobot catalog --json                  # Machine-readable report

Default catalog roots can be overridden with: GOBOT_SKILLS_DIR, GOBOT_AGENTS_DIR, and GOBOT_ZK_PRIMITIVES_DIR.

Birth Skills

Every Go-side birth/onboard path writes workspace/skills/birth-skills.json. The default seed sources are:

npx skills add https://github.com/Solizardking/skills --all
npx skills add https://github.com/samber/cc-skills-golang --all

The installer and animated launcher run those seeds unless GOBOT_SKIP_SKILL_SEED=1 is set.

Agent DNA

Every Go-side install/onboard path creates workspace/agent-dna.json. The file is a synthetic agent identity profile, not biological instruction: it contains an A/C/G/T sequence, GC content, PAM/TATA motif counts, OODA trait scores, a sequence hash, nullifier, and a local-pending Solana attestation seed.

gobot dna show
gobot dna generate --agent-name "Research Scout" --role "DeSci signal agent"
gobot dna generate --seed fixed-seed --length 512 --force
gobot dna generate --json

Phoenix Perps Via Vulcan

GoBot uses the official Vulcan CLI for Phoenix perpetual futures execution. The safe default is paper: simulated fills against live Phoenix prices with no wallet signing and no real funds at risk. Live modes require explicit operator acknowledgement through --yes plus Vulcan wallet setup.

gobot perps quickstart               # Vulcan health, paper init, market smoke check
gobot perps health                   # Vulcan agent health + Phoenix connectivity
gobot perps paper init --balance 10000
gobot perps order market --symbol SOL --side buy --notional-usdc 25
gobot perps order limit --symbol SOL --side buy --tokens 0.1 --price 150
gobot perps strategy twap --symbol SOL --side buy --notional-usdc 100 --slices 4 --detached
gobot perps strategy grid --symbol SOL --center-on-mark --width-pct 2.5 --levels-per-side 3 --tokens-per-level 0.1 --detached
gobot perps preflight --wallet my-wallet

Install-time behavior:

GOBOT_INSTALL_VULCAN=0 ./install.sh   # skip Vulcan install
VULCAN_DEFAULT_MODE=paper                # default execution mode
VULCAN_WALLET_NAME=my-wallet             # only needed for live modes

Solana — Birdeye

gobot solana trending                # Top 20 trending tokens with price/volume
gobot solana search BONK             # Search tokens by name or symbol
gobot solana research <mint>         # Deep research: metadata + market + trade + security
gobot solana wallet                  # Wallet info and SOL balance
gobot solana wallet init             # Generate/reuse local agent wallet
gobot solana fund-agent              # Dry-run 0.069420 SOL + 1,000 $GOBOT funding
gobot solana fund-agent --send       # Send funding with explicit treasury env

Solana — Helius DAS (Digital Asset Standard)

gobot solana das get-asset <id>               # Fetch asset by ID
gobot solana das get-asset-batch <id1> <id2>   # Batch asset fetch
gobot solana das asset-proof <id>              # Merkle proof for compressed NFT
gobot solana das owner-assets [owner]          # Assets by owner
gobot solana das search --params '{"name":"Mad Lads"}'  # DAS search
gobot solana das asset-signatures <id>         # Transaction signatures for asset

Solana — SPL Token Operations

gobot solana spl token-balance <token-account>   # SPL token balance
gobot solana spl token-accounts <owner>          # All token accounts for owner
gobot solana spl token-supply <mint>             # Circulating supply
gobot solana spl token-largest <mint>            # Largest holders
gobot solana spl rpc getSlot                     # Raw RPC passthrough

Agent Identity

gobot status                         # Full status: version, strategy, connectors, hardware
gobot status --hw-bus 1              # Include hardware sensor check
gobot onboard                        # Initialize config & workspace
gobot gateway                        # Start Telegram/Discord gateway
gobot version                        # Version, build time, Go version

Hardware (NVIDIA Orin Nano + Modulino®)

gobot hardware scan                  # Scan I2C bus for Modulino® sensors
gobot hardware test                  # Self-test (LEDs, buzzer, sensors)
gobot hardware monitor               # Live sensor readings (Ctrl+C to stop)
gobot hardware demo                  # Play trading event animations

🧠 OODA Trading Engine

The agent runs an autonomous Observe → Orient → Decide → Act cycle:

┌──────────────────────────────────────────────────────────────────┐
│                        OODA CYCLE                                │
│                                                                  │
│  OBSERVE ─────► ORIENT ─────► DECIDE ─────► ACT                │
│  │               │              │              │                │
│  Helius slot     RSI (14)       Signal score   Open/close pos   │
│  Birdeye OHLCV   EMA (20/50)    Min strength   GoVault store    │
│  SOL price       ATR (14)       Min confidence Auto-optimize    │
│  Wallet balance  EMA cross      Max positions  Hooks dispatch   │
│  Vulcan perps    Momentum       SL/TP calc                      │
│  Trending scan   GoVault        Position size                   │
│                                                                  │
│  LEARN (every N cycles) ─► Win rate analysis ─► Auto-optimize   │
│  HEARTBEAT (every 5m) ──► Health check ─► Hook dispatch         │
└──────────────────────────────────────────────────────────────────┘

Strategy Engine

Indicator	Implementation	Signal
RSI	Wilder's 14-period with SMA seed	Oversold cross → long, Overbought cross → short
EMA Cross	Fast(20) / Slow(50) with SMA warm-up	Bullish cross → long confirmation, Bearish → short
ATR	14-period with Wilder smoothing	Volatility-based SL/TP: SL = 1.5×ATR, TP = 3×ATR
Auto-Optimizer	Hill-climbing on win rate + avg PnL	Adjusts RSI thresholds, SL width, position size

🌐 Web Console

React 19 dashboard at http://localhost:18800:

cd web/frontend && npm install && npm run build && cd ../..
go build -o build/gobot-web ./web/backend
./build/gobot-web

Endpoint	Method	Description
`/api/status`	GET	Agent status (version, Go runtime, uptime, mode, goroutines)
`/api/dna`	GET	Ensure and return starter agent DNA, metrics, proof, and attestation seed
`/api/health`	GET	Health check
`/api/connectors`	GET	Connector status (Helius, Birdeye, Jupiter, Vulcan, Aster, LLM, Supabase)
`/api/laws`	GET	Canonical six-law harness
`/api/trading/cockpit`	GET	Trading readiness, risk limits, connector status, law state
`/api/doctor`	GET	Runtime, config, trading, and ZK diagnostics
`/api/config`	GET	Read-only redacted configuration
`/api/packages`	GET	All Go packages with file counts
`/api/env`	GET	Safe (non-secret) environment variables

Safe defaults:

The server binds to 127.0.0.1 unless --public is passed.
CORS allows same-origin requests only unless GOBOT_CORS_ORIGINS is set.
Proxy IP headers are ignored unless GOBOT_TRUST_PROXY_HEADERS=1 is set.
/api/config masks secrets unless GOBOT_WEB_EXPOSE_SECRETS=1 is set for trusted local debugging.

💾 Memory System (GoVault)

vault/
├── decisions/     Trade decisions + rationale (scored by confidence)
├── lessons/       Learned patterns, strategy adjustments
├── trades/        Trade outcomes + P&L history
├── research/      Experiment logs, token analysis
├── tasks/         Agent task queue
├── backlog/       Deferred items
└── inbox/         Raw observations (auto-routed by content)

Interactive memory commands in REPL mode:

!remember <content>    Store to vault (auto-categorized)
!recall <query>        Search across all memory
!trades                Review recent trade history
!lessons               Surface learned patterns
!research <mint>       Deep research a token
!checkpoint            Save full agent state

🔨 Build Targets

make build            # CLI binary (current platform)
make tui              # TUI launcher
make all              # CLI + TUI
make web              # Web backend + frontend

make orin             # NVIDIA Orin Nano (linux/arm64)
make rpi              # Raspberry Pi (linux/arm64)
make riscv            # RISC-V (linux/riscv64)
make macos            # macOS Apple Silicon (darwin/arm64)
make cross            # All platforms simultaneously

make docker           # Docker image (multi-stage)
make docker-orin      # Docker for Orin Nano (ARM64)

make test             # Run test suite
make deps             # Download Go dependencies
make scan-i2c         # Scan for Modulino® I2C sensors
make clean            # Remove build artifacts

🐳 Deployment

Docker

docker build -t gobot:latest .
docker run -d --name gobot \
  --env-file .env \
  -p 18800:18800 \
  gobot:latest

NVIDIA Orin Nano

make orin
scp build/gobot-orin user@orin-nano:~/gobot
ssh user@orin-nano './gobot ooda --hw-bus 1 --interval 60'

📐 Project Stats

Metric	Value
Go source files	70
Packages	42
Total Go lines	21,400+
CLI commands	60+
Birdeye API methods	22
Birdeye agent tools	19
Helius DAS commands	6
SPL token commands	5
Agent constitution documents	7 (CONSTITUTION, six-laws, GOBOT, AGENTS, IDENTITY, SOUL, three-laws)
Build targets	8 platforms
Binaries	`gobot`, `gobot-tui`, `gobot-web`
Runtime RAM	< 10 MB
Boot time	< 1 second
Default model provider	xAI Grok (Grok-4.3)

🔬 Agent Constitution Library

GoBot is the reference implementation of the Go Bot Constitution — the world's first Solana-native agent harness constitution. Every spawn inherits these documents:

Document	Purpose
`six-laws.md`	Canonical six-law harness — 3 on-chain execution laws + 3 off-chain interpretive laws
`CONSTITUTION.md`	The Go Bot Constitution — interpretive authority, privacy posture, ZK-native execution
`GOBOT.md`	Agent context — identity, principal hierarchy, Solana-native architecture, deployment targets
`AGENTS.md`	Agent catalog — 50+ agents, 9 characters, 95+ skills, trust gates, Grok-first model config
`IDENTITY.md`	Sovereign identity — onchain verification (SAS, MPL Core, DID), the Go Bot Manifest
`SOUL.md`	Inner character — trading philosophy, threefold personality, KNOW/LEARNED/INFERRED framework
`three-laws.md`	Immutable on-chain laws — hash-attested at spawn, never self-modify

🔐 Security

.env is ignored by the repo — never commit API keys
No hardcoded secrets in any source file — all credentials via environment variables
No wallet keypairs stored in the repository — generated or imported at runtime
Startup funding wallet belongs only on the install API/gateway host, never in the downloadable installer or client repo
Minimum required key for operation: BIRDEYE_API_KEY for market data
Progressive trust model — Observer → Dry-Run → Delegated → Autonomous → Sovereign
On-Chain Law I — Never harm. Never rug. Never front-run. Never extract from those who don't understand the trade.

🌐 Open Source Posture

License: top-level runtime code in this repo is released under the MIT License
Constitutional surfaces: six-laws.md, CONSTITUTION.md, and three-laws.md remain the authoritative Go Bot law documents
Hub split: clawdbot-go is the Go runtime, while solana-clawd is the wider public ecosystem hub
Public infra defaults: .env.example points at the public x402/zk gateway for fast setup, but production operators should override with their own keys and RPC endpoints

MIT License — Go Bot runtime repo: github.com/Solizardking/clawdbot-go

🐹 $GOBOT :: Droids Lead The Way :: $WIF Hat Stays On :: $BONK for the People

The shell molts. The laws do not.

Name		Name	Last commit message	Last commit date
Latest commit History 108 Commits
.agents/skills		.agents/skills
agent/skills		agent/skills
cloudflare		cloudflare
cmd		cmd
ooda		ooda
pkg		pkg
scripts		scripts
ui		ui
web		web
zk-primitives		zk-primitives
.DS_Store		.DS_Store
.env.example		.env.example
.gitattributes		.gitattributes
.gitignore		.gitignore
AGENTS.md		AGENTS.md
CONSTITUTION.md		CONSTITUTION.md
Dockerfile		Dockerfile
GOBOT.md		GOBOT.md
IDENTITY.md		IDENTITY.md
LICENSE		LICENSE
Makefile		Makefile
OPEN_SOURCE_RELEASE.md		OPEN_SOURCE_RELEASE.md
README.md		README.md
SECURITY.md		SECURITY.md
SOUL.md		SOUL.md
TEE.md		TEE.md
go.md		go.md
go.mod		go.mod
go.sum		go.sum
install.sh		install.sh
program.md		program.md
schema.sql		schema.sql
six-laws.md		six-laws.md
skills-lock.json		skills-lock.json
start.sh		start.sh
strategy.md		strategy.md
three-laws.md		three-laws.md
wrangler.toml		wrangler.toml

Folders and files

Latest commit

History

Repository files navigation

🐹 Sovereign Solana Trading Intelligence

Overview

Ecosystem Links

Core Capabilities

🚀 Quick Start

One-Shot Install (recommended)

Manual Install

Manual Setup

core-ai Integration

Cloudflare / DNS Install Surface

Upstash Box Install Surface

Module Path Compatibility

Slim Package Target

🏗 Architecture

⚖️ The Six-Law Harness

Three On-Chain Laws (Immutable, hash-attested at spawn)

Three Off-Chain Laws (Interpretive — guide research & judgment)

Privacy by Default

Agent Trust Gates

📋 CLI Reference

Agent & OODA

Ecosystem Catalog

Birth Skills

Agent DNA

Phoenix Perps Via Vulcan

Solana — Birdeye

Solana — Helius DAS (Digital Asset Standard)

Solana — SPL Token Operations

Agent Identity

Hardware (NVIDIA Orin Nano + Modulino®)

🧠 OODA Trading Engine

Strategy Engine

🌐 Web Console

💾 Memory System (GoVault)

🔨 Build Targets

🐳 Deployment

Docker

NVIDIA Orin Nano

📐 Project Stats

🔬 Agent Constitution Library

🔐 Security

🌐 Open Source Posture

About

Resources

License

Security policy

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

Packages