GoClaw：多租户 AI Agent 平台

项目简介

GoClaw 是用 Go 重写的 OpenClaw，定位为多租户 AI Agent 平台与多智能体 AI 网关。它把模型接入、Agent 编排、记忆、知识库、消息渠道和安全治理收拢到一个静态二进制里：约 25 MB、无需 Node.js 运行时、启动时间小于 1 秒，可跑在一台 5 美元的 VPS 上。

除服务端版本外，项目还提供桌面版 GoClaw Lite（Wails v2 + React，约 30 MB），使用本地 SQLite，不需要 Docker 与 PostgreSQL，适合在个人电脑上直接跑本地 Agent。

主要功能

• 8 阶段 Agent 流水线：context → history → prompt → think → act → observe → memory → summarize，阶段可插拔、始终执行
• 4 模式提示词系统：Full / Task / Minimal / None，支持分段开关、缓存边界优化与按会话解析模式
• 3 层记忆：Working（对话）→ Episodic（会话摘要）→ Semantic（知识图谱），支持 L0/L1/L2 渐进加载
• Knowledge Vault 知识库：文档注册表、[[wikilinks]] 双链、FTS + pgvector 混合检索、文件系统同步
• Agent 团队与编排：共享任务看板、Agent 间同步/异步委派、auto / explicit / manual 三种编排模式
• 自我进化：指标 → 建议 → 在护栏约束下自动调整，让 Agent 优化自身沟通风格
• 多租户 PostgreSQL：每用户独立工作区与上下文文件、API Key 加密（AES-256-GCM）、RBAC、会话隔离
• 20+ LLM 提供商：Anthropic（原生 HTTP+SSE、提示词缓存）、OpenAI、OpenRouter、Requesty、Groq、DeepSeek、Gemini、Mistral、xAI、MiniMax、DashScope、Claude CLI、Codex、ACP 以及任意 OpenAI 兼容端点
• 7 个消息渠道：Telegram、Discord、Slack、Zalo OA、Zalo Personal、飞书/Lark、WhatsApp
• 生产级安全：5 层权限系统、限流、提示词注入检测、SSRF 防护、AES-256-GCM 加密
• 可观测性：内置 LLM 调用链路追踪（span 与提示词缓存指标），可选 OpenTelemetry OTLP 导出

安装与使用

从源码运行

前提：Go 1.26+、PostgreSQL 18（含 pgvector）、Docker（可选）。

git clone -b main https://github.com/nextlevelbuilder/goclaw.git && cd goclaw
make build
./goclaw onboard        # 交互式安装向导
source .env.local && ./goclaw

使用 Docker

# 生成带自动密钥的 .env
chmod +x prepare-env.sh && ./prepare-env.sh

# 在 .env 中至少填入一个 GOCLAW_*_API_KEY，然后：
make up

make up 会创建 Docker 网络、按 git tag 嵌入版本号、构建并启动全部服务，并自动执行数据库迁移。Web Dashboard 默认在 http://localhost:18790，健康检查为 curl http://localhost:18790/health。

常用命令：

make up      # 启动全部服务（构建 + 迁移）
make down    # 停止全部服务
make logs    # 查看 goclaw 服务日志
make reset   # 清空卷并从头重建

可选服务通过 WITH_* 开关启用，可组合使用：

开关	服务	作用
WITH_BROWSER=1	无头 Chrome	启用 browser 工具做网页抓取、截图、自动化
WITH_OTEL=1	Jaeger	OpenTelemetry 追踪界面，调试 LLM 调用与延迟
WITH_SANDBOX=1	Docker 沙箱	在隔离容器中运行 Agent 产生的不受信代码
WITH_TAILSCALE=1	Tailscale	通过 Tailscale 私有网络暴露网关
WITH_REDIS=1	Redis	基于 Redis 的缓存层

make up WITH_BROWSER=1 WITH_OTEL=1

运维 CLI

主 goclaw 二进制也可查看本地或远程网关：

goclaw traces list --status error
goclaw traces get <trace-id> -o json
goclaw --server https://goclaw.example.com --token "$GOCLAW_GATEWAY_TOKEN" traces follow --session <session-key>

桌面版 GoClaw Lite

macOS：

curl -fsSL https://raw.githubusercontent.com/nextlevelbuilder/goclaw/main/scripts/install-lite.sh | bash

Windows（PowerShell）：

irm https://raw.githubusercontent.com/nextlevelbuilder/goclaw/main/scripts/install-lite.ps1 | iex

从源码构建桌面版（需要 Go 1.26+、pnpm、Wails CLI）：

make desktop-build                    # 构建 .app（macOS）或 .exe（Windows）
make desktop-dmg VERSION=0.1.0        # 生成 .dmg 安装包（仅 macOS）
make desktop-dev                      # 热重载开发模式

注意事项

• 仓库默认分支是 dev（活跃开发），克隆稳定版请使用 -b main。
• 使用 Docker 时若 Postgres 启动失败并提示端口 5432 被占用，可在 .env 中改用其他端口，例如 POSTGRES_PORT=5433。
• 设置了 GOCLAW_*_API_KEY 环境变量后，网关会自动完成初始化，无需交互式向导。
• Lite 桌面版与标准服务端的差异：Agent 上限 5 个（标准版不限）、团队上限 1 个共 5 名成员（标准版不限）、数据库为本地 SQLite（标准版为 PostgreSQL）、记忆检索为 FTS5 文本搜索（标准版为 pgvector 语义检索）、不支持消息渠道、知识图谱与 RBAC/多租户。
• 桌面版使用独立的 lite-v* 版本标签，从 GitHub Releases 自动更新。
• 项目采用 CC BY-NC 4.0 许可。

---

本作品整理自 GitHub 开源项目 nextlevelbuilder/goclaw，原作者 @nextlevelbuilder。中文介绍由 AI 根据项目 README 整理，以原仓库为准。