Viet TranandGitHub
52c67d6d92
- Add internal/webui/ package with //go:build embedui tag for optional SPA embedding (handler.go serves static files with SPA fallback) - Add internal/version/ shared semver comparison (DRY: extracted from gateway/update_check.go and updater/updater.go) - Enhance UpdateChecker: release notes, ETag caching, filter lite-v* tags - Add web UI build stage to Dockerfile with ENABLE_EMBEDUI build arg - Simplify CI: 7 Docker variants → 4 (base, latest, full, otel) - Add SHA256 checksums job to release workflow - Add Makefile build-full target (embeds web UI in Go binary) - Default make up now embeds web UI (no separate nginx needed) - Add WITH_WEB_NGINX=1 flag for optional nginx reverse proxy - Update README + 30 translated READMEs: make up, port 18790 - Update docker-compose comments and prepare-env.sh - About dialog: show release notes with markdown rendering - Health card: amber badge for available updates BREAKING: Default Docker setup no longer requires selfservice overlay. Web dashboard served at :18790 (same port as API).
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.
Belgelendirme • Hızlı Başlangıç • Twitter / X
GoClaw, LLM'leri araçlarınıza, kanallarınıza ve verilerinize bağlayan çok ajanlı bir yapay zeka ağ geçididir — sıfır çalışma zamanı bağımlılığıyla tek bir Go ikili dosyası olarak dağıtılır. 20'den fazla LLM sağlayıcısında tam çok kiracılı izolasyonla ajan ekiplerini ve ajanlar arası devri yönetir.
OpenClaw projesinin, geliştirilmiş güvenlik, çok kiracılı PostgreSQL ve üretim düzeyinde gözlemlenebilirlik ile yazılmış bir Go portudur.
🌐 Diller: 🇺🇸 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
Farkı Yaratan Özellikler
- Ajan Ekipleri ve Orkestrasyon — Paylaşılan görev panoları, ajanlar arası devir (senkron/asenkron) ve hibrit ajan keşifiyle ekipler
- Çok Kiracılı PostgreSQL — Kullanıcı başına çalışma alanları, kullanıcı başına bağlam dosyaları, şifreli API anahtarları (AES-256-GCM), izole oturumlar
- Tek İkili Dosya — ~25 MB statik Go ikili dosyası, Node.js çalışma zamanı yok, <1 saniye başlatma, 5 dolarlık bir VPS üzerinde çalışır
- Üretim Güvenliği — 5 katmanlı izin sistemi (ağ geçidi kimlik doğrulaması → genel araç politikası → ajan başına → kanal başına → yalnızca sahip) ile hız sınırlama, komut enjeksiyonu tespiti, SSRF koruması, kabuk reddetme desenleri ve AES-256-GCM şifreleme
- 20'den Fazla LLM Sağlayıcısı — Anthropic (istem önbellekleme ile yerel HTTP+SSE), OpenAI, OpenRouter, Groq, DeepSeek, Gemini, Mistral, xAI, MiniMax, Cohere, Perplexity, DashScope, Bailian, Zai, Ollama, Ollama Cloud, Claude CLI, Codex, ACP ve OpenAI uyumlu herhangi bir uç nokta
- 7 Mesajlaşma Kanalı — Telegram, Discord, Slack, Zalo OA, Zalo Personal, Feishu/Lark, WhatsApp
- Extended Thinking — Akış desteğiyle sağlayıcı başına düşünme modu (Anthropic bütçe tokeni, OpenAI muhakeme çabası, DashScope düşünme bütçesi)
- Heartbeat — Sessizlik-başarı modunda, aktif saatler, yeniden deneme mantığı ve kanal teslimiyle HEARTBEAT.md kontrol listeleri üzerinden periyodik ajan bildirimleri
- Zamanlama ve Cron — Şerit tabanlı eşzamanlılıkla otomatikleştirilmiş ajan görevleri için
at,everyve cron ifadeleri - Gözlemlenebilirlik — Aralıklar ve istem önbellek metrikleriyle yerleşik LLM çağrı izleme, isteğe bağlı OpenTelemetry OTLP dışa aktarma
Claw Ekosistemi
| OpenClaw | ZeroClaw | PicoClaw | GoClaw | |
|---|---|---|---|---|
| Dil | TypeScript | Rust | Go | Go |
| İkili dosya boyutu | 28 MB + Node.js | 3.4 MB | ~8 MB | ~25 MB (temel) / ~36 MB (+ OTel) |
| Docker imajı | — | — | — | ~50 MB (Alpine) |
| RAM (boşta) | > 1 GB | < 5 MB | < 10 MB | ~35 MB |
| Başlatma | > 5 s | < 10 ms | < 1 s | < 1 s |
| Hedef donanım | $599+ Mac Mini | $10 uç | $10 uç | $5 VPS+ |
| Özellik | OpenClaw | ZeroClaw | PicoClaw | GoClaw |
|---|---|---|---|---|
| Çok kiracılı (PostgreSQL) | — | — | — | ✅ |
| MCP entegrasyonu | — (ACP kullanır) | — | — | ✅ (stdio/SSE/streamable-http) |
| Ajan ekipleri | — | — | — | ✅ Görev panosu + posta kutusu |
| Güvenlik sertleştirme | ✅ (SSRF, yol geçişi, enjeksiyon) | ✅ (kum havuzu, hız sınırı, enjeksiyon, eşleştirme) | Temel (çalışma alanı kısıtla, exec reddet) | ✅ 5 katmanlı savunma |
| OTel gözlemlenebilirlik | ✅ (isteğe bağlı uzantı) | ✅ (Prometheus + OTLP) | — | ✅ OTLP (isteğe bağlı derleme etiketi) |
| İstem önbellekleme | — | — | — | ✅ Anthropic + OpenAI uyumlu |
| Bilgi grafiği | — | — | — | ✅ LLM çıkarımı + geçiş |
| Yetenek sistemi | ✅ Gömme/anlamsal | ✅ SKILL.md + TOML | ✅ Temel | ✅ BM25 + pgvector hibrit |
| Şerit tabanlı zamanlayıcı | ✅ | Sınırlı eşzamanlılık | — | ✅ (main/subagent/team/cron) |
| Mesajlaşma kanalları | 37+ | 15+ | 10+ | 7+ |
| Yardımcı uygulamalar | macOS, iOS, Android | Python SDK | — | Web panosu |
| Canlı Tuval / Ses | ✅ (A2UI + TTS/STT) | — | Ses transkripsiyonu | TTS (4 sağlayıcı) |
| LLM sağlayıcıları | 10+ | 8 yerel + 29 uyumlu | 13+ | 20+ |
| Kullanıcı başına çalışma alanları | ✅ (dosya tabanlı) | — | — | ✅ (PostgreSQL) |
| Şifreli gizli bilgiler | — (yalnızca ortam değişkenleri) | ✅ ChaCha20-Poly1305 | — (düz metin JSON) | ✅ DB'de AES-256-GCM |
Mimari
Hızlı Başlangıç
Önkoşullar: Go 1.26+, pgvector ile PostgreSQL 18, Docker (isteğe bağlı)
Kaynaktan
git clone https://github.com/nextlevelbuilder/goclaw.git && cd goclaw
make build
./goclaw onboard # Etkileşimli kurulum sihirbazı
source .env.local && ./goclaw
Docker ile
# Otomatik oluşturulan gizli bilgilerle .env oluştur
chmod +x prepare-env.sh && ./prepare-env.sh
# .env dosyasına en az bir GOCLAW_*_API_KEY ekleyin, ardından:
make up
# Web Panosu: http://localhost:18790
# Sağlık kontrolü: curl http://localhost:18790/health
GOCLAW_*_API_KEY ortam değişkenleri ayarlandığında, ağ geçidi etkileşimli istem olmadan otomatik olarak katılır — sağlayıcıyı algılar, migrasyonları çalıştırır ve varsayılan verileri yerleştirir.
Derleme varyantları (OTel, Tailscale, Redis), Docker imaj etiketleri ve compose katmanları için Dağıtım Kılavuzu sayfasına bakın.
Çok Ajanlı Orkestrasyon
GoClaw, ajan ekiplerini ve ajanlar arası devri destekler — her ajan kendi kimliği, araçları, LLM sağlayıcısı ve bağlam dosyalarıyla çalışır.
Ajan Devri
| Mod | Nasıl çalışır | En iyi kullanım |
|---|---|---|
| Senkron | A Ajanı, B Ajanına sorar ve yanıtı bekler | Hızlı sorgular, gerçek doğrulama |
| Asenkron | A Ajanı, B Ajanına sorar ve devam eder. B daha sonra bildirir | Uzun görevler, raporlar, derin analiz |
Ajanlar, yön kontrolü (outbound, inbound, bidirectional) ve hem bağlantı başına hem de ajan başına eşzamanlılık sınırlarıyla açık izin bağlantıları üzerinden iletişim kurar.
Ajan Ekipleri
- Paylaşılan görev panosu —
blocked_bybağımlılıklarıyla görev oluşturma, talep etme, tamamlama ve arama - Ekip posta kutusu — Doğrudan eşler arası mesajlaşma ve yayınlar
- Araçlar: Görev yönetimi için
team_tasks, posta kutusu içinteam_message
Devir ayrıntıları, izin bağlantıları ve eşzamanlılık kontrolü için Ajan Ekipleri belgelerine bakın.
Yerleşik Araçlar
| Araç | Grup | Açıklama |
|---|---|---|
read_file |
fs | Dosya içeriğini oku (sanal FS yönlendirmesiyle) |
write_file |
fs | Dosya yaz/oluştur |
edit_file |
fs | Mevcut dosyalara hedefli düzenlemeler uygula |
list_files |
fs | Dizin içeriğini listele |
search |
fs | Dosya içeriğini desene göre ara |
glob |
fs | Glob deseniyle dosya bul |
exec |
runtime | Kabuk komutları çalıştır (onay iş akışıyla) |
web_search |
web | Web'de ara (Brave, DuckDuckGo) |
web_fetch |
web | Web içeriğini getir ve ayrıştır |
memory_search |
memory | Uzun süreli bellekte ara (FTS + vektör) |
memory_get |
memory | Bellek girdilerini al |
skill_search |
— | Yetenekleri ara (BM25 + gömme hibrit) |
knowledge_graph_search |
memory | Varlıkları ara ve bilgi grafiği ilişkilerinde gezin |
create_image |
media | Görüntü oluşturma (DashScope, MiniMax) |
create_audio |
media | Ses oluşturma (OpenAI, ElevenLabs, MiniMax, Suno) |
create_video |
media | Video oluşturma (MiniMax, Veo) |
read_document |
media | Belge okuma (Gemini File API, sağlayıcı zinciri) |
read_image |
media | Görüntü analizi |
read_audio |
media | Ses transkripsiyonu ve analizi |
read_video |
media | Video analizi |
message |
messaging | Kanallara mesaj gönder |
tts |
— | Metinden Konuşmaya sentezi |
spawn |
— | Bir alt ajan başlat |
subagents |
sessions | Çalışan alt ajanları yönet |
team_tasks |
teams | Paylaşılan görev panosu (listele, oluştur, talep et, tamamla, ara) |
team_message |
teams | Ekip posta kutusu (gönder, yayınla, oku) |
sessions_list |
sessions | Aktif oturumları listele |
sessions_history |
sessions | Oturum geçmişini görüntüle |
sessions_send |
sessions | Bir oturuma mesaj gönder |
sessions_spawn |
sessions | Yeni bir oturum başlat |
session_status |
sessions | Oturum durumunu kontrol et |
cron |
automation | Cron işlerini zamanla ve yönet |
gateway |
automation | Ağ geçidi yönetimi |
browser |
ui | Tarayıcı otomasyonu (gezin, tıkla, yaz, ekran görüntüsü al) |
announce_queue |
automation | Asenkron sonuç bildirimi (asenkron devirler için) |
Belgelendirme
Tam belgelendirme docs.goclaw.sh adresinde — veya kaynağa goclaw-docs/ üzerinden göz atın.
| Bölüm | Konular |
|---|---|
| Başlarken | Kurulum, Hızlı Başlangıç, Yapılandırma, Web Panosu Turu |
| Temel Kavramlar | Ajan Döngüsü, Oturumlar, Araçlar, Bellek, Çok Kiracılılık |
| Ajanlar | Ajan Oluşturma, Bağlam Dosyaları, Kişilik, Paylaşım ve Erişim |
| Sağlayıcılar | Anthropic, OpenAI, OpenRouter, Gemini, DeepSeek, +15 daha |
| Kanallar | Telegram, Discord, Slack, Feishu, Zalo, WhatsApp, WebSocket |
| Ajan Ekipleri | Ekipler, Görev Panosu, Mesajlaşma, Devir ve Teslim |
| Gelişmiş | Özel Araçlar, MCP, Yetenekler, Cron, Kum Havuzu, Hook'lar, RBAC |
| Dağıtım | Docker Compose, Veritabanı, Güvenlik, Gözlemlenebilirlik, Tailscale |
| Referans | CLI Komutları, REST API, WebSocket Protokolü, Ortam Değişkenleri |
Test
go test ./... # Birim testleri
go test -v ./tests/integration/ -timeout 120s # Entegrasyon testleri (çalışan ağ geçidi gerektirir)
Proje Durumu
Üretimde test edilenler ve hâlâ devam edenler dahil ayrıntılı özellik durumu için CHANGELOG.md dosyasına bakın.
Teşekkürler
GoClaw, orijinal OpenClaw projesi üzerine inşa edilmiştir. Bu Go portuna ilham veren mimari ve vizyona minnettarız.
Lisans
MIT