* 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>
24 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.
दस्तावेज़ीकरण • त्वरित प्रारंभ • Twitter / X
GoClaw एक मल्टी-एजेंट AI गेटवे है जो LLMs को आपके टूल्स, चैनलों और डेटा से जोड़ता है — एक सिंगल Go बाइनरी के रूप में तैनात, बिना किसी रनटाइम निर्भरता के। यह 20+ LLM प्रदाताओं के साथ पूर्ण मल्टी-टेनेंट आइसोलेशन के साथ एजेंट टीमों और इंटर-एजेंट डेलीगेशन को ऑर्केस्ट्रेट करता है।
OpenClaw का एक Go पोर्ट, जिसमें उन्नत सुरक्षा, मल्टी-टेनेंट PostgreSQL और प्रोडक्शन-ग्रेड ऑब्ज़र्वेबिलिटी है।
🌐 Languages: 🇺🇸 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
यह क्या अलग बनाता है
- एजेंट टीमें और ऑर्केस्ट्रेशन — साझा टास्क बोर्ड, इंटर-एजेंट डेलीगेशन (sync/async), और हाइब्रिड एजेंट डिस्कवरी के साथ टीमें
- मल्टी-टेनेंट PostgreSQL — प्रति-उपयोगकर्ता वर्कस्पेस, प्रति-उपयोगकर्ता कॉन्टेक्स्ट फ़ाइलें, एन्क्रिप्टेड API कुंजियाँ (AES-256-GCM), आइसोलेटेड सेशन
- सिंगल बाइनरी — ~25 MB स्टेटिक Go बाइनरी, कोई Node.js रनटाइम नहीं, <1s स्टार्टअप, $5 VPS पर चलती है
- प्रोडक्शन सुरक्षा — 5-लेयर परमिशन सिस्टम (gateway auth → global tool policy → per-agent → per-channel → owner-only) के साथ रेट लिमिटिंग, प्रॉम्प्ट इंजेक्शन डिटेक्शन, SSRF प्रोटेक्शन, शेल डेनाय पैटर्न, और AES-256-GCM एन्क्रिप्शन
- 20+ LLM प्रदाता — Anthropic (नेटिव HTTP+SSE विथ प्रॉम्प्ट कैशिंग), OpenAI, OpenRouter, Groq, DeepSeek, Gemini, Mistral, xAI, MiniMax, Cohere, Perplexity, DashScope, Bailian, Zai, Ollama, Ollama Cloud, Claude CLI, Codex, ACP, और कोई भी OpenAI-compatible एंडपॉइंट
- 7 मैसेजिंग चैनल — Telegram, Discord, Slack, Zalo OA, Zalo Personal, Feishu/Lark, WhatsApp
- Extended Thinking — प्रति-प्रदाता थिंकिंग मोड (Anthropic बजट टोकन, OpenAI रीज़निंग एफर्ट, DashScope थिंकिंग बजट) स्ट्रीमिंग सपोर्ट के साथ
- Heartbeat — HEARTBEAT.md चेकलिस्ट के माध्यम से आवधिक एजेंट चेक-इन, suppress-on-OK, सक्रिय घंटे, रिट्री लॉजिक और चैनल डिलीवरी के साथ
- शेड्यूलिंग और Cron — स्वचालित एजेंट कार्यों के लिए
at,every, और cron एक्सप्रेशन, लेन-आधारित कंकरेंसी के साथ - ऑब्ज़र्वेबिलिटी — स्पैन और प्रॉम्प्ट कैश मेट्रिक्स के साथ बिल्ट-इन LLM कॉल ट्रेसिंग, वैकल्पिक OpenTelemetry OTLP एक्सपोर्ट
Claw इकोसिस्टम
| OpenClaw | ZeroClaw | PicoClaw | GoClaw | |
|---|---|---|---|---|
| भाषा | TypeScript | Rust | Go | Go |
| बाइनरी आकार | 28 MB + Node.js | 3.4 MB | ~8 MB | ~25 MB (base) / ~36 MB (+ OTel) |
| Docker इमेज | — | — | — | ~50 MB (Alpine) |
| RAM (निष्क्रिय) | > 1 GB | < 5 MB | < 10 MB | ~35 MB |
| स्टार्टअप | > 5 s | < 10 ms | < 1 s | < 1 s |
| लक्ष्य हार्डवेयर | $599+ Mac Mini | $10 edge | $10 edge | $5 VPS+ |
| फीचर | OpenClaw | ZeroClaw | PicoClaw | GoClaw |
|---|---|---|---|---|
| मल्टी-टेनेंट (PostgreSQL) | — | — | — | ✅ |
| MCP इंटीग्रेशन | — (uses ACP) | — | — | ✅ (stdio/SSE/streamable-http) |
| एजेंट टीमें | — | — | — | ✅ Task board + mailbox |
| सुरक्षा हार्डनिंग | ✅ (SSRF, path traversal, injection) | ✅ (sandbox, rate limit, injection, pairing) | Basic (workspace restrict, exec deny) | ✅ 5-layer defense |
| OTel ऑब्ज़र्वेबिलिटी | ✅ (opt-in extension) | ✅ (Prometheus + OTLP) | — | ✅ OTLP (opt-in build tag) |
| प्रॉम्प्ट कैशिंग | — | — | — | ✅ Anthropic + OpenAI-compat |
| नॉलेज ग्राफ | — | — | — | ✅ LLM extraction + traversal |
| स्किल सिस्टम | ✅ Embeddings/semantic | ✅ SKILL.md + TOML | ✅ Basic | ✅ BM25 + pgvector hybrid |
| लेन-आधारित शेड्यूलर | ✅ | Bounded concurrency | — | ✅ (main/subagent/team/cron) |
| मैसेजिंग चैनल | 37+ | 15+ | 10+ | 7+ |
| कम्पेनियन ऐप्स | macOS, iOS, Android | Python SDK | — | Web dashboard |
| लाइव कैनवास / वॉइस | ✅ (A2UI + TTS/STT) | — | Voice transcription | TTS (4 providers) |
| LLM प्रदाता | 10+ | 8 native + 29 compat | 13+ | 20+ |
| प्रति-उपयोगकर्ता वर्कस्पेस | ✅ (file-based) | — | — | ✅ (PostgreSQL) |
| एन्क्रिप्टेड सीक्रेट्स | — (env vars only) | ✅ ChaCha20-Poly1305 | — (plaintext JSON) | ✅ AES-256-GCM in DB |
आर्किटेक्चर
त्वरित प्रारंभ
पूर्व-आवश्यकताएँ: Go 1.26+, PostgreSQL 18 with pgvector, Docker (वैकल्पिक)
सोर्स से
git clone https://github.com/nextlevelbuilder/goclaw.git && cd goclaw
make build
./goclaw onboard # Interactive setup wizard
source .env.local && ./goclaw
Docker के साथ
# Generate .env with auto-generated secrets
chmod +x prepare-env.sh && ./prepare-env.sh
# Add at least one GOCLAW_*_API_KEY to .env, then:
docker compose -f docker-compose.yml -f docker-compose.postgres.yml \
-f docker-compose.selfservice.yml up -d
# Web Dashboard at http://localhost:3000
# Health check: curl http://localhost:18790/health
जब GOCLAW_*_API_KEY एनवायरनमेंट वेरिएबल सेट हों, तो गेटवे इंटरएक्टिव प्रॉम्प्ट के बिना स्वत: ऑनबोर्ड हो जाता है — प्रदाता का पता लगाता है, माइग्रेशन चलाता है, और डिफ़ॉल्ट डेटा सीड करता है।
बिल्ड वेरिएंट (OTel, Tailscale, Redis), Docker इमेज टैग, और compose ओवरले के लिए, Deployment Guide देखें।
मल्टी-एजेंट ऑर्केस्ट्रेशन
GoClaw एजेंट टीमों और इंटर-एजेंट डेलीगेशन का समर्थन करता है — प्रत्येक एजेंट अपनी पहचान, टूल्स, LLM प्रदाता, और कॉन्टेक्स्ट फ़ाइलों के साथ चलता है।
एजेंट डेलीगेशन
| मोड | यह कैसे काम करता है | किसके लिए सबसे अच्छा |
|---|---|---|
| Sync | एजेंट A, एजेंट B से पूछता है और उत्तर की प्रतीक्षा करता है | त्वरित खोज, तथ्य जाँच |
| Async | एजेंट A, एजेंट B से पूछता है और आगे बढ़ जाता है। B बाद में घोषणा करता है | लंबे कार्य, रिपोर्ट, गहन विश्लेषण |
एजेंट स्पष्ट परमिशन लिंक के माध्यम से संवाद करते हैं, जिसमें दिशा नियंत्रण (outbound, inbound, bidirectional) और प्रति-लिंक तथा प्रति-एजेंट दोनों स्तरों पर कंकरेंसी सीमाएँ होती हैं।
एजेंट टीमें
- साझा टास्क बोर्ड —
blocked_byनिर्भरताओं के साथ टास्क बनाएं, क्लेम करें, पूरा करें, खोजें - टीम मेलबॉक्स — सीधे पीयर-टू-पीयर मैसेजिंग और ब्रॉडकास्ट
- टूल्स: टास्क मैनेजमेंट के लिए
team_tasks, मेलबॉक्स के लिएteam_message
डेलीगेशन विवरण, परमिशन लिंक, और कंकरेंसी कंट्रोल के लिए, Agent Teams docs देखें।
बिल्ट-इन टूल्स
| टूल | समूह | विवरण |
|---|---|---|
read_file |
fs | फ़ाइल सामग्री पढ़ें (virtual FS routing के साथ) |
write_file |
fs | फ़ाइलें लिखें/बनाएं |
edit_file |
fs | मौजूदा फ़ाइलों में लक्षित संपादन लागू करें |
list_files |
fs | डायरेक्टरी सामग्री सूचीबद्ध करें |
search |
fs | पैटर्न द्वारा फ़ाइल सामग्री खोजें |
glob |
fs | glob पैटर्न द्वारा फ़ाइलें खोजें |
exec |
runtime | शेल कमांड चलाएं (approval workflow के साथ) |
web_search |
web | वेब खोजें (Brave, DuckDuckGo) |
web_fetch |
web | वेब सामग्री फेच और पार्स करें |
memory_search |
memory | दीर्घकालिक मेमोरी खोजें (FTS + vector) |
memory_get |
memory | मेमोरी एंट्री प्राप्त करें |
skill_search |
— | स्किल खोजें (BM25 + embedding hybrid) |
knowledge_graph_search |
memory | एंटिटी खोजें और नॉलेज ग्राफ संबंध ट्रैवर्स करें |
create_image |
media | इमेज जेनरेशन (DashScope, MiniMax) |
create_audio |
media | ऑडियो जेनरेशन (OpenAI, ElevenLabs, MiniMax, Suno) |
create_video |
media | वीडियो जेनरेशन (MiniMax, Veo) |
read_document |
media | दस्तावेज़ पढ़ना (Gemini File API, provider chain) |
read_image |
media | इमेज विश्लेषण |
read_audio |
media | ऑडियो ट्रांसक्रिप्शन और विश्लेषण |
read_video |
media | वीडियो विश्लेषण |
message |
messaging | चैनलों पर संदेश भेजें |
tts |
— | Text-to-Speech सिंथेसिस |
spawn |
— | एक सबएजेंट स्पॉन करें |
subagents |
sessions | चल रहे सबएजेंट नियंत्रित करें |
team_tasks |
teams | साझा टास्क बोर्ड (list, create, claim, complete, search) |
team_message |
teams | टीम मेलबॉक्स (send, broadcast, read) |
sessions_list |
sessions | सक्रिय सेशन सूचीबद्ध करें |
sessions_history |
sessions | सेशन इतिहास देखें |
sessions_send |
sessions | किसी सेशन पर संदेश भेजें |
sessions_spawn |
sessions | एक नया सेशन स्पॉन करें |
session_status |
sessions | सेशन स्थिति जाँचें |
cron |
automation | cron जॉब शेड्यूल और प्रबंधित करें |
gateway |
automation | गेटवे प्रशासन |
browser |
ui | ब्राउज़र ऑटोमेशन (navigate, click, type, screenshot) |
announce_queue |
automation | असिंक्रोनस परिणाम घोषणा (async delegations के लिए) |
दस्तावेज़ीकरण
पूर्ण दस्तावेज़ीकरण docs.goclaw.sh पर — या goclaw-docs/ में सोर्स ब्राउज़ करें।
| अनुभाग | विषय |
|---|---|
| Getting Started | इंस्टॉलेशन, त्वरित प्रारंभ, कॉन्फ़िगरेशन, Web Dashboard टूर |
| Core Concepts | एजेंट लूप, सेशन, टूल्स, मेमोरी, मल्टी-टेनेंसी |
| Agents | एजेंट बनाना, कॉन्टेक्स्ट फ़ाइलें, व्यक्तित्व, शेयरिंग और एक्सेस |
| Providers | Anthropic, OpenAI, OpenRouter, Gemini, DeepSeek, +15 और |
| Channels | Telegram, Discord, Slack, Feishu, Zalo, WhatsApp, WebSocket |
| Agent Teams | टीमें, टास्क बोर्ड, मैसेजिंग, डेलीगेशन और हैंडऑफ |
| Advanced | कस्टम टूल्स, MCP, स्किल्स, Cron, सैंडबॉक्स, हुक, RBAC |
| Deployment | Docker Compose, डेटाबेस, सुरक्षा, ऑब्ज़र्वेबिलिटी, Tailscale |
| Reference | CLI कमांड, REST API, WebSocket प्रोटोकॉल, एनवायरनमेंट वेरिएबल |
परीक्षण
go test ./... # Unit tests
go test -v ./tests/integration/ -timeout 120s # Integration tests (requires running gateway)
प्रोजेक्ट स्थिति
विस्तृत फीचर स्थिति के लिए CHANGELOG.md देखें, जिसमें शामिल है कि प्रोडक्शन में क्या परीक्षण किया गया है और क्या अभी भी प्रगति में है।
आभार
GoClaw मूल OpenClaw प्रोजेक्ट पर निर्मित है। हम उस आर्किटेक्चर और दृष्टिकोण के आभारी हैं जिसने इस Go पोर्ट को प्रेरित किया।
लाइसेंस
MIT



