ClawGo 🚀

A long-running AI Agent written in Go: lightweight, auditable, and multi-channel ready.

中文

---

What It Does ✨

• 🤖 Local chat mode: clawgo agent
• 🌐 Gateway service mode: clawgo gateway
• 💬 Multi-channel support: Telegram / Feishu / Discord / WhatsApp / QQ / DingTalk / MaixCam
• 🧰 Tool calling, skills, and sub-task collaboration
• 🧠 Autonomous tasks (queue, audit, conflict locks)
• 📊 WebUI for visibility (Chat / Logs / Config / Cron / Tasks / EKG)

---

Concurrency Scheduling (New) ⚙️

• 🧩 A composite message is automatically split into sub-tasks
• 🔀 Within the same session: non-conflicting tasks run in parallel
• 🔒 Within the same session: conflicting tasks run serially (to avoid collisions)
• 🏷️ resource_keys are inferred automatically by default (no manual input needed)

---

Memory + EKG Enhancements (New) 🧠

• 📚 Before each sub-task runs, related memory is fetched via memory_search
• 🚨 EKG + task-audit are used to detect repeated error-signature risks
• ⏱️ High-risk tasks include retry-backoff hints to reduce repeated failures

---

Telegram Streaming Rendering (New) 💬

• 🧷 Stream flushes happen at syntax-safe boundaries to reduce formatting jitter
• ✅ A final convergence render is applied when streaming ends for stable layout

---

3-Minute Quick Start ⚡

1) Install

curl -fsSL https://raw.githubusercontent.com/YspCoder/clawgo/main/install.sh | bash

2) Initialize

clawgo onboard

3) Configure model/proxy

clawgo login

4) Check status

clawgo status

5) Start using it

Local mode:

clawgo agent
clawgo agent -m "Hello"

Gateway mode:

# Register + enable systemd service
clawgo gateway
clawgo gateway start
clawgo gateway status

# Or run in foreground
clawgo gateway run

---

WebUI 🖥️

Open:

http://<host>:<port>/webui?token=<gateway.token>

Main pages:

• Dashboard
• Chat
• Logs
• Skills
• Config
• Cron
• Nodes
• Memory
• Task Audit
• Tasks
• EKG

---

Common Commands 📌

clawgo onboard
clawgo login
clawgo status
clawgo agent [-m "..."]
clawgo gateway [run|start|stop|restart|status]
clawgo config set|get|check|reload
clawgo channel test ...
clawgo cron ...
clawgo skills ...
clawgo uninstall [--purge] [--remove-bin]

---

Build & Release 🛠️

Build all default targets:

make build-all

Linux slim build:

make build-linux-slim

Custom target matrix:

make build-all BUILD_TARGETS="linux/amd64 linux/arm64 darwin/arm64 windows/amd64"

Package + checksums:

make package-all

Outputs:

• build/*.tar.gz (Linux/macOS)
• build/*.zip (Windows)
• build/checksums.txt

---

GitHub Release Automation 📦

Built-in workflow: .github/workflows/release.yml

Triggers:

• Tag push (e.g. v0.0.2)
• Manual workflow_dispatch

Example:

git tag v0.0.2
git push origin v0.0.2

---

Config Notes ⚙️

• Strict JSON validation (unknown fields fail fast)
• Supports hot reload: clawgo config reload
• Auto rollback if hot reload fails

---

Production Tips ✅

• Enable channel dedupe windows
• Monitor Task Audit and EKG regularly
• Use gateway mode for long-running workloads

---

License 📄

See LICENSE in this repository.