Quick Start

Get GoClaw running with a single Telegram bot in under 5 minutes.

1. 1
   Build the binary

   Requires Go 1.22 or later.

   bash

   git clone https://github.com/yourname/goclaw cd goclaw make build # → bin/goclaw (~12MB)
2. 2
   Run the onboarding wizard

   The wizard guides you through LLM provider, API keys, and channel setup.

   bash

   ./bin/goclaw onboard # The wizard asks: # → LLM provider (anthropic / openai / google / ollama) # → API key # → Model name # → Channels to enable # → Agent name and persona
3. 3
   Start the agent

   Launch GoClaw. The Control UI is at http://localhost:18789.

   bash

   ./bin/goclaw start # 🦞 GoClaw v0.3.1 starting... # 🌐 Gateway :18789 ready # 🤖 Telegram connected # 🔧 Skills run_shell, read_file, write_file, fetch_url, remember # ✅ Agent ready. Say hello!
4. 4
   Verify with goclaw doctor

   Run the health check to confirm everything is configured correctly.

   bash

   goclaw doctor # ✅ Config file ~/.goclaw/config.yaml # ✅ LLM provider anthropic (claude-opus-4-6) # ✅ Memory dir ~/.goclaw/memory/ # ✅ Telegram bot @YourBotName (connected) # ✅ Gateway :18789 (listening)