mirror of
https://github.com/tiennm99/goclaw.git
synced 2026-07-28 16:20:39 +00:00
d9dffc66e7
* docs: restructure README with i18n, static diagrams, and accuracy fixes Restructure: - Reduce README from ~950 to ~280 lines (hub-and-spoke pattern) - Move Project Status to CHANGELOG.md - Add hero section: centered title, tagline, description, badges - Add nav links: Documentation, Quick Start, Twitter/X (OpenFang pattern) - Add Documentation table linking all docs.goclaw.sh sections - Replace 3 mermaid diagrams with static images for consistent rendering Accuracy fixes: - Fix provider count: 13+ → 20+ (verified from gateway_providers.go) - Fix "5-layer defense" → 5-layer permission system per policy.go - Add missing features: Heartbeat, Scheduling/Cron, Observability - Fix all docs URLs to docs.goclaw.sh hash routing - Add VPS $5 minimum 2GB RAM note for Docker Internationalization (30 languages, ZeroClaw coverage): zh-CN, ja, ko, vi, tl, es, pt, it, de, fr, ar, hi, ru, bn, he, pl, cs, nl, tr, uk, id, th, ur, ro, sv, el, hu, fi, da, nb - Keep product feature names in English: Extended Thinking, Heartbeat - Vietnamese README hand-tuned for natural phrasing * docs: move translated READMEs to _readmes/ directory Keep all 30 language translations but declutter the project root. Fix relative links (_statics/, cross-language, main README) for new location. Update main README language selector to point to _readmes/. --------- Co-authored-by: viettranx <viettranx@gmail.com>
18 KiB
18 KiB
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.
Dokumentace • Rychlý start • Twitter / X
GoClaw je multi-agentní AI gateway, která propojuje LLM s vašimi nástroji, kanály a daty — nasazena jako jediný Go binární soubor bez runtime závislostí. Orchestruje týmy agentů a delegování mezi agenty napříč 20+ poskytovateli LLM s plnou multi-tenant izolací.
Go port projektu OpenClaw s vylepšeným zabezpečením, multi-tenant PostgreSQL a produkční pozorovatelností.
🌐 Jazyky: 🇺🇸 English · 🇨🇳 简体中文 · 🇯🇵 日本語 · 🇰🇷 한국어 · 🇻🇳 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
Co ho odlišuje
- Týmy agentů a orchestrace — Týmy se sdílenými nástěnkami úkolů, delegováním mezi agenty (synchronní/asynchronní) a hybridním vyhledáváním agentů
- Multi-tenant PostgreSQL — Pracovní prostory pro každého uživatele, kontextové soubory pro každého uživatele, šifrované API klíče (AES-256-GCM), izolované relace
- Jediný binární soubor — ~25 MB statický Go binární soubor, bez Node.js runtime, <1 s spuštění, běží na VPS za $5
- Produkční bezpečnost — 5vrstvý systém oprávnění (autentizace gateway → globální politika nástrojů → na agenta → na kanál → pouze vlastník) plus omezení rychlosti, detekce injekce promptů, ochrana SSRF, vzory zamítnutí shellu a šifrování AES-256-GCM
- 20+ poskytovatelů LLM — Anthropic (nativní HTTP+SSE s cachováním promptů), OpenAI, OpenRouter, Groq, DeepSeek, Gemini, Mistral, xAI, MiniMax, Cohere, Perplexity, DashScope, Bailian, Zai, Ollama, Ollama Cloud, Claude CLI, Codex, ACP a libovolný OpenAI-kompatibilní endpoint
- 7 komunikačních kanálů — Telegram, Discord, Slack, Zalo OA, Zalo Personal, Feishu/Lark, WhatsApp
- Extended Thinking — Režim myšlení pro každého poskytovatele (Anthropic tokeny rozpočtu, OpenAI effort uvažování, DashScope rozpočet myšlení) s podporou streamování
- Heartbeat — Pravidelné kontroly agentů prostřednictvím kontrolních seznamů HEARTBEAT.md s potlačením při OK, aktivními hodinami, logikou opakování a doručením do kanálu
- Plánování a Cron — Výrazy
at,everya cron pro automatizované úlohy agentů s souběžností na základě pruhů - Pozorovatelnost — Vestavěné trasování volání LLM se spany a metrikami cache promptů, volitelný export OpenTelemetry OTLP
Ekosystém Claw
| OpenClaw | ZeroClaw | PicoClaw | GoClaw | |
|---|---|---|---|---|
| Jazyk | TypeScript | Rust | Go | Go |
| Velikost binárního souboru | 28 MB + Node.js | 3.4 MB | ~8 MB | ~25 MB (základ) / ~36 MB (+ OTel) |
| Docker image | — | — | — | ~50 MB (Alpine) |
| RAM (nečinnost) | > 1 GB | < 5 MB | < 10 MB | ~35 MB |
| Spuštění | > 5 s | < 10 ms | < 1 s | < 1 s |
| Cílový hardware | Mac Mini od $599+ | edge za $10 | edge za $10 | VPS od $5+ |
| Funkce | OpenClaw | ZeroClaw | PicoClaw | GoClaw |
|---|---|---|---|---|
| Multi-tenant (PostgreSQL) | — | — | — | ✅ |
| Integrace MCP | — (používá ACP) | — | — | ✅ (stdio/SSE/streamable-http) |
| Týmy agentů | — | — | — | ✅ Nástěnka úkolů + schránka |
| Posílení bezpečnosti | ✅ (SSRF, path traversal, injection) | ✅ (sandbox, omezení rychlosti, injection, párování) | Základní (omezení workspace, zamítnutí exec) | ✅ 5vrstvá obrana |
| Pozorovatelnost OTel | ✅ (volitelné rozšíření) | ✅ (Prometheus + OTLP) | — | ✅ OTLP (volitelný build tag) |
| Cachování promptů | — | — | — | ✅ Anthropic + OpenAI-compat |
| Znalostní graf | — | — | — | ✅ Extrakce LLM + procházení |
| Systém dovedností | ✅ Embeddings/sémantické | ✅ SKILL.md + TOML | ✅ Základní | ✅ BM25 + pgvector hybrid |
| Plánovač na základě pruhů | ✅ | Omezená souběžnost | — | ✅ (main/subagent/team/cron) |
| Komunikační kanály | 37+ | 15+ | 10+ | 7+ |
| Doprovodné aplikace | macOS, iOS, Android | Python SDK | — | Webový dashboard |
| Live Canvas / Hlas | ✅ (A2UI + TTS/STT) | — | Přepis hlasu | TTS (4 poskytovatelé) |
| Poskytovatelé LLM | 10+ | 8 nativních + 29 compat | 13+ | 20+ |
| Pracovní prostory na uživatele | ✅ (souborové) | — | — | ✅ (PostgreSQL) |
| Šifrovaná tajemství | — (pouze env proměnné) | ✅ ChaCha20-Poly1305 | — (plaintext JSON) | ✅ AES-256-GCM v DB |
Architektura
Rychlý start
Předpoklady: Go 1.26+, PostgreSQL 18 s pgvector, Docker (volitelně)
Ze zdrojového kódu
git clone https://github.com/nextlevelbuilder/goclaw.git && cd goclaw
make build
./goclaw onboard # Interaktivní průvodce nastavením
source .env.local && ./goclaw
S Docker
# Vygenerovat .env s automaticky generovanými tajemstvími
chmod +x prepare-env.sh && ./prepare-env.sh
# Přidat alespoň jeden GOCLAW_*_API_KEY do .env, poté:
docker compose -f docker-compose.yml -f docker-compose.postgres.yml \
-f docker-compose.selfservice.yml up -d
# Webový dashboard na http://localhost:3000
# Kontrola stavu: curl http://localhost:18790/health
Pokud jsou nastaveny proměnné prostředí GOCLAW_*_API_KEY, gateway se automaticky inicializuje bez interaktivních výzev — detekuje poskytovatele, spustí migrace a naplní výchozí data.
Pro varianty sestavení (OTel, Tailscale, Redis), tagy Docker image a překrytí compose viz Průvodce nasazením.
Multi-agentní orchestrace
GoClaw podporuje týmy agentů a delegování mezi agenty — každý agent běží s vlastní identitou, nástroji, poskytovatelem LLM a kontextovými soubory.
Delegování agentů
| Režim | Jak funguje | Nejvhodnejší pro |
|---|---|---|
| Synchronní | Agent A se zeptá Agenta B a čeká na odpověď | Rychlé vyhledávání, ověření faktů |
| Asynchronní | Agent A se zeptá Agenta B a pokračuje dál. B oznámí výsledek později | Dlouhé úkoly, zprávy, hloubková analýza |
Agenti komunikují prostřednictvím explicitních odkazů oprávnění s řízením směru (outbound, inbound, bidirectional) a limity souběžnosti na úrovni odkazu i agenta.
Týmy agentů
- Sdílená nástěnka úkolů — Vytváření, přiřazování, dokončování a vyhledávání úkolů se závislostmi
blocked_by - Týmová schránka — Přímé zprávy mezi peer agenty a broadcasty
- Nástroje:
team_taskspro správu úkolů,team_messagepro schránku
Podrobnosti o delegování, odkazech oprávnění a řízení souběžnosti viz dokumentace Týmů agentů.
Vestavěné nástroje
| Nástroj | Skupina | Popis |
|---|---|---|
read_file |
fs | Čtení obsahu souborů (s virtuálním FS routingem) |
write_file |
fs | Zápis/vytváření souborů |
edit_file |
fs | Cílené úpravy existujících souborů |
list_files |
fs | Výpis obsahu adresáře |
search |
fs | Vyhledávání obsahu souborů podle vzoru |
glob |
fs | Vyhledávání souborů podle glob vzoru |
exec |
runtime | Spouštění příkazů shellu (s workflow schválení) |
web_search |
web | Vyhledávání na webu (Brave, DuckDuckGo) |
web_fetch |
web | Stahování a parsování webového obsahu |
memory_search |
memory | Vyhledávání v dlouhodobé paměti (FTS + vector) |
memory_get |
memory | Načítání záznamů paměti |
skill_search |
— | Vyhledávání dovedností (BM25 + embedding hybrid) |
knowledge_graph_search |
memory | Vyhledávání entit a procházení vztahů ve znalostním grafu |
create_image |
media | Generování obrázků (DashScope, MiniMax) |
create_audio |
media | Generování zvuku (OpenAI, ElevenLabs, MiniMax, Suno) |
create_video |
media | Generování videa (MiniMax, Veo) |
read_document |
media | Čtení dokumentů (Gemini File API, řetěz poskytovatelů) |
read_image |
media | Analýza obrázků |
read_audio |
media | Přepis a analýza zvuku |
read_video |
media | Analýza videa |
message |
messaging | Odesílání zpráv do kanálů |
tts |
— | Syntéza textu na řeč |
spawn |
— | Spuštění subagenta |
subagents |
sessions | Řízení běžících subagentů |
team_tasks |
teams | Sdílená nástěnka úkolů (seznam, vytvoření, přiřazení, dokončení, vyhledávání) |
team_message |
teams | Týmová schránka (odeslání, broadcast, čtení) |
sessions_list |
sessions | Výpis aktivních relací |
sessions_history |
sessions | Zobrazení historie relací |
sessions_send |
sessions | Odeslání zprávy do relace |
sessions_spawn |
sessions | Spuštění nové relace |
session_status |
sessions | Kontrola stavu relace |
cron |
automation | Plánování a správa cron úloh |
gateway |
automation | Správa gateway |
browser |
ui | Automatizace prohlížeče (navigace, klikání, psaní, screenshot) |
announce_queue |
automation | Oznámení asynchronních výsledků (pro asynchronní delegování) |
Dokumentace
Úplná dokumentace na docs.goclaw.sh — nebo procházejte zdroj v goclaw-docs/
| Sekce | Témata |
|---|---|
| Začínáme | Instalace, Rychlý start, Konfigurace, Prohlídka webového dashboardu |
| Základní koncepty | Smyčka agenta, Relace, Nástroje, Paměť, Multi-tenancy |
| Agenti | Vytváření agentů, Kontextové soubory, Osobnost, Sdílení a přístup |
| Poskytovatelé | Anthropic, OpenAI, OpenRouter, Gemini, DeepSeek, +15 dalších |
| Kanály | Telegram, Discord, Slack, Feishu, Zalo, WhatsApp, WebSocket |
| Týmy agentů | Týmy, Nástěnka úkolů, Zasílání zpráv, Delegování a předání |
| Pokročilé | Vlastní nástroje, MCP, Dovednosti, Cron, Sandbox, Háky, RBAC |
| Nasazení | Docker Compose, Databáze, Bezpečnost, Pozorovatelnost, Tailscale |
| Reference | Příkazy CLI, REST API, WebSocket protokol, Proměnné prostředí |
Testování
go test ./... # Jednotkové testy
go test -v ./tests/integration/ -timeout 120s # Integrační testy (vyžaduje běžící gateway)
Stav projektu
Podrobný stav funkcí včetně toho, co bylo otestováno v produkci a co je stále ve vývoji, viz CHANGELOG.md.
Poděkování
GoClaw je postaven na původním projektu OpenClaw. Jsme vděčni za architekturu a vizi, která inspirovala tento Go port.
Licence
MIT