项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-22 · 当前星标 ★ 1162
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Go 与 Make(通过 Makefile 安装、启动全栈)
- Node.js/npx(运行 @agentrq/acp-gateway 网关)
- Google OAuth2 客户端 ID 与 Secret(登录认证用)
- 项目根目录需有 .mcp.json 配置文件
安装与启动步骤
-
1安装全部依赖
在仓库根目录执行,由 Makefile 统一拉取前后端依赖;需先克隆项目并进入目录。
make install -
2填写谷歌登录凭据
编辑 backend/cmd/server/_config/base.yaml(或 development.yaml),填入 OAuth2 的 clientId 与 clientSecret。
-
3设置 JWT 密钥
直接启动后端时需设置稳定随机值,至少 32 字符;用 make dev 开发模式可自动生成本地值。
export AGENTRQ_AUTH_JWT_SECRET=agentrq-local-dev-secret-0123456789abcdef -
4启动本地全栈
用 Makefile 启动完整服务;开发模式缺少 JWT 变量时会生成并复用本地值。
make dev -
5准备 .mcp.json
确保项目根目录存在 .mcp.json,Agent 通过它读取工作区状态并领取任务。
-
6登录 Agent
首次运行会拉取 agent 并引导登录;Codex 在登录前不会开启会话。
npx -y @agentrq/acp-gateway@latest --login --agent codex-acp -
7启动网关桥接
在 .mcp.json 所在目录运行,建立 Agent 与控制台的实时连接;退出登录用 --logout。
npx -y @agentrq/acp-gateway@latest --agent codex-acp
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
auth.google.clientId | 是 | Google OAuth2 客户端 ID,用于登录认证 | your-google-client-id |
auth.google.clientSecret | 是 | Google OAuth2 客户端密钥 | your-google-client-secret |
AGENTRQ_AUTH_JWT_SECRET | 是 | 后端 JWT 签名密钥,至少 32 字符且保持稳定 | agentrq-local-dev-secret-0123456789abcdef |
.mcp.json | 是 | 项目根目录的 MCP 配置,网关需在此目录启动 | .mcp.json |
如何确认成功
终端显示服务与网关正常启动,浏览器打开控制台登录后可看到任务看板;网关出现已登录的 agent 会话即成功。
常见问题
Q:必须填 Google OAuth2 凭据吗?
A:README 的配置步骤要求填写 clientId 与 clientSecret,否则登录认证无法通过。
Q:JWT 密钥可以随便填吗?
A:需为至少 32 字符的稳定随机值;用 make dev 开发模式时缺失会自动生成并复用本地值。
Q:网关启动提示找不到配置?
A:需在 .mcp.json 所在的项目根目录执行网关命令,否则无法读取工作区配置。
Q:Codex agent 需要额外参数吗?
A:不需要。README 说明 Codex 以 npm 包发布,npx 首次使用即拉取,无需 --allow-unverified-agent。
Q:想用 Docker 自托管怎么办?
A:README 未给具体命令,需参照仓库中的 SETUP.md 自托管指南获取 docker run 与环境变量说明。
注意事项
- Docker 自托管、生产部署的具体命令与环境变量见仓库 SETUP.md,README 未展开。
- AGENTRQ_AUTH_JWT_SECRET 必须保持稳定,变更会导致登录态失效。
- 退出登录时将 --login 换成 --logout 重新执行网关命令。
- README 节选未提供端口与访问地址,请以实际启动输出为准。
核心亮点
- 基于 ACP 协议做网关,能接入 Claude Code、Gemini CLI 等多种 harness,不锁定单一智能体
- 自托管部署,兼容用户自己的 Claude 订阅,对话与记忆数据不出本机
- 支持移动端、Web、桌面多端实时对话与任务审批,人在回路干预路径完整
不足之处
- 项目较新(约 1.1k 星),ACP 生态与插件体系仍在演进,接口可能变动
- 文档与社区规模相对有限,非 ACP 系智能体接入需自行适配
适用场景
- 开发者让 Claude Code 跑长任务时,用手机随时查看进度并批准下一步操作
- 团队自托管统一控制台,集中监控多个 AI 智能体的运行状态与对话记录
- 个人用户把 Gemini CLI 等编码智能体接入,在 Web 端实时纠偏和补充上下文
替代项目
OpenHands、AutoGen Studio、Langfuse
上一篇:Awesome-MCP-ZH
下一篇:FAROS
同类项目推荐
MiMo-Code
开源
让模型和智能体在编码中互相进化,提升开发效率
MiMo Code: Where Models and Agents Co-Evolve
.claude
开源
零配置让 Claude Code 技能全开,自动匹配资源干活
The Ultimate Claude Code Toolkit: 180 skills, 10 agents, 29 commands, 7 hooks, and 8···
opencode-mcp
开源
让任意 MCP 客户端直接调用 OpenCode 的 70 个 AI 工具
MCP server for OpenCode AI — 70 tools, 10 resources, 5 prompts. Use npx opencode-mc···
sotopia
开源
让 AI 在模拟社交场景中学会与人打交道
Sotopia: an Open-ended Social Learning Environment (ICLR 2024 spotlight)
pi-textbook
开源
15 步手写代码,从零构建你的 AI Agent。
《动手学 Pi》:沿 15 个真实 checkpoint 从零构建 Pi-style Agent
openmelon
开源
让 AI 内容生产可复现、可追溯,像代码一样管理创作流程。
A content-creation agent runtime for reproducible multimodal production — projects,···
golembot
开源
把 AI 编码代理接入你的聊天工具,一处配置,随处使用
Any Agent × Any Provider × Anywhere. Connect Cursor, Claude Code, OpenCode, or Cod···
awesome-agent-architecture
开源
从零到一,系统掌握AI智能体架构设计
Learn AI agents from scratch.
CORAL
开源
让编码智能体自主协作,自动完成科研任务
Open-source autoresearch powered by autonomous coding agents. Run Claude Code, OpenC···
