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.
Dokumentasyon •
Mabilis na Simula •
Twitter / X
Ang **GoClaw** ay isang multi-agent AI gateway na nagkokonekta ng mga LLM sa iyong mga kasangkapan, channel, at datos — na inilunsad bilang isang Go binary na walang runtime dependencies. Inooorkestra nito ang mga agent team at inter-agent delegation sa 20+ LLM provider na may ganap na multi-tenant isolation.
Isang Go port ng [OpenClaw](https://github.com/openclaw/openclaw) na may pinahusay na seguridad, multi-tenant PostgreSQL, at production-grade observability.
🌐 **Mga Wika:**
[🇺🇸 English](../README.md) ·
[🇨🇳 简体中文](README.zh-CN.md) ·
[🇯🇵 日本語](README.ja.md) ·
[🇰🇷 한국어](README.ko.md) ·
[🇻🇳 Tiếng Việt](README.vi.md) ·
[🇵🇭 Tagalog](README.tl.md) ·
[🇪🇸 Español](README.es.md) ·
[🇧🇷 Português](README.pt.md) ·
[🇮🇹 Italiano](README.it.md) ·
[🇩🇪 Deutsch](README.de.md) ·
[🇫🇷 Français](README.fr.md) ·
[🇸🇦 العربية](README.ar.md) ·
[🇮🇳 हिन्दी](README.hi.md) ·
[🇷🇺 Русский](README.ru.md) ·
[🇧🇩 বাংলা](README.bn.md) ·
[🇮🇱 עברית](README.he.md) ·
[🇵🇱 Polski](README.pl.md) ·
[🇨🇿 Čeština](README.cs.md) ·
[🇳🇱 Nederlands](README.nl.md) ·
[🇹🇷 Türkçe](README.tr.md) ·
[🇺🇦 Українська](README.uk.md) ·
[🇮🇩 Bahasa Indonesia](README.id.md) ·
[🇹🇭 ไทย](README.th.md) ·
[🇵🇰 اردو](README.ur.md) ·
[🇷🇴 Română](README.ro.md) ·
[🇸🇪 Svenska](README.sv.md) ·
[🇬🇷 Ελληνικά](README.el.md) ·
[🇭🇺 Magyar](README.hu.md) ·
[🇫🇮 Suomi](README.fi.md) ·
[🇩🇰 Dansk](README.da.md) ·
[🇳🇴 Norsk](README.nb.md)
## Ano ang Nagpapaiba Rito
- **Mga Agent Team at Orkestrasyon** — Mga team na may pinagsamang task board, inter-agent delegation (sync/async), at hybrid agent discovery
- **Multi-Tenant PostgreSQL** — Bawat user ay may sariling workspace, context file, naka-encrypt na API key (AES-256-GCM), at nakahiwalay na session
- **Iisang Binary** — ~25 MB static Go binary, walang Node.js runtime, <1s na pagsisimula, tumatakbo sa $5 VPS
- **Seguridad sa Produksyon** — 5-layer na sistema ng pahintulot (gateway auth → global tool policy → per-agent → per-channel → owner-only) kasama ang rate limiting, pagtuklas ng prompt injection, proteksyon sa SSRF, shell deny patterns, at AES-256-GCM encryption
- **20+ LLM Provider** — Anthropic (native HTTP+SSE na may prompt caching), OpenAI, OpenRouter, Groq, DeepSeek, Gemini, Mistral, xAI, MiniMax, Cohere, Perplexity, DashScope, Bailian, Zai, Ollama, Ollama Cloud, Claude CLI, Codex, ACP, at anumang OpenAI-compatible na endpoint
- **7 Messaging Channel** — Telegram, Discord, Slack, Zalo OA, Zalo Personal, Feishu/Lark, WhatsApp
- **Extended Thinking** — Bawat provider ay may thinking mode (Anthropic budget tokens, OpenAI reasoning effort, DashScope thinking budget) na may suporta sa streaming
- **Heartbeat** — Pana-panahong pag-check-in ng agent sa pamamagitan ng HEARTBEAT.md checklist na may suppress-on-OK, aktibong oras, retry logic, at paghahatid sa channel
- **Pag-iskedyul at Cron** — `at`, `every`, at cron expressions para sa mga automated na gawain ng agent na may lane-based na concurrency
- **Observability** — Built-in na LLM call tracing na may mga span at prompt cache metrics, opsyonal na OpenTelemetry OTLP export
## Claw Ecosystem
| | OpenClaw | ZeroClaw | PicoClaw | **GoClaw** |
| --------------- | --------------- | -------- | -------- | --------------------------------------- |
| Wika | TypeScript | Rust | Go | **Go** |
| Laki ng binary | 28 MB + Node.js | 3.4 MB | ~8 MB | **~25 MB** (base) / **~36 MB** (+ OTel) |
| Docker image | — | — | — | **~50 MB** (Alpine) |
| RAM (walang gawa) | > 1 GB | < 5 MB | < 10 MB | **~35 MB** |
| Pagsisimula | > 5 s | < 10 ms | < 1 s | **< 1 s** |
| Target hardware | $599+ Mac Mini | $10 edge | $10 edge | **$5 VPS+** |
| Tampok | OpenClaw | ZeroClaw | PicoClaw | **GoClaw** |
| -------------------------- | ------------------------------------ | -------------------------------------------- | ------------------------------------- | ------------------------------ |
| Multi-tenant (PostgreSQL) | — | — | — | ✅ |
| MCP integration | — (gumagamit ng ACP) | — | — | ✅ (stdio/SSE/streamable-http) |
| Mga agent team | — | — | — | ✅ Task board + mailbox |
| Pagpapatibay ng seguridad | ✅ (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 |
| Sistema ng skill | ✅ Embeddings/semantic | ✅ SKILL.md + TOML | ✅ Basic | ✅ BM25 + pgvector hybrid |
| Lane-based scheduler | ✅ | Bounded concurrency | — | ✅ (main/subagent/team/cron) |
| Mga messaging channel | 37+ | 15+ | 10+ | 7+ |
| Mga kasama na app | macOS, iOS, Android | Python SDK | — | Web dashboard |
| Live Canvas / Boses | ✅ (A2UI + TTS/STT) | — | Voice transcription | TTS (4 provider) |
| Mga LLM provider | 10+ | 8 native + 29 compat | 13+ | **20+** |
| Bawat user ay may workspace | ✅ (file-based) | — | — | ✅ (PostgreSQL) |
| Naka-encrypt na lihim | — (env vars lamang) | ✅ ChaCha20-Poly1305 | — (plaintext JSON) | ✅ AES-256-GCM sa DB |
## Arkitektura
## Mabilis na Simula
**Mga Kinakailangan:** Go 1.26+, PostgreSQL 18 na may pgvector, Docker (opsyonal)
### Mula sa Source
```bash
git clone https://github.com/nextlevelbuilder/goclaw.git && cd goclaw
make build
./goclaw onboard # Interactive setup wizard
source .env.local && ./goclaw
```
### Gamit ang Docker
```bash
# Gumawa ng .env na may auto-generated na mga lihim
chmod +x prepare-env.sh && ./prepare-env.sh
# Magdagdag ng kahit isang GOCLAW_*_API_KEY sa .env, pagkatapos:
make up
# Web Dashboard sa http://localhost:18790
# Health check: curl http://localhost:18790/health
```
Kapag nakatakda ang mga environment variable na `GOCLAW_*_API_KEY`, ang gateway ay awtomatikong mag-onboard nang walang interactive na mga tanong — nakikita ang provider, nagpapatakbo ng mga migration, at naglalagay ng default na datos.
> Para sa mga variant ng build (OTel, Tailscale, Redis), mga Docker image tag, at compose overlay, tingnan ang [Gabay sa Deployment](https://docs.goclaw.sh/#deploy-docker-compose).
## Multi-Agent Orkestrasyon
Sinusuportahan ng GoClaw ang mga agent team at inter-agent delegation — ang bawat agent ay tumatakbo gamit ang sariling pagkakakilanlan, kasangkapan, LLM provider, at context file.
### Delegasyon ng Agent
| Mode | Paano gumagana | Pinakamainam para sa |
|------|----------------|----------------------|
| **Sync** | Ang Agent A ay nagtatanong sa Agent B at **naghihintay** ng sagot | Mabilis na paghahanap, pagtitiyak ng katotohanan |
| **Async** | Ang Agent A ay nagtatanong sa Agent B at **nagpapatuloy**. Ang B ay mag-aanunsyo sa ibang pagkakataon | Matagal na gawain, ulat, malalim na pagsusuri |
Ang mga agent ay nakikipag-ugnayan sa pamamagitan ng malinaw na **mga link ng pahintulot** na may kontrol sa direksyon (`outbound`, `inbound`, `bidirectional`) at mga limitasyon sa concurrency sa antas ng bawat link at bawat agent.
### Mga Agent Team
- **Pinagsamang task board** — Lumikha, mag-claim, kumpletuhin, at maghanap ng mga gawain na may mga dependency na `blocked_by`
- **Mailbox ng team** — Direktang peer-to-peer na pagmemensahe at mga broadcast
- **Mga Kasangkapan**: `team_tasks` para sa pamamahala ng gawain, `team_message` para sa mailbox
> Para sa mga detalye ng delegasyon, mga link ng pahintulot, at kontrol ng concurrency, tingnan ang [dokumentasyon ng Mga Agent Team](https://docs.goclaw.sh/#teams-what-are-teams).
## Mga Built-in na Kasangkapan
| Kasangkapan | Grupo | Paglalarawan |
| ------------------ | ------------- | ------------------------------------------------------------- |
| `read_file` | fs | Basahin ang nilalaman ng file (na may virtual FS routing) |
| `write_file` | fs | Sumulat/lumikha ng mga file |
| `edit_file` | fs | Mag-apply ng mga targeted na pagbabago sa mga kasalukuyang file |
| `list_files` | fs | Ilista ang mga nilalaman ng direktoryo |
| `search` | fs | Maghanap ng nilalaman ng file ayon sa pattern |
| `glob` | fs | Hanapin ang mga file ayon sa glob pattern |
| `exec` | runtime | Mag-execute ng mga shell command (na may approval workflow) |
| `web_search` | web | Maghanap sa web (Brave, DuckDuckGo) |
| `web_fetch` | web | I-fetch at i-parse ang nilalaman ng web |
| `memory_search` | memory | Maghanap sa pangmatagalang memorya (FTS + vector) |
| `memory_get` | memory | Kunin ang mga entry sa memorya |
| `skill_search` | — | Maghanap ng mga skill (BM25 + embedding hybrid) |
| `knowledge_graph_search` | memory | Maghanap ng mga entity at dumaan sa mga relasyon ng knowledge graph |
| `create_image` | media | Paglikha ng imahe (DashScope, MiniMax) |
| `create_audio` | media | Paglikha ng audio (OpenAI, ElevenLabs, MiniMax, Suno) |
| `create_video` | media | Paglikha ng video (MiniMax, Veo) |
| `read_document` | media | Pagbabasa ng dokumento (Gemini File API, provider chain) |
| `read_image` | media | Pagsusuri ng imahe |
| `read_audio` | media | Pag-transcribe at pagsusuri ng audio |
| `read_video` | media | Pagsusuri ng video |
| `message` | messaging | Magpadala ng mga mensahe sa mga channel |
| `tts` | — | Text-to-Speech synthesis |
| `spawn` | — | Mag-spawn ng subagent |
| `subagents` | sessions | Kontrolin ang mga tumatakbong subagent |
| `team_tasks` | teams | Pinagsamang task board (ilista, lumikha, mag-claim, kumpletuhin, maghanap) |
| `team_message` | teams | Mailbox ng team (magpadala, mag-broadcast, magbasa) |
| `sessions_list` | sessions | Ilista ang mga aktibong session |
| `sessions_history` | sessions | Tingnan ang kasaysayan ng session |
| `sessions_send` | sessions | Magpadala ng mensahe sa isang session |
| `sessions_spawn` | sessions | Mag-spawn ng bagong session |
| `session_status` | sessions | Suriin ang katayuan ng session |
| `cron` | automation | Mag-iskedyul at pamahalaan ang mga cron job |
| `gateway` | automation | Pangangasiwa ng gateway |
| `browser` | ui | Awtomatikong paggamit ng browser (mag-navigate, mag-click, mag-type, screenshot) |
| `announce_queue` | automation | Pag-aanunsyo ng async na resulta (para sa mga async na delegasyon) |
## Dokumentasyon
Buong dokumentasyon sa **[docs.goclaw.sh](https://docs.goclaw.sh)** — o i-browse ang source sa [`goclaw-docs/`](https://github.com/nextlevelbuilder/goclaw-docs)
| Seksyon | Mga Paksa |
|---------|-----------|
| [Pagsisimula](https://docs.goclaw.sh/#what-is-goclaw) | Pag-install, Mabilis na Simula, Konfiguraksyon, Pagsasaliksik sa Web Dashboard |
| [Mga Pangunahing Konsepto](https://docs.goclaw.sh/#how-goclaw-works) | Agent Loop, Mga Session, Mga Kasangkapan, Memorya, Multi-Tenancy |
| [Mga Agent](https://docs.goclaw.sh/#creating-agents) | Paglikha ng Mga Agent, Mga Context File, Personalidad, Pagbabahagi at Access |
| [Mga Provider](https://docs.goclaw.sh/#providers-overview) | Anthropic, OpenAI, OpenRouter, Gemini, DeepSeek, +15 pa |
| [Mga Channel](https://docs.goclaw.sh/#channels-overview) | Telegram, Discord, Slack, Feishu, Zalo, WhatsApp, WebSocket |
| [Mga Agent Team](https://docs.goclaw.sh/#teams-what-are-teams) | Mga Team, Task Board, Pagmemensahe, Delegasyon at Handoff |
| [Advanced](https://docs.goclaw.sh/#custom-tools) | Mga Custom na Kasangkapan, MCP, Mga Skill, Cron, Sandbox, Hooks, RBAC |
| [Deployment](https://docs.goclaw.sh/#deploy-docker-compose) | Docker Compose, Database, Seguridad, Observability, Tailscale |
| [Sanggunian](https://docs.goclaw.sh/#cli-commands) | Mga CLI Command, REST API, WebSocket Protocol, Mga Environment Variable |
## Pagsusuri
```bash
go test ./... # Mga unit test
go test -v ./tests/integration/ -timeout 120s # Mga integration test (nangangailangan ng tumatakbong gateway)
```
## Katayuan ng Proyekto
Tingnan ang [CHANGELOG.md](CHANGELOG.md) para sa detalyadong katayuan ng mga tampok kasama ang kung ano na ang nasubok sa produksyon at kung ano pa ang isinasagawa.
## Mga Pagkilala
Ang GoClaw ay itinayo batay sa orihinal na proyektong [OpenClaw](https://github.com/openclaw/openclaw). Nagpapasalamat kami sa arkitektura at bisyon na nagbigay-inspirasyon sa Go port na ito.
## Lisensya
MIT