Skip to content

Latest commit

 

History

History
248 lines (200 loc) · 17.7 KB

File metadata and controls

248 lines (200 loc) · 17.7 KB

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.

DokumentaceRychlý startTwitter / X

Go PostgreSQL Docker WebSocket OpenTelemetry Anthropic OpenAI License: MIT

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, every a 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

GoClaw Architecture

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é:
make up

# Webový dashboard na http://localhost:18790
# 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ů

Agent Delegation

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ů

Agent Teams Workflow

  • 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_tasks pro správu úkolů, team_message pro 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