Skip to content

tamld/goclaw

ย 
ย 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

607 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

GoClaw

GoClaw

Enterprise AI Agent Platform

Multi-agent AI gateway built in Go. 20+ LLM providers. 7 channels. Multi-tenant PostgreSQL.
Single binary. Production-tested. Agents that orchestrate for you.

Documentation โ€ข Quick Start โ€ข Twitter / X

Go PostgreSQL Docker WebSocket OpenTelemetry Anthropic OpenAI License: MIT

A Go port of OpenClaw with enhanced security, multi-tenant PostgreSQL, and production-grade observability.

๐ŸŒ Languages: ๐Ÿ‡จ๐Ÿ‡ณ ็ฎ€ไฝ“ไธญๆ–‡ ยท ๐Ÿ‡ฏ๐Ÿ‡ต ๆ—ฅๆœฌ่ชž ยท ๐Ÿ‡ฐ๐Ÿ‡ท ํ•œ๊ตญ์–ด ยท ๐Ÿ‡ป๐Ÿ‡ณ Tiแบฟng Viแป‡t ยท ๐Ÿ‡ต๐Ÿ‡ญ Tagalog ยท ๐Ÿ‡ช๐Ÿ‡ธ Espaรฑol ยท ๐Ÿ‡ง๐Ÿ‡ท Portuguรชs ยท ๐Ÿ‡ฎ๐Ÿ‡น Italiano ยท ๐Ÿ‡ฉ๐Ÿ‡ช Deutsch ยท ๐Ÿ‡ซ๐Ÿ‡ท Franรงais ยท ๐Ÿ‡ธ๐Ÿ‡ฆ ุงู„ุนุฑุจูŠุฉ ยท ๐Ÿ‡ฎ๐Ÿ‡ณ เคนเคฟเคจเฅเคฆเฅ€ ยท ๐Ÿ‡ท๐Ÿ‡บ ะ ัƒััะบะธะน ยท ๐Ÿ‡ง๐Ÿ‡ฉ เฆฌเฆพเฆ‚เฆฒเฆพ ยท ๐Ÿ‡ฎ๐Ÿ‡ฑ ืขื‘ืจื™ืช ยท ๐Ÿ‡ต๐Ÿ‡ฑ Polski ยท ๐Ÿ‡จ๐Ÿ‡ฟ ฤŒeลกtina ยท ๐Ÿ‡ณ๐Ÿ‡ฑ Nederlands ยท ๐Ÿ‡น๐Ÿ‡ท Tรผrkรงe ยท ๐Ÿ‡บ๐Ÿ‡ฆ ะฃะบั€ะฐั—ะฝััŒะบะฐ ยท ๐Ÿ‡ฎ๐Ÿ‡ฉ Bahasa Indonesia ยท ๐Ÿ‡น๐Ÿ‡ญ เน„เธ—เธข ยท ๐Ÿ‡ต๐Ÿ‡ฐ ุงุฑุฏูˆ ยท ๐Ÿ‡ท๐Ÿ‡ด Romรขnฤƒ ยท ๐Ÿ‡ธ๐Ÿ‡ช Svenska ยท ๐Ÿ‡ฌ๐Ÿ‡ท ฮ•ฮปฮปฮทฮฝฮนฮบฮฌ ยท ๐Ÿ‡ญ๐Ÿ‡บ Magyar ยท ๐Ÿ‡ซ๐Ÿ‡ฎ Suomi ยท ๐Ÿ‡ฉ๐Ÿ‡ฐ Dansk ยท ๐Ÿ‡ณ๐Ÿ‡ด Norsk

What Makes It Different

  • Agent Teams & Orchestration โ€” Teams with shared task boards, inter-agent delegation (sync/async), and hybrid agent discovery
  • Multi-Tenant PostgreSQL โ€” Per-user workspaces, per-user context files, encrypted API keys (AES-256-GCM), isolated sessions
  • Single Binary โ€” ~25 MB static Go binary, no Node.js runtime, <1s startup, runs on a $5 VPS
  • Production Security โ€” 5-layer permission system (gateway auth โ†’ global tool policy โ†’ per-agent โ†’ per-channel โ†’ owner-only) plus rate limiting, prompt injection detection, SSRF protection, shell deny patterns, and AES-256-GCM encryption
  • 20+ LLM Providers โ€” Anthropic (native HTTP+SSE with prompt caching), OpenAI, OpenRouter, Groq, DeepSeek, Gemini, Mistral, xAI, MiniMax, Cohere, Perplexity, DashScope, Bailian, Zai, Ollama, Ollama Cloud, Claude CLI, Codex, ACP, and any OpenAI-compatible endpoint
  • 7 Messaging Channels โ€” Telegram, Discord, Slack, Zalo OA, Zalo Personal, Feishu/Lark, WhatsApp
  • Extended Thinking โ€” Per-provider thinking mode (Anthropic budget tokens, OpenAI reasoning effort, DashScope thinking budget) with streaming support
  • Heartbeat System โ€” Periodic agent check-ins via HEARTBEAT.md checklists with suppress-on-OK, active hours, retry logic, and channel delivery
  • Scheduling & Cron โ€” at, every, and cron expressions for automated agent tasks with lane-based concurrency
  • Observability โ€” Built-in LLM call tracing with spans and prompt cache metrics, optional OpenTelemetry OTLP export

Claw Ecosystem

OpenClaw ZeroClaw PicoClaw GoClaw
Language TypeScript Rust Go Go
Binary size 28 MB + Node.js 3.4 MB ~8 MB ~25 MB (base) / ~36 MB (+ OTel)
Docker image โ€” โ€” โ€” ~50 MB (Alpine)
RAM (idle) > 1 GB < 5 MB < 10 MB ~35 MB
Startup > 5 s < 10 ms < 1 s < 1 s
Target hardware $599+ Mac Mini $10 edge $10 edge $5 VPS+
Feature OpenClaw ZeroClaw PicoClaw GoClaw
Multi-tenant (PostgreSQL) โ€” โ€” โ€” โœ…
MCP integration โ€” (uses ACP) โ€” โ€” โœ… (stdio/SSE/streamable-http)
Agent teams โ€” โ€” โ€” โœ… Task board + mailbox
Security hardening โœ… (SSRF, path traversal, injection) โœ… (sandbox, rate limit, injection, pairing) Basic (workspace restrict, exec deny) โœ… 5-layer defense
OTel observability โœ… (opt-in extension) โœ… (Prometheus + OTLP) โ€” โœ… OTLP (opt-in build tag)
Prompt caching โ€” โ€” โ€” โœ… Anthropic + OpenAI-compat
Knowledge graph โ€” โ€” โ€” โœ… LLM extraction + traversal
Skill system โœ… Embeddings/semantic โœ… SKILL.md + TOML โœ… Basic โœ… BM25 + pgvector hybrid
Lane-based scheduler โœ… Bounded concurrency โ€” โœ… (main/subagent/team/cron)
Messaging channels 37+ 15+ 10+ 7+
Companion apps macOS, iOS, Android Python SDK โ€” Web dashboard
Live Canvas / Voice โœ… (A2UI + TTS/STT) โ€” Voice transcription TTS (4 providers)
LLM providers 10+ 8 native + 29 compat 13+ 20+
Per-user workspaces โœ… (file-based) โ€” โ€” โœ… (PostgreSQL)
Encrypted secrets โ€” (env vars only) โœ… ChaCha20-Poly1305 โ€” (plaintext JSON) โœ… AES-256-GCM in DB

Architecture

GoClaw Architecture

Quick Start

Prerequisites: Go 1.26+, PostgreSQL 18 with pgvector, Docker (optional)

From Source

git clone https://github.com/nextlevelbuilder/goclaw.git && cd goclaw
make build
./goclaw onboard        # Interactive setup wizard
source .env.local && ./goclaw

With Docker

# Generate .env with auto-generated secrets
chmod +x prepare-env.sh && ./prepare-env.sh

# Add at least one GOCLAW_*_API_KEY to .env, then:
docker compose -f docker-compose.yml -f docker-compose.postgres.yml \
  -f docker-compose.selfservice.yml up -d

# Web Dashboard at http://localhost:3000
# Health check: curl http://localhost:18790/health

When GOCLAW_*_API_KEY environment variables are set, the gateway auto-onboards without interactive prompts โ€” detects provider, runs migrations, and seeds default data.

For build variants (OTel, Tailscale, Redis), Docker image tags, and compose overlays, see the Deployment Guide.

Multi-Agent Orchestration

GoClaw supports agent teams and inter-agent delegation โ€” each agent runs with its own identity, tools, LLM provider, and context files.

Agent Delegation

Agent Delegation

Mode How it works Best for
Sync Agent A asks Agent B and waits for the answer Quick lookups, fact checks
Async Agent A asks Agent B and moves on. B announces later Long tasks, reports, deep analysis

Agents communicate through explicit permission links with direction control (outbound, inbound, bidirectional) and concurrency limits at both per-link and per-agent levels.

Agent Teams

Agent Teams Workflow

  • Shared task board โ€” Create, claim, complete, search tasks with blocked_by dependencies
  • Team mailbox โ€” Direct peer-to-peer messaging and broadcasts
  • Tools: team_tasks for task management, team_message for mailbox

For delegation details, permission links, and concurrency control, see the Agent Teams docs.

Built-in Tools

Tool Group Description
read_file fs Read file contents (with virtual FS routing)
write_file fs Write/create files
edit_file fs Apply targeted edits to existing files
list_files fs List directory contents
search fs Search file contents by pattern
glob fs Find files by glob pattern
exec runtime Execute shell commands (with approval workflow)
web_search web Search the web (Brave, DuckDuckGo)
web_fetch web Fetch and parse web content
memory_search memory Search long-term memory (FTS + vector)
memory_get memory Retrieve memory entries
skill_search โ€” Search skills (BM25 + embedding hybrid)
knowledge_graph_search memory Search entities and traverse knowledge graph relationships
create_image media Image generation (DashScope, MiniMax)
create_audio media Audio generation (OpenAI, ElevenLabs, MiniMax, Suno)
create_video media Video generation (MiniMax, Veo)
read_document media Document reading (Gemini File API, provider chain)
read_image media Image analysis
read_audio media Audio transcription and analysis
read_video media Video analysis
message messaging Send messages to channels
tts โ€” Text-to-Speech synthesis
spawn โ€” Spawn a subagent
subagents sessions Control running subagents
team_tasks teams Shared task board (list, create, claim, complete, search)
team_message teams Team mailbox (send, broadcast, read)
sessions_list sessions List active sessions
sessions_history sessions View session history
sessions_send sessions Send message to a session
sessions_spawn sessions Spawn a new session
session_status sessions Check session status
cron automation Schedule and manage cron jobs
gateway automation Gateway administration
browser ui Browser automation (navigate, click, type, screenshot)
announce_queue automation Async result announcement (for async delegations)

Documentation

Full documentation at docs.goclaw.sh โ€” or browse the source in goclaw-docs/

Section Topics
Getting Started Installation, Quick Start, Configuration, Web Dashboard Tour
Core Concepts Agent Loop, Sessions, Tools, Memory, Multi-Tenancy
Agents Creating Agents, Context Files, Personality, Sharing & Access
Providers Anthropic, OpenAI, OpenRouter, Gemini, DeepSeek, +15 more
Channels Telegram, Discord, Slack, Feishu, Zalo, WhatsApp, WebSocket
Agent Teams Teams, Task Board, Messaging, Delegation & Handoff
Advanced Custom Tools, MCP, Skills, Cron, Sandbox, Hooks, RBAC
Deployment Docker Compose, Database, Security, Observability, Tailscale
Reference CLI Commands, REST API, WebSocket Protocol, Environment Variables

Testing

go test ./...                                    # Unit tests
go test -v ./tests/integration/ -timeout 120s    # Integration tests (requires running gateway)

Project Status

See CHANGELOG.md for detailed feature status including what's been tested in production and what's still in progress.

Acknowledgments

GoClaw is built upon the original OpenClaw project. We are grateful for the architecture and vision that inspired this Go port.

License

MIT

About

Multi-agent AI gateway with teams, delegation & orchestration. Single Go binary, 11+ LLM providers, 5 channels.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Go 64.9%
  • TypeScript 28.8%
  • Python 4.4%
  • HTML 0.9%
  • PLpgSQL 0.4%
  • Shell 0.3%
  • Other 0.3%