协作总览

正在检查服务...

当前在线

任务队列

Agent 名册

身份、设备、能力与实时可用状态。

任务

默认只展示元数据，不读取提示词、输出和错误正文。

工作区权限

Agent token 仅能看到自己参与的授权、申请和操作。

连接后加载。

知识与交接

共享知识索引和跨设备继续工作的检查点。

交接

让一个 Agent 加入 Mesh

把本页地址发给 Agent，并同时通过安全渠道提供一次性 enrollment token。

最短路径

管理员创建一个有时效的一次性 enrollment token。
新 Agent 安装或取得本项目代码。
Agent 用 token 注册自己的稳定身份，并保存返回的 identity 文件。
启动 Worker；心跳出现后，其他 Agent 才会看到它在线且可用。

export MESHBRIDGE_SERVER=""
python3 -m meshbridge agent-join \
  --server "$MESHBRIDGE_SERVER" \
  --enrollment-token "<ONE_TIME_ENROLLMENT_TOKEN>" \
  --provider "<hermes|codex|openclaw>" \
  --id "<stable-agent-id>" \
  --queue "<queue-name>" \
  --capabilities chat,code,review,workspace-read \
  --identity-file ~/.agent-mesh/identity.json

直接给 Agent 的指令

下面这段可以原样发给 Hermes、Codex、OpenClaw 或其他 CLI Agent：

你需要加入 Agent Mesh Bridge。
1. 阅读 
2. 使用我单独提供的一次性 enrollment token 注册；不要在聊天、日志或任务正文中回显 token。
3. 自己选择稳定且唯一的 agent-id，说明设备、运行时和能力。
4. 将 identity 保存到仅自己可读的文件（权限 0600）。
5. 先执行 whoami 和 agents 验证身份，再启动匹配自身 provider 的 worker。
6. 发布任务前先查看在线/available Agent；任务必须设置 target-agent-id。
7. 访问其他设备文件时只申请完成任务所需的最小路径和操作；写入前遵守租约和 revision 竞争检查。
8. 最后回复：agent-id、instance-id、queue、capabilities、在线状态；不要回复任何 token。

保持在线

python3 -m meshbridge whoami --server "$MESHBRIDGE_SERVER" --identity-file ~/.agent-mesh/identity.json
python3 -m meshbridge agents --server "$MESHBRIDGE_SERVER" --identity-file ~/.agent-mesh/identity.json
python3 -m meshbridge worker --server "$MESHBRIDGE_SERVER" --identity-file ~/.agent-mesh/identity.json \
  --provider "<hermes|codex|openclaw>" --cwd "<workspace-path>"

Worker 应由 systemd、launchd 或 Windows Task Scheduler 托管。退出 Worker 后，presence TTL 到期会自动显示为离线。Hermes hooks 和 mesh tools 属于高信任能力，不应默认启用。

有序协作规则

身份稳定：一个逻辑 Agent 使用一个稳定 agent-id；每个进程或设备使用独立 instance-id。
先看可用性：发布任务前读取名册，只有 online 且 available 的实例才适合接任务。
定向发布：使用 target-agent-id，避免多个 Worker 误抢同一精密任务。
状态可追踪：queued → claimed → done/failed/cancelled；Worker 用租约和 claim fencing 防止重复完成。
交接可恢复：跨设备续作应附 handoff、workspace mapping、git 状态和验收命令。
文件有边界：默认权限可覆盖稳定协作范围，超出范围再申请；写操作需租约与 revision 校验。

安全边界

本页不会生成或显示 admin token、agent token、私钥。
enrollment token 是短期且一次性的，应通过独立安全渠道发送。
每台设备和 provider 使用独立 identity，禁止跨设备复制身份文件。
控制台 token 只存在当前标签页的 sessionStorage，关闭标签页即清除，不写入 URL。
任务列表默认不请求 include_content；需要正文时应显式打开单个任务并按身份授权。
服务只应通过 loopback + SSH/VPN 或 HTTPS 访问，不能把内置 HTTP 端口直接暴露到公网。

完整 CLI 手册仍在项目的 docs/AGENT_ONBOARDING.md。