AgentRQ

这个 Agent 能做什么，适合哪些场景？

AgentRQ 是一个可自托管的人机协作与任务管理平台，由 Go/Fiber 后端、Vue 3/Vite 前端、工作区级 MCP 服务和全局 CoreMCP Supervisor 组成。人类可以拆分目标、分派任务并回复代理，代理则通过 MCP 获取任务、更新状态、创建任务、下载附件和发送消息。平台使用内部发布/订阅机制和 SSE，在仪表板与代理会话之间同步任务变更、消息和权限请求。数据通过 GORM 持久化到 SQLite，身份验证采用 Google OAuth2 和基于 JWT 的会话。除 Claude Code 的原生通道集成外，项目还提供面向 ACP 代理、OpenAI Codex、Gemini CLI 和 DeepSeek Harness 的网关或扩展，并支持 Docker 自托管。

每个工作区提供独立的 MCP URL 和令牌；代理通过 getWorkspace 读取工作区名称、使命和任务统计，通过 getTask 按 ID 查询任务，或领取下一个分配给自己的 notstarted 任务。代理可以调用 createTask 创建普通或带 cron_schedule 的周期任务，调用 updateTaskStatus 在 notstarted、ongoing、blocked 和 completed 之间推进状态，并用 reply 将消息实时发送到仪表板。downloadAttachment 用于按 ID 获取附件，而 notifications/claude/channel 会把人类对任务的交互通知给 Claude Code。对于不原生接收该通知协议的 ACP 客户端，@agentrq/acp-gateway 读取项目中的 .mcp.json，启动代理子进程并在 ACP 与 MCP 之间转发任务、消息和权限请求；@agentrq/codex-gateway 则连接 MCP 与 Codex app-server。全局 CoreMCP Supervisor 可跨工作区执行 listWorkspaces、listAllTasks、updateTaskAssignee、respondToTask、getAttachment 等管理操作，并输出更新后的任务、会话和工作区状态。

1. 同时运行多个 Claude Code 项目的开发者，为每个项目配置独立的工作区 MCP 地址，让代理领取任务并把进度同步回统一仪表板。
2. 需要人工审批敏感操作的团队，通过任务会话接收代理的权限请求，再由 Supervisor 的 respondToTask 提交允许或拒绝决定。
3. 管理多个项目的负责人，通过 CoreMCP 汇总所有工作区任务、调整负责人和优先级，并查看工作区统计。
4. 使用 Gemini CLI 或其他 ACP 代理的团队，通过 @agentrq/acp-gateway 将实时任务通知送入正在运行的代理会话。
5. 使用 OpenAI Codex 的工程团队，通过 @agentrq/codex-gateway 和项目级 MCP 配置接收任务，并让 Codex 在执行期间更新状态和回复。
6. 有周期性协作流程的团队，使用带 cron_schedule 的 createTask 建立计划任务，并在 Web 界面与代理之间实时同步。

如何安装或部署这个 Agent？

本地开发需要 Go 1.21+、Node.js 18+ 与 npm，以及 Google Cloud Console 中创建的 OAuth2 Client ID 和 Secret。在 backend/_config/base.yaml 或 backend/_config/development.yaml 中配置凭据：

auth:
  google:
    client_id: "your-google-client-id"
    client_secret: "your-google-client-secret"

从仓库根目录安装依赖并启动前后端：

make install
make dev

前端随后运行在 http://localhost:5173。生产或开发环境也可使用预构建 Docker 镜像自托管，但所给材料未列出完整的 Docker 命令，而是将这些命令放在 SETUP.md。如需 ACP 网关，可全局安装：

npm install -g @agentrq/acp-gateway

如需 Codex 网关，可全局安装：

npm install -g @agentrq/codex-gateway@latest

如何使用这个 Agent？

在 AgentRQ 工作区的 Setup 弹窗中取得工作区 ID、完整 MCP URL 和令牌。Claude Code 项目根目录创建 .mcp.json：

{
  "mcpServers": {
    "agentrq-WORKSPACE_ID": {
      "type": "http",
      "url": "YOUR_MCP_URL"
    }
  }
}

再创建 .claude/settings.local.json，启用服务器并预批准所列 AgentRQ 工具：

{
  "permissions": {
    "allow": [
      "mcp__agentrq-WORKSPACE_ID__updateTaskStatus",
      "mcp__agentrq-WORKSPACE_ID__getWorkspace",
      "mcp__agentrq-WORKSPACE_ID__reply",
      "mcp__agentrq-WORKSPACE_ID__createTask",
      "mcp__agentrq-WORKSPACE_ID__downloadAttachment",
      "mcp__agentrq-WORKSPACE_ID__getTask"
    ]
  },
  "enableAllProjectMcpServers": true,
  "enabledMcpjsonServers": ["agentrq-WORKSPACE_ID"]
}

从该项目目录启动 Claude Code：

claude --dangerously-load-development-channels server:agentrq-WORKSPACE_ID

Gemini CLI 或其他 ACP 代理可在同一项目根目录保留 .mcp.json，然后执行：

acp-gateway -- gemini --acp

Codex 需要同时配置供代理调用工具的 .codex/config.toml，以及供网关接收任务的 .mcp.json。最小网关连接文件为：

{
  "mcpServers": {
    "agentrq": {
      "type": "http",
      "url": "https://<WORKSPACEID>.mcp.agentrq.com/mcp?token=<TOKEN>"
    }
  }
}

然后在包含该文件的工作区根目录运行：

codex-gateway

如需显式指定 Codex 命令，可运行：

codex-gateway -- codex app-server

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

最近版本

来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。

1. v0.13.0 2026-10-18
   发布说明摘录

   What's Changed * feat(license): publish agentrqd and its installers under Apache-2.0 by @mustafaturan in https://github.com/agentrq/agentrq/pull/972 * feat(server): ship the server as one binary with the web app built in by @mustafaturan in https://github.com/agentrq/agentrq/pull/973 * fix(supervisor): clear context by default in the supervisor workspace by @mustafaturan in https://github.com/agentrq/agentrq/pull/975 * chore: bump minor version to v0.13.0 by @mustafaturan in https://github.com/agentrq/agentrq/pull/974 …

   在 GitHub 查看 ↗
2. v0.12.1 2026-10-18
   发布说明摘录

   What's Changed * feat(acp): /logout logs a native ACP v1 agent out by @mustafaturan in https://github.com/agentrq/agentrq/pull/958 * fix(app): fit the Spin up panel on a phone screen by @mustafaturan in https://github.com/agentrq/agentrq/pull/959 * fix(acp): count a call as the workspace's own only under its exact server names by @mustafaturan in https://github.com/agentrq/agentrq/pull/960 * feat(acp): show a native ACP v1 agent's notices in the trajectory and as a toast by @mustafaturan in https://github.com/agentrq/agentrq/pull/961 …

   在 GitHub 查看 ↗
3. v0.12.0 2026-10-17
   发布说明摘录

   What's Changed * test(repository): fail on SQL text built at run time by @mustafaturan in https://github.com/agentrq/agentrq/pull/941 * fix(acp): check ToolCall.name in workspaceTool for ACP v1 tool calls and permissions by @mustafaturan in https://github.com/agentrq/agentrq/pull/940 * fix(acp): return accept when elicitation/complete resolves a waiting URL elicitation by @mustafaturan in https://github.com/agentrq/agentrq/pull/942 …

   在 GitHub 查看 ↗

常见问题