Skip to content

Latest commit

 

History

History
248 lines (200 loc) · 17.2 KB

File metadata and controls

248 lines (200 loc) · 17.2 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.

DokumentationSnabbstartTwitter / X

Go PostgreSQL Docker WebSocket OpenTelemetry Anthropic OpenAI License: MIT

GoClaw är en multi-agent AI-gateway som kopplar ihop LLM:er med dina verktyg, kanaler och data — driftsatt som en enda Go-binärfil utan externa körtidsberoenden. Den orkestrerar agentteam och inter-agent-delegering mellan 20+ LLM-leverantörer med full flertenantsisolering.

En Go-port av OpenClaw med förbättrad säkerhet, flertenants PostgreSQL och observerbarhet för produktionsmiljö.

🌐 Språk: 🇺🇸 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

Vad som skiljer den åt

  • Agentteam och orkestrering — Team med delade uppgiftstavlor, inter-agent-delegering (synkron/asynkron) och hybrid agentupptäckt
  • Flertenants PostgreSQL — Per-användararbetsytor, per-användarkontextfiler, krypterade API-nycklar (AES-256-GCM), isolerade sessioner
  • Enstaka binärfil — ~25 MB statisk Go-binärfil, ingen Node.js-körningstid, <1s uppstartstid, körs på en $5 VPS
  • Produktionssäkerhet — 5-lagers behörighetssystem (gateway-autentisering → global verktygspolicy → per-agent → per-kanal → ägarexklusivt) plus hastighetsbegränsning, detektering av prompt injection, SSRF-skydd, nekade skalkommandon och AES-256-GCM-kryptering
  • 20+ LLM-leverantörer — Anthropic (native HTTP+SSE med prompt caching), OpenAI, OpenRouter, Groq, DeepSeek, Gemini, Mistral, xAI, MiniMax, Cohere, Perplexity, DashScope, Bailian, Zai, Ollama, Ollama Cloud, Claude CLI, Codex, ACP och valfri OpenAI-kompatibel slutpunkt
  • 7 meddelandekanaler — Telegram, Discord, Slack, Zalo OA, Zalo Personal, Feishu/Lark, WhatsApp
  • Extended Thinking — Per-leverantörs tänkande-läge (Anthropic budgettokens, OpenAI resonemangsnivå, DashScope thinking budget) med stöd för strömning
  • Heartbeat — Periodiska agentincheckning via HEARTBEAT.md-checklistor med undertryckning vid OK-status, aktiva timmar, återförsökslogik och kanalleverans
  • Schemaläggning och Cronat, every och cron-uttryck för automatiserade agentuppgifter med filbaserad samtidighetskontroll
  • Observerbarhet — Inbyggd LLM-anropsspårning med spann och prompt cache-mätvärden, valfri OpenTelemetry OTLP-export

Claw-ekosystemet

OpenClaw ZeroClaw PicoClaw GoClaw
Språk TypeScript Rust Go Go
Binärstorlek 28 MB + Node.js 3.4 MB ~8 MB ~25 MB (bas) / ~36 MB (+ OTel)
Docker-avbild ~50 MB (Alpine)
RAM (vilande) > 1 GB < 5 MB < 10 MB ~35 MB
Uppstart > 5 s < 10 ms < 1 s < 1 s
Målhårdvara $599+ Mac Mini $10 edge $10 edge $5 VPS+
Funktion OpenClaw ZeroClaw PicoClaw GoClaw
Flertenants (PostgreSQL)
MCP-integration — (använder ACP) ✅ (stdio/SSE/streamable-http)
Agentteam ✅ Uppgiftstavla + brevlåda
Säkerhetshärdning ✅ (SSRF, path traversal, injection) ✅ (sandbox, rate limit, injection, pairing) Grundläggande (workspace-begränsning, exec-neka) ✅ 5-lagers försvar
OTel-observerbarhet ✅ (valfri tillägg) ✅ (Prometheus + OTLP) ✅ OTLP (valfri build-tag)
Prompt caching ✅ Anthropic + OpenAI-compat
Kunskapsgraf ✅ LLM-extraktion + traversering
Färdighetssystem ✅ Inbäddningar/semantisk ✅ SKILL.md + TOML ✅ Grundläggande ✅ BM25 + pgvector hybrid
Filbaserad schemaläggare Begränsad samtidighet ✅ (main/subagent/team/cron)
Meddelandekanaler 37+ 15+ 10+ 7+
Medföljande appar macOS, iOS, Android Python SDK Webbinstrumentpanel
Live Canvas / Röst ✅ (A2UI + TTS/STT) Rösttransskription TTS (4 leverantörer)
LLM-leverantörer 10+ 8 native + 29 compat 13+ 20+
Per-användararbetsytor ✅ (filbaserad) ✅ (PostgreSQL)
Krypterade hemligheter — (endast miljövariabler) ✅ ChaCha20-Poly1305 — (klartext-JSON) ✅ AES-256-GCM i DB

Arkitektur

GoClaw Architecture

Snabbstart

Förutsättningar: Go 1.26+, PostgreSQL 18 med pgvector, Docker (valfritt)

Från källkod

git clone https://github.com/nextlevelbuilder/goclaw.git && cd goclaw
make build
./goclaw onboard        # Interaktiv installationsguide
source .env.local && ./goclaw

Med Docker

# Generera .env med automatiskt skapade hemligheter
chmod +x prepare-env.sh && ./prepare-env.sh

# Lägg till minst en GOCLAW_*_API_KEY i .env, sedan:
make up

# Webbinstrumentpanel på http://localhost:18790
# Hälsokontroll: curl http://localhost:18790/health

När miljövariabler av typen GOCLAW_*_API_KEY är inställda registreras gatewayen automatiskt utan interaktiva promptar — identifierar leverantör, kör migrationer och sår standarddata.

För byggvarianter (OTel, Tailscale, Redis), Docker-avbildstaggar och compose-överlägg, se Driftsättningsguiden.

Multi-agent-orkestrering

GoClaw stöder agentteam och inter-agent-delegering — varje agent körs med sin egen identitet, verktyg, LLM-leverantör och kontextfiler.

Agentdelegering

Agent Delegation

Läge Hur det fungerar Passar bäst för
Synkron Agent A frågar Agent B och väntar på svaret Snabba slagningar, faktakontroller
Asynkron Agent A frågar Agent B och fortsätter. B meddelar senare Långa uppgifter, rapporter, djupanalys

Agenter kommunicerar via explicita behörighetslänkar med riktningskontroll (outbound, inbound, bidirectional) och samtidighetsbegränsningar på både per-länk- och per-agentnivå.

Agentteam

Agent Teams Workflow

  • Delad uppgiftstavla — Skapa, ta, slutföra och söka uppgifter med blocked_by-beroenden
  • Teamets brevlåda — Direkt peer-to-peer-meddelanden och utsändningar
  • Verktyg: team_tasks för uppgiftshantering, team_message för brevlådan

För detaljer om delegering, behörighetslänkar och samtidighetskontroll, se dokumentationen för agentteam.

Inbyggda verktyg

Verktyg Grupp Beskrivning
read_file fs Läs filinnehåll (med virtuell FS-routing)
write_file fs Skriv/skapa filer
edit_file fs Applicera riktade redigeringar på befintliga filer
list_files fs Lista kataloginnehåll
search fs Sök filinnehåll med mönster
glob fs Hitta filer med glob-mönster
exec runtime Kör skalkommandon (med godkännandeflöde)
web_search web Sök på webben (Brave, DuckDuckGo)
web_fetch web Hämta och tolka webbinnehåll
memory_search memory Sök i långtidsminnet (FTS + vektor)
memory_get memory Hämta minnesposter
skill_search Sök färdigheter (BM25 + inbäddningshybrid)
knowledge_graph_search memory Sök entiteter och traversera kunskapsgrafrelationer
create_image media Bildgenerering (DashScope, MiniMax)
create_audio media Ljudgenerering (OpenAI, ElevenLabs, MiniMax, Suno)
create_video media Videogenerering (MiniMax, Veo)
read_document media Dokumentläsning (Gemini File API, leverantörskedja)
read_image media Bildanalys
read_audio media Ljudtransskription och analys
read_video media Videoanalys
message messaging Skicka meddelanden till kanaler
tts Text-till-tal-syntes
spawn Starta en underagent
subagents sessions Styr körande underagenter
team_tasks teams Delad uppgiftstavla (lista, skapa, ta, slutföra, söka)
team_message teams Teamets brevlåda (skicka, sända ut, läsa)
sessions_list sessions Lista aktiva sessioner
sessions_history sessions Visa sessionshistorik
sessions_send sessions Skicka meddelande till en session
sessions_spawn sessions Starta en ny session
session_status sessions Kontrollera sessionsstatus
cron automation Schemalägg och hantera cron-jobb
gateway automation Gatewayadministration
browser ui Webbläsarautomation (navigera, klicka, skriva, skärmdump)
announce_queue automation Asynkron resultatannonsering (för asynkrona delegeringar)

Dokumentation

Fullständig dokumentation på docs.goclaw.sh — eller bläddra i källkoden i goclaw-docs/

Avsnitt Ämnen
Kom igång Installation, Snabbstart, Konfiguration, Rundtur i webbinstrumentpanelen
Grundläggande begrepp Agentloop, Sessioner, Verktyg, Minne, Flertenancy
Agenter Skapa agenter, Kontextfiler, Personlighet, Delning och åtkomst
Leverantörer Anthropic, OpenAI, OpenRouter, Gemini, DeepSeek, +15 fler
Kanaler Telegram, Discord, Slack, Feishu, Zalo, WhatsApp, WebSocket
Agentteam Team, Uppgiftstavla, Meddelanden, Delegering och överlämning
Avancerat Anpassade verktyg, MCP, Färdigheter, Cron, Sandbox, Krokar, RBAC
Driftsättning Docker Compose, Databas, Säkerhet, Observerbarhet, Tailscale
Referens CLI-kommandon, REST API, WebSocket-protokoll, Miljövariabler

Testning

go test ./...                                    # Enhetstester
go test -v ./tests/integration/ -timeout 120s    # Integrationstester (kräver körande gateway)

Projektstatus

Se CHANGELOG.md för detaljerad funktionsstatus, inklusive vad som testats i produktion och vad som fortfarande pågår.

Erkännanden

GoClaw är byggt på det ursprungliga OpenClaw-projektet. Vi är tacksamma för den arkitektur och vision som inspirerade denna Go-port.

Licens

MIT