多租户 AI 代理平台

用 Go 构建的多智能体 AI 网关。支持 20 多家大模型提供商、7 种消息渠道，采用多租户 PostgreSQL 数据库。
单个二进制文件，经过生产环境验证，能够为您编排管理各类智能体。

文档 • 快速入门 • Twitter / X

这是 OpenClaw 的 Go 版本，具备更强的安全性、多租户 PostgreSQL 支持以及生产级可观测性。

🌐 语言： 🇨🇳 简体中文 · 🇯🇵 日本語 · 🇰🇷 한국어 · 🇻🇳 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 · 🇬🇷 Ελληνικά · 🇭 Hungarian · 🇫 Finnish · 🇩 Danish · 🇳 Norwegian

与众不同之处

• 代理团队与编排 — 团队共享任务看板，支持代理间同步/异步委派，以及混合式代理发现机制。
• 多租户 PostgreSQL — 每位用户独立的工作空间、上下文文件，加密的 API 密钥（AES-256-GCM），会话隔离。
• 单个二进制文件 — 静态编译的 Go 二进制文件约 25 MB，无需 Node.js 运行时，启动时间不到 1 秒，可在 5 美元的 VPS 上运行。
• 生产级安全 — 五层权限体系（网关认证 → 全局工具策略 → 每个代理 → 每个渠道 → 仅所有者访问），并配备限流、提示注入检测、SSRF 防护、Shell 拒绝模式及 AES-256-GCM 加密。
• 20+ 大模型提供商 — Anthropic（原生 HTTP+SSE，支持提示缓存）、OpenAI、OpenRouter、Groq、DeepSeek、Gemini、Mistral、xAI、MiniMax、Cohere、Perplexity、DashScope、Bailian、Zai、Ollama、Ollama Cloud、Claude CLI、Codex、ACP，以及任何兼容 OpenAI 的接口。
• 7 种消息渠道 — Telegram、Discord、Slack、Zalo OA、Zalo Personal、飞书/Lark、WhatsApp。
• 扩展思考功能 — 针对不同提供商提供专属思考模式（如 Anthropic 的预算 Token、OpenAI 的推理精力、DashScope 的思考预算），并支持流式处理。
• 心跳系统 — 通过 HEARTBEAT.md 检查清单定期进行代理签到，具备“正常则抑制”功能、活跃时段设置、重试逻辑及渠道投递机制。
• 调度与 Cron — 支持 at、every 和 Cron 表达式，用于自动化代理任务，并按车道实现并发控制。
• 可观测性 — 内置大模型调用追踪，包含跨度和提示缓存指标；可选 OpenTelemetry OTLP 导出。

爪子生态

	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)
内存（空闲）	> 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 集成	— (使用 ACP)	—	—	✅ (stdio/SSE/streamable-http)
代理团队	—	—	—	✅ 任务看板 + 邮箱
安全加固	✅ (SSRF、路径遍历、注入)	✅ (沙盒、速率限制、注入、配对)	基础（工作空间限制、禁止执行）	✅ 5 层防御
OTel 可观测性	✅ (可选扩展)	✅ (Prometheus + OTLP)	—	✅ OTLP (可选构建标签)
提示词缓存	—	—	—	✅ Anthropic + OpenAI 兼容
知识图谱	—	—	—	✅ LLM 抽取 + 遍历
技能系统	✅ 嵌入/语义	✅ SKILL.md + TOML	✅ 基础	✅ BM25 + pgvector 混合
基于通道的调度器	✅	有限并发	—	✅ (主/子代理/团队/定时任务)
消息通道	37+	15+	10+	7+
伴侣应用	macOS、iOS、Android	Python SDK	—	Web 控制台 + 桌面应用
实时画布/语音	✅ (A2UI + TTS/STT)	—	语音转文字	TTS (4 个提供商)
LLM 提供商	10+	8 原生 + 29 兼容	13+	20+
每用户工作空间	✅ (基于文件)	—	—	✅ (PostgreSQL)
加密秘钥	— (仅环境变量)	✅ ChaCha20-Poly1305	— (明文 JSON)	✅ AES-256-GCM 存储在数据库中

桌面版（GoClaw Lite）

一款用于本地 AI 代理的原生桌面应用——无需 Docker、无需 PostgreSQL、无需基础设施。

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

包含内容

• 单一原生应用（Wails v2 + React），约 30 MB
• SQLite 数据库（无需配置）
• 与代理聊天（流式传输、工具、媒体、文件附件）
• 代理管理（最多 5 个）、提供商配置、MCP 服务器、技能、定时任务
• 团队任务，带看板和实时更新
• 自动从 GitHub Releases 更新

Lite 与标准对比

特性	Lite（桌面）	Standard（服务器）
代理数量	最多 5 个	无限制
团队数量	最多 1 个（5 名成员）	无限制
数据库	SQLite（本地）	PostgreSQL
搜索功能	FTS5 文本搜索	pgvector 语义搜索
通道	—	Telegram、Discord、Slack、Zalo、飞书、WhatsApp
知识图谱	—	完整
RBAC/多租户	—	完整
自动更新	GitHub Releases	Docker / 二进制

从源码构建

# 前置条件：Go 1.26+、pnpm、Wails CLI（go install github.com/wailsapp/wails/v2/cmd/wails@latest）
make desktop-build                    # 构建 .app（macOS）或 .exe（Windows）
make desktop-dmg VERSION=0.1.0        # 创建 .dmg 安装包（仅 macOS）
make desktop-dev                      # 开发模式，支持热重载

桌面版发布

桌面版采用独立版本号，标签为 lite-v*：

git tag lite-v0.1.0 && git push origin lite-v0.1.0
# → GitHub Actions 会构建 macOS（.dmg + .tar.gz）+ Windows（.zip）
# → 生成包含所有资产的 GitHub Release

架构

快速开始

前置条件： 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

注意： 默认分支是 dev（开发中）。如需克隆稳定版分支，请使用 -b main。

使用 Docker

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

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

# Web 控制台位于 http://localhost:18790（内置）
# 健康检查：curl http://localhost:18790/health

# 可选：单独使用 nginx 进行自定义 SSL/反向代理

# make up WITH_WEB_NGINX=1  → 仪表板地址：http://localhost:3000

make up 命令会创建一个 Docker 网络，从 Git 标签中引入正确版本，构建并启动所有服务，并自动执行数据库迁移。

常用命令：

make up                # 启动所有服务（构建 + 迁移）
make down              # 停止所有服务
make logs              # 实时查看日志（goclaw 服务）
make reset             # 清除数据卷并从头重建

可选服务 — 可通过 WITH_* 标志启用：

标志	服务	功能描述
WITH_BROWSER=1	无头 Chrome	启用 browser 工具，用于网页抓取、截图和自动化
WITH_OTEL=1	Jaeger	OpenTelemetry 跟踪 UI，用于调试 LLM 调用及延迟
WITH_SANDBOX=1	Docker 沙箱	隔离容器，用于运行来自智能体的不可信代码
WITH_TAILSCALE=1	Tailscale	通过 Tailscale 私有网络暴露网关
WITH_REDIS=1	Redis	基于 Redis 的缓存层

这些标志可以组合使用，并适用于所有命令：

# 启动时包含浏览器自动化和追踪功能
make up WITH_BROWSER=1 WITH_OTEL=1

# 停止所有服务，包括可选服务
make down WITH_BROWSER=1 WITH_OTEL=1

当设置了 GOCLAW_*_API_KEY 环境变量后，网关将自动完成初始化，无需交互式提示——它会检测提供商、执行迁移并填充默认数据。

Docker 镜像变体：

镜像	描述
latest	后端 + 内置 Web UI + Python（推荐）
latest-base	仅后端 API，无 Web UI，无运行时环境
latest-full	所有运行时环境及技能依赖项已预装
latest-otel	最新版本 + OpenTelemetry 跟踪
goclaw-web	独立的 Nginx + React 单页应用（用于自定义反向代理）

对于自定义构建（如 Tailscale 或 Redis）：docker build --build-arg ENABLE_TSNET=true ... 更多详情请参阅部署指南。

更新

Docker

docker compose pull && docker compose up -d

二进制文件（含内置 Web UI）

goclaw update --apply    # 下载、验证 SHA256 校验和、替换二进制文件并重启

Web 仪表板

打开“关于”对话框 → 点击“立即更新”（仅限管理员）。使用默认的 latest 镜像时，此更新将同时包含后端和 Web 仪表板。

多智能体编排

GoClaw 支持智能体团队及智能体间的委派机制——每个智能体都拥有独立的身份、工具、LLM 提供商和上下文文件。

智能体委派

模式	工作方式	适用场景
同步	智能体 A 请求智能体 B，并等待其回复	快速查询、事实核查
异步	智能体 A 请求智能体 B 后继续工作，B 在稍后通知结果	长时间任务、报告、深度分析

智能体之间通过明确的权限链接进行通信，支持方向控制（出站、入站、双向）以及单个链接和单个智能体层面的并发限制。

智能体团队

• 共享任务板 — 创建、认领、完成任务，并可通过 blocked_by 依赖关系搜索任务。
• 工具：team_tasks 用于任务管理，spawn 用于子智能体编排。

关于委派细节、权限链接及并发控制，请参阅智能体团队文档。

内置工具

工具	组别	描述
read_file	fs	读取文件内容（支持虚拟文件系统路由）
write_file	fs	写入或创建文件
edit_file	fs	对现有文件进行定向编辑
list_files	fs	列出目录内容
search	fs	按模式搜索文件内容
glob	fs	根据 glob 模式查找文件
exec	runtime	执行 shell 命令（需经过审批流程）
web_search	web	网络搜索（Brave、DuckDuckGo）
web_fetch	web	获取并解析网页内容
memory_search	memory	搜索长期记忆（FTS + 向量）
memory_get	memory	检索记忆条目
skill_search	—	搜索技能（BM25 + 嵌入混合模型）
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、供应商链）
read_image	media	图像分析
read_audio	media	音频转录与分析
read_video	media	视频分析
message	messaging	向频道发送消息
tts	—	文本转语音合成
spawn	—	派生一个子代理
subagents	sessions	控制正在运行的子代理
team_tasks	teams	共享任务板（列出、创建、认领、完成、搜索）
sessions_list	sessions	列出活跃会话
sessions_history	sessions	查看会话历史
sessions_send	sessions	向会话发送消息
sessions_spawn	sessions	派生一个新的会话
session_status	sessions	检查会话状态
cron	automation	定时任务的调度与管理
gateway	automation	网关管理
browser	ui	浏览器自动化（导航、点击、输入、截图）
announce_queue	automation	异步结果通知（用于异步委派）

文档

完整文档请访问 docs.goclaw.sh — 或浏览源码：goclaw-docs/

版块	主题
入门	安装、快速开始、配置、Web 控制台导览
核心概念	代理循环、会话、工具、记忆、多租户
代理	创建代理、上下文文件、个性设置、共享与访问
提供商	Anthropic、OpenAI、OpenRouter、Gemini、DeepSeek，以及另外15家以上
渠道	Telegram、Discord、Slack、飞书、Zalo、WhatsApp、WebSocket
代理团队	团队、任务板、消息传递、委派与交接
高级功能	自定义工具、MCP、技能、Cron、沙箱、钩子、RBAC
部署	Docker Compose、数据库、安全、可观ability、Tailscale
参考	CLI 命令、REST API、WebSocket 协议、环境变量

测试

go test ./...                                    # 单元测试
go test -v ./tests/integration/ -timeout 120s    # 集成测试（需要运行网关）

项目状态

详细的功能状态，请参阅 CHANGELOG.md，其中包含已在生产环境中测试过的内容以及仍在开发中的内容。

致谢

GoClaw 是基于原始的 OpenClaw 项目构建的。我们感谢其架构和愿景为本次 Go 语言移植提供了灵感。

许可证

CC BY-NC 4.0 — 知识共享署名-非商业性使用 4.0 国际许可协议

GoClaw 快速上手指南

GoClaw 是一个基于 Go 语言构建的多租户 AI 智能体网关平台。它支持 20+ 大模型提供商、7 种消息渠道，具备生产级的安全性、可观测性以及单二进制部署的便捷性。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统: Linux, macOS 或 Windows (推荐 Linux 服务器或 macOS 开发)
• Go 版本: Go 1.26+
• 数据库: PostgreSQL 18 (需安装 pgvector 扩展以支持向量搜索)
• 可选工具: Docker & Docker Compose (用于容器化部署)

提示: 国内用户若拉取 GitHub 源码较慢，可使用镜像加速： git clone https://ghp.ci/https://github.com/nextlevelbuilder/goclaw.git

安装步骤

您可以选择从源码编译或使用 Docker 进行部署。

方式一：从源码编译 (推荐开发者)

1. 克隆仓库

   # 克隆稳定分支 (main)
   git clone -b main https://github.com/nextlevelbuilder/goclaw.git && cd goclaw
   

2. 编译构建

   make build
   

3. 初始化配置 运行交互式设置向导生成环境变量文件：

   ./goclaw onboard
   

4. 启动服务

   source .env.local && ./goclaw
   

方式二：使用 Docker 部署 (推荐生产环境)

1. 生成环境变量 运行脚本自动生成包含安全密钥的 .env 文件：

   chmod +x prepare-env.sh && ./prepare-env.sh
   

2. 配置 API Key 编辑生成的 .env 文件，至少填入一个大模型提供商的 Key (例如 GOCLAW_ANTHROPIC_API_KEY 或 GOCLAW_OPENAI_API_KEY)。

3. 启动服务

   make up
   

   该命令会自动创建网络、构建镜像、执行数据库迁移并启动所有服务。

4. 访问仪表盘 启动成功后，在浏览器访问：http://localhost:18790

基本使用

启动完成后，您可以通过以下方式开始使用 GoClaw：

1. 访问 Web 仪表盘

打开浏览器访问 http://localhost:18790 (Docker 部署) 或配置的本地端口。

• 配置提供商: 在设置中添加您的 LLM API Keys。
• 创建智能体: 定义智能体的角色、系统提示词及可用工具。
• 组建团队: 利用任务看板 (Task Board) 功能，创建多智能体协作团队，实现任务自动分发与协同。

2. 通过 API 调用

GoClaw 提供兼容 OpenAI 格式的 API 接口。以下是一个简单的 curl 调用示例：

curl http://localhost:18790/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "your-agent-name",
    "messages": [{"role": "user", "content": "你好，请介绍下你自己"}]
  }'

3. 桌面版体验 (GoClaw Lite)

如果您希望在本地无需数据库和 Docker 的情况下快速体验，可安装桌面版：

• 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
  

桌面版内置 SQLite 数据库，支持最多 5 个智能体，适合个人本地开发与测试。