面向生产的 Go 原生 AI Agent Runtime，支持多 Agent 编排、WebUI、记忆、审计与断点恢复。
ClawGo 是一个以 Go 为主语言（97.1%）构建的 AI Agent 运行时框架，灵感来源于 nanobot（HKUDS），采用四层架构（Main Agent → Local Subagents → Runtime Store → WebUI），提供完整的多 Agent 协作闭环。
多 Agent 编排#
- 拓扑结构：统一组织 main agent / subagents / remote branches，内部协作流与用户对话通道分离，子代理执行过程可追踪但不污染用户主通道
- 默认协作流：
user → main → worker → main → user - 路由策略：
rules_first模式，支持关键词匹配分发到指定 subagent，可配置最大跳数（max_hops: 6）与粘性线程（sticky_thread_owner） - 通信模式：
mediated（中介模式），支持消息持久化、死信队列、TTL
持久化与可恢复性#
通过 subagent_runs.jsonl、subagent_events.jsonl、threads.jsonl、agent_messages.jsonl 实现全链路 run/event/thread/message 持久化，重启后可恢复进行中的 subagent run（断点续跑）。
上下文管理#
基于摘要的 Context Compaction，可配置触发消息数和保留近期消息数。
工具与 MCP 集成#
通过 tools.mcp 接入 stdio、http、streamable_http、sse 四种类型的 MCP Server，工具自动发现并注册为 mcp__<server>__<tool> 命名格式，支持 permission: workspace 或 permission: full 两级权限，支持安全工具列表的并行调用（tool_max_parallel_calls: 2）。
Provider 接入与认证#
支持 OpenAI、Codex、Anthropic、Gemini、Kimi、Qwen 等服务商。Hybrid 认证模式：API Key 优先 + OAuth 账号池自动切换（auth: "hybrid"）。
可观测性（WebUI）#
Dashboard 与 Agent 拓扑查看、节点/日志/记忆/运行态检查、OAuth 账号管理。WebUI 为只读状态展示，不写入运行时配置。
工程化配置#
Agent Prompt 推荐独立为 agents/<name>/AGENT.md 文件，通过 system_prompt_file 指向。Subagent 在 config.json → agents.subagents 中声明，每个拥有独立的 session、memory namespace、工具 allowlist、运行时参数。路由规则在 agents.router.rules 中配置，MCP Server 在 tools.mcp.servers 中配置。
安装与部署#
curl -fsSL https://raw.githubusercontent.com/YspCoder/clawgo/main/install.sh | bash
clawgo onboard
clawgo provider list
clawgo provider use openai/gpt-5.4
clawgo provider configure
启动模式：clawgo agent（交互模式）、clawgo gateway run（网关模式）、make dev（开发模式）。WebUI 通过 http://<host>:<port>/?token=<gateway.token> 访问。仓库提供 Dockerfile 与 docker-compose.yml 支持容器化部署。
待确认事项#
- 分布式节点支持在 README 标题与 GitHub description 中提及，但正文未详细展开具体实现方式
- 官网 clawgo.dev 当前内容较少，完整文档可能仍在建设中
- Remote Branches 与 Local Subagents 的区别、Memory 存储后端细节待进一步确认