agentrq

手机上随时盯住你的 AI 智能体,实时对话、审批、纠偏

开源 🏷️定价信息待确认 ⏳ 访问状态待核验 智能体 🍴 复刻 85 🐛 待处理 2 👀 关注 1
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 1162
维护状态 活跃
是否开源 开源
定价模式 🏷️定价信息待确认

项目预览

agentrq 项目界面预览图
图片来源:项目官网

项目数据

分类智能体
开发团队agentrq
定价模式🏷️定价信息待确认
价格说明自托管开源,定价信息待确认
访问状态⏳ 访问状态待核验
是否开源是
开源协议AGPL-3.0
主要语言Go
技术栈/模型acp-client,acp-gateway,agentic-ai,agentic-workflow,agents,ai-memory,claude-code,claude-plugin,dsh-plugin,gemini-cli-extension,hermes-agent,mcp,mcp-memory,mcp-server,mcp-skills,opencode,si-agents,task,task-manager,task-scheduler
GitHub 星标★ 1162
上线时间2026-03-24 00:00:00
代码更新2026-10-21
仓库体积20.6 MB
本站数据更新2026-10-22
维护状态活跃
收录时间2026-10-22
浏览次数0

项目介绍

AgentRQ 是一个自托管的人在回路(Human-in-the-loop)实时对话式任务管理器,专为 AI Agent 设计。它解决的核心问题是:当 Claude Code、Gemini CLI 等编码智能体长时间自主运行时,用户无法随时查看进度、介入决策或纠正方向。AgentRQ 通过 ACP(Agent Client Protocol)网关把智能体接入统一控制台,让你在手机、网页或桌面上实时对话、审批任务、下发指令,并保留 AI 记忆。它兼容你自己的 Claude 订阅,不依赖第三方托管,数据完全自主可控。项目用 Go 编写,提供 ACP 客户端与网关组件,可对接任何支持 ACP 的 agent harness,适合需要多端监控、实时干预和任务编排的开发者与团队。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-10-22 · 当前星标 ★ 1162

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

难度:进阶 约 30 分钟 部署方式:本地安装 7 步

环境要求

  • Go 与 Make(通过 Makefile 安装、启动全栈)
  • Node.js/npx(运行 @agentrq/acp-gateway 网关)
  • Google OAuth2 客户端 ID 与 Secret(登录认证用)
  • 项目根目录需有 .mcp.json 配置文件

安装与启动步骤

  1. 1安装全部依赖

    在仓库根目录执行,由 Makefile 统一拉取前后端依赖;需先克隆项目并进入目录。

    make install
  2. 2填写谷歌登录凭据

    编辑 backend/cmd/server/_config/base.yaml(或 development.yaml),填入 OAuth2 的 clientId 与 clientSecret。

  3. 3设置 JWT 密钥

    直接启动后端时需设置稳定随机值,至少 32 字符;用 make dev 开发模式可自动生成本地值。

    export AGENTRQ_AUTH_JWT_SECRET=agentrq-local-dev-secret-0123456789abcdef
  4. 4启动本地全栈

    用 Makefile 启动完整服务;开发模式缺少 JWT 变量时会生成并复用本地值。

    make dev
  5. 5准备 .mcp.json

    确保项目根目录存在 .mcp.json,Agent 通过它读取工作区状态并领取任务。

  6. 6登录 Agent

    首次运行会拉取 agent 并引导登录;Codex 在登录前不会开启会话。

    npx -y @agentrq/acp-gateway@latest --login --agent codex-acp
  7. 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

★ 13696 2026-08-09
.claude 开源

零配置让 Claude Code 技能全开,自动匹配资源干活

The Ultimate Claude Code Toolkit: 180 skills, 10 agents, 29 commands, 7 hooks, and 8···

★ 105 2026-08-09
opencode-mcp 开源

让任意 MCP 客户端直接调用 OpenCode 的 70 个 AI 工具

MCP server for OpenCode AI — 70 tools, 10 resources, 5 prompts. Use npx opencode-mc···

★ 153 2026-08-09
sotopia 开源

让 AI 在模拟社交场景中学会与人打交道

Sotopia: an Open-ended Social Learning Environment (ICLR 2024 spotlight)

★ 339 2026-08-09
pi-textbook 开源

15 步手写代码,从零构建你的 AI Agent。

《动手学 Pi》:沿 15 个真实 checkpoint 从零构建 Pi-style Agent

★ 1411 2026-08-09
openmelon 开源

让 AI 内容生产可复现、可追溯,像代码一样管理创作流程。

A content-creation agent runtime for reproducible multimodal production — projects,···

★ 89 2026-08-09
golembot 开源

把 AI 编码代理接入你的聊天工具,一处配置,随处使用

Any Agent × Any Provider × Anywhere. Connect Cursor, Claude Code, OpenCode, or Cod···

★ 323 2026-08-09
CORAL 开源

让编码智能体自主协作,自动完成科研任务

Open-source autoresearch powered by autonomous coding agents. Run Claude Code, OpenC···

★ 1090 2026-08-09