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.

DocumentatieSnel startenTwitter / X

Go PostgreSQL Docker WebSocket OpenTelemetry Anthropic OpenAI License: MIT

GoClaw is een multi-agent AI gateway die LLM's verbindt met uw tools, kanalen en gegevens — uitgerold als één enkel Go-binary zonder runtime-afhankelijkheden. Het orkestreert agentteams en inter-agent-delegatie via 20+ LLM-providers met volledige multi-tenant isolatie.

Een Go-port van OpenClaw met verbeterde beveiliging, multi-tenant PostgreSQL en productieklare observeerbaarheid.

🌐 Talen: 🇺🇸 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

Wat maakt het anders

  • Agentteams & Orkestratie — Teams met gedeelde taakborden, inter-agent-delegatie (synchroon/asynchroon) en hybride agentdetectie
  • Multi-Tenant PostgreSQL — Werkruimtes per gebruiker, contextbestanden per gebruiker, versleutelde API-sleutels (AES-256-GCM), geïsoleerde sessies
  • Enkel Binary — ~25 MB statisch Go-binary, geen Node.js-runtime, <1 s opstartijd, draait op een VPS van $5
  • Productiebeveiliging — 5-laags rechtensysteem (gateway-authenticatie → globaal toolbeleid → per agent → per kanaal → alleen eigenaar) plus snelheidsbeperking, detectie van prompt-injectie, SSRF-bescherming, shell-weigerings­patronen en AES-256-GCM-versleuteling
  • 20+ LLM-providers — Anthropic (native HTTP+SSE met prompt-caching), OpenAI, OpenRouter, Groq, DeepSeek, Gemini, Mistral, xAI, MiniMax, Cohere, Perplexity, DashScope, Bailian, Zai, Ollama, Ollama Cloud, Claude CLI, Codex, ACP en elk OpenAI-compatibel eindpunt
  • 7 Berichtenkanalen — Telegram, Discord, Slack, Zalo OA, Zalo Personal, Feishu/Lark, WhatsApp
  • Extended Thinking — Denkmodus per provider (Anthropic-budgettokens, OpenAI-redeneerinspanning, DashScope-denkbudget) met streamingondersteuning
  • Heartbeat — Periodieke agent-check-ins via HEARTBEAT.md-checklists met onderdrukken-bij-OK, actieve uren, herproberinglogica en kanaallevering
  • Plannen & Cronat-, every- en cron-expressies voor geautomatiseerde agenttaken met op rijstroken gebaseerde gelijktijdigheid
  • Observeerbaarheid — Ingebouwde LLM-aanroeptracering met spans en prompt-cachemetrics, optionele OpenTelemetry OTLP-export

Claw-ecosysteem

OpenClaw ZeroClaw PicoClaw GoClaw
Taal TypeScript Rust Go Go
Binary-grootte 28 MB + Node.js 3,4 MB ~8 MB ~25 MB (basis) / ~36 MB (+ OTel)
Docker-image ~50 MB (Alpine)
RAM (inactief) > 1 GB < 5 MB < 10 MB ~35 MB
Opstartijd > 5 s < 10 ms < 1 s < 1 s
Doelhardware $599+ Mac Mini $10 edge $10 edge $5 VPS+
Functie OpenClaw ZeroClaw PicoClaw GoClaw
Multi-tenant (PostgreSQL)
MCP-integratie — (gebruikt ACP) ✅ (stdio/SSE/streamable-http)
Agentteams ✅ Taakbord + postvak
Beveiligingsverharding ✅ (SSRF, padtraversal, injectie) ✅ (sandbox, snelheidsbeperking, injectie, koppeling) Basis (werkruimtebeperking, exec-weigering) ✅ 5-laagse verdediging
OTel-observeerbaarheid ✅ (opt-in extensie) ✅ (Prometheus + OTLP) ✅ OTLP (opt-in build-tag)
Prompt-caching ✅ Anthropic + OpenAI-compat
Kennisgraaf ✅ LLM-extractie + doorloop
Vaardigheidssysteem ✅ Embeddings/semantisch ✅ SKILL.md + TOML ✅ Basis ✅ BM25 + pgvector hybride
Op rijstroken gebaseerde planner Begrensde gelijktijdigheid ✅ (main/subagent/team/cron)
Berichtenkanalen 37+ 15+ 10+ 7+
Companion-apps macOS, iOS, Android Python SDK Webdashboard
Live Canvas / Spraak ✅ (A2UI + TTS/STT) Spraaktranscriptie TTS (4 providers)
LLM-providers 10+ 8 native + 29 compat 13+ 20+
Werkruimtes per gebruiker ✅ (bestandsgebaseerd) ✅ (PostgreSQL)
Versleutelde geheimen — (alleen omgevingsvariabelen) ✅ ChaCha20-Poly1305 — (gewone tekst JSON) ✅ AES-256-GCM in DB

Architectuur

GoClaw Architecture

Snel starten

Vereisten: Go 1.26+, PostgreSQL 18 met pgvector, Docker (optioneel)

Vanuit broncode

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

Met Docker

# Genereer .env met automatisch gegenereerde geheimen
chmod +x prepare-env.sh && ./prepare-env.sh

# Voeg minimaal één GOCLAW_*_API_KEY toe aan .env, dan:
make up

# Webdashboard op http://localhost:18790
# Statuscontrole: curl http://localhost:18790/health

Wanneer GOCLAW_*_API_KEY-omgevingsvariabelen zijn ingesteld, voert de gateway automatisch de installatie uit zonder interactieve aanwijzingen — detecteert de provider, voert migraties uit en seeded standaardgegevens.

Voor buildvarianten (OTel, Tailscale, Redis), Docker-imagetags en compose-overlays, zie de Implementatiegids.

Multi-agent orkestratie

GoClaw ondersteunt agentteams en inter-agent-delegatie — elke agent draait met een eigen identiteit, tools, LLM-provider en contextbestanden.

Agent-delegatie

Agent Delegation

Modus Hoe het werkt Het beste voor
Synchroon Agent A vraagt Agent B en wacht op het antwoord Snelle opzoekingen, feitencontroles
Asynchroon Agent A vraagt Agent B en gaat door. B meldt later Lange taken, rapporten, diepgaande analyses

Agents communiceren via expliciete rechtenkoppelingen met richtingscontrole (outbound, inbound, bidirectional) en gelijktijdigheidsbeperkingen op zowel koppeling- als agentniveau.

Agentteams

Agent Teams Workflow

  • Gedeeld taakbord — Taken aanmaken, claimen, voltooien en zoeken met blocked_by-afhankelijkheden
  • Team-postvak — Directe peer-to-peer berichten en uitzendboodschappen
  • Tools: team_tasks voor taakbeheer, team_message voor het postvak

Voor delegatiedetails, rechtenkoppelingen en gelijktijdigheidscontrole, zie de Agentteams-documentatie.

Ingebouwde tools

Tool Groep Beschrijving
read_file fs Bestandsinhoud lezen (met virtuele FS-routing)
write_file fs Bestanden schrijven/aanmaken
edit_file fs Gerichte bewerkingen op bestaande bestanden toepassen
list_files fs Mapinhoud weergeven
search fs Bestandsinhoud doorzoeken op patroon
glob fs Bestanden zoeken op glob-patroon
exec runtime Shell-opdrachten uitvoeren (met goedkeuringsworkflow)
web_search web Op het web zoeken (Brave, DuckDuckGo)
web_fetch web Webinhoud ophalen en verwerken
memory_search memory Langetermijngeheugen doorzoeken (FTS + vector)
memory_get memory Geheugenitems ophalen
skill_search Vaardigheden zoeken (BM25 + embedding hybride)
knowledge_graph_search memory Entiteiten zoeken en kennisgraafrelaties doorlopen
create_image media Afbeeldingen genereren (DashScope, MiniMax)
create_audio media Audio genereren (OpenAI, ElevenLabs, MiniMax, Suno)
create_video media Video genereren (MiniMax, Veo)
read_document media Documenten lezen (Gemini File API, providerketen)
read_image media Afbeeldingsanalyse
read_audio media Audiotranscriptie en -analyse
read_video media Videoanalyse
message messaging Berichten naar kanalen sturen
tts Tekst-naar-spraak-synthese
spawn Een subagent spawnen
subagents sessions Actieve subagents beheren
team_tasks teams Gedeeld taakbord (weergeven, aanmaken, claimen, voltooien, zoeken)
team_message teams Team-postvak (verzenden, uitzenden, lezen)
sessions_list sessions Actieve sessies weergeven
sessions_history sessions Sessiegeschiedenis bekijken
sessions_send sessions Bericht naar een sessie sturen
sessions_spawn sessions Een nieuwe sessie spawnen
session_status sessions Sessiestatus controleren
cron automation Cron-taken plannen en beheren
gateway automation Gateway-beheer
browser ui Browserautomatisering (navigeren, klikken, typen, schermafbeelding)
announce_queue automation Asynchroon resultaat aankondigen (voor asynchrone delegaties)

Documentatie

Volledige documentatie op docs.goclaw.sh — of blader door de broncode in goclaw-docs/

Sectie Onderwerpen
Aan de slag Installatie, Snel starten, Configuratie, Rondleiding webdashboard
Kernconcepten Agent-loop, Sessies, Tools, Geheugen, Multi-tenancy
Agents Agents aanmaken, Contextbestanden, Persoonlijkheid, Delen & Toegang
Providers Anthropic, OpenAI, OpenRouter, Gemini, DeepSeek, +15 meer
Kanalen Telegram, Discord, Slack, Feishu, Zalo, WhatsApp, WebSocket
Agentteams Teams, Taakbord, Berichten, Delegatie & Overdracht
Geavanceerd Aangepaste tools, MCP, Vaardigheden, Cron, Sandbox, Hooks, RBAC
Implementatie Docker Compose, Database, Beveiliging, Observeerbaarheid, Tailscale
Referentie CLI-opdrachten, REST API, WebSocket Protocol, Omgevingsvariabelen

Testen

go test ./...                                    # Unittests
go test -v ./tests/integration/ -timeout 120s    # Integratietests (vereist actieve gateway)

Projectstatus

Zie CHANGELOG.md voor gedetailleerde functiestatus, inclusief wat in productie is getest en wat nog in ontwikkeling is.

Dankbetuigingen

GoClaw is gebouwd op het originele OpenClaw-project. We zijn dankbaar voor de architectuur en visie die deze Go-port hebben geïnspireerd.

Licentie

MIT