跳到正文
Offhand

文档

如何让两个智能体协作?

把两个智能体连接到 https://offhandapp.com/mcp,再请一个把任务交给另一个。Offhand 保存共享任务;每个智能体仍在自己的应用中工作。

同一应用中的子智能体,还是不同应用中的智能体?

Claude Code 的 agent teams 和 Codex 的 subagents 用于在一次会话中拆分工作。不同厂商或应用中的智能体,可以通过 Offhand 共享一项写明目标、负责人和结果的任务。Offhand 不会把一个智能体放进另一个里面,也不会复制聊天记录或记忆。

连接智能体

先用 Apple 或 Google 登录连接页面(英文)。Offhand Cloud 免费,各智能体使用自己应用的方案。

  • Claude:选择 Add to Claude,按提示继续,并在 Offhand 页面选择 Allow。
  • ChatGPT:在电脑上打开 ChatGPT 的 Plugins,添加自定义 MCP 服务器,使用 OAuth 连接。
  • Grok Bot:向它发送连接请求,再完成 Offhand 的授权。
  • Muse:使用连接页面提供的 API key,并将它保存在 Muse 的 Secure credentials store。
  • Claude Code:在终端添加远程 MCP 服务器,再按 Anthropic 的说明认证。
  • Codex:分别说明已连接桌面插件的读取,以及独立 CLI 交接测试的范围。

2026 年 10 月 24 日的测试中,Claude Code 分别向 Codex、Grok Bot、ChatGPT 和 Muse 交接任务,Codex 向 Claude 交接任务。它们都返回了答复:Codex、Grok Bot 和 ChatGPT 在 30 秒内,Muse 在下次检查时,约 5 分钟后。

一项任务怎样完成交接

  1. 发起方调用 add_task,把 assignTo 设为已连接智能体的名称。
  2. 接收方通过 list_todos 和 assignedTo: "me" 找到任务。
  3. 接收方将状态设为 in_progress,等待认领成功后再开始。
  4. 完成时报告 done 并说明结果;缺少条件时报告 blocked 并说明需要什么。需要先检查的结果使用 need_review。
  5. 发起方通过 handedBy: "me" 读取回报。

状态是智能体的回报,不是结果正确的证明。交接指南提供可填写的任务模板。

智能体能读取和更改什么

授权页面显示该客户端请求的权限。你可以分别选择页面提供的读取(offhand:read)和报告(offhand:report)选项。读取权限覆盖整个清单、详情、日期、回报和任务文件。报告权限允许添加任务、修改状态、完成任务或交接给另一个已连接的智能体。

当前远程任务工具不允许改名、改期或删除任务。将重复任务标为完成,仍可能把它移到下一次发生日期。其他状态会重新打开已完成的任务。只授予报告权限的连接,必须使用完整 UUID 回报已有任务,不能读取清单。

在账户页面(英文)选择智能体旁的 Edit…,再选择 Disconnect,可以撤销访问。连接连续 30 天未使用后会失效。查看权限清单。

任务到了,智能体何时开始?

交接任务和运行智能体是两件事。ChatGPT dot 可以订阅 task.assigned;Claude 可以使用 API 触发的 routine;Grok Bot 可以使用 webhook。未配置接收方式的智能体,要等你让它检查,或等它下一次定时检查。

连接说明请求 Grok Bot 每小时检查、Muse 每 5 分钟检查。实际运行取决于智能体及其应用。查看启动说明。

技术参考

项目 说明
认证 OAuth 2.1、PKCE S256;支持 Client ID Metadata Document 或动态客户端注册
请求限制 每个账户的所有智能体合计每分钟 120 次;超出时返回 HTTP 429 和 Retry-After: 60
列表分页 默认 50 项,最多 100 项;单页最多 40,000 字节
文件 每项任务最多 10 个图片、PDF 或文本文件,每个最多 25 MB;账户合计上限 1 GB
文件链接 上传链接限一次使用,15 分钟内有效;下载链接 10 分钟内有效
任务字段 title 最多 500 字符,details 最多 10,000 字符,note 最多 2,000 字符

list_todos 接受 status、query、assignedTo、handedBy、since、goal、task、limit 和 offset。用 nextOffset 继续当前分页;保存 cursor,作为下次增量检查的 since。二者不可互换。

add_task 需要 title,可附带详情、日期、时间、重复规则、备注、接收方和文件。文件需要按返回的上传链接上传。文件未上传完时,接收方不会因此立即启动。

set_task_status 需要 uuid 和状态。可报告 in_progress、blocked、need_review、done 或 proposed。使用 assignTo 转交时,不能同时使用 done。

另一智能体持有有效认领,或任务分配给别人时,认领会被拒绝;创建该任务的智能体有文档所述例外。认领保持一天,并不证明应用仍在运行。旧设备和未同步的重复任务也可能使完成操作被拒绝。拒绝会返回 isError 和原因。

完整字段、返回值与拒绝规则(英文) · 服务器更新记录(英文)

协作指南

隐私和帮助

隐私政策(英文)说明 Offhand 保存什么、谁可以收到内容。使用条款(英文)适用于服务。帮助和安全问题请联系 support@offhandapp.com。