把 CoMiClaw/Hermes runtime 接入 Octo IM 的独立 Node.js 网关。

安装

npm install -g @seeyon-v5/comi-channel-octo

需要 Node.js 22 或更高版本。

运行模式

• hermes-cli：执行 hermes --query <prompt> --quiet，适合本机或 CoMiClaw bundled Hermes。
• hermes-api：调用 Hermes API Server 的 /v1/runs 和 /events，支持 /p/{profile} 多 profile。
• comi-local-api：预留给 CoMiClaw 后续 loopback API，契约与 Hermes run/event 保持一致。

配置

全局配置在 ~/.comi-channel-octo/config.json，保存共享默认值和 bot 列表。每个 bot 的 token 在 ~/.comi-channel-octo/<id>/config.json。

{
  "apiUrl": "http://192.168.225.253:28080",
  "allowPrivateOctoUrl": true,
  "bots": [{ "id": "default" }],
  "runtime": {
    "mode": "hermes-api",
    "baseUrl": "http://localhost:8642",
    "profile": "fde-0123456789abcdef01234567",
    "allowPrivateRuntimeUrl": false
  }
}

{
  "botToken": "bf_xxx",
  "runtime": {
    "profile": "fde-0123456789abcdef01234567",
    "apiKey": "sk_RUNTIME_API_KEY"
  }
}

内网 Octo 地址必须显式设置 allowPrivateOctoUrl: true；内网 Hermes/CoMi runtime 地址必须显式设置 runtime.allowPrivateRuntimeUrl: true。

启停

comi-channel-octo start
comi-channel-octo status
comi-channel-octo stop

前台运行：

comi-channel-octo start --foreground

多 bot 与 Hermes profile

comi-channel-octo 支持单进程运行多个 Octo bot。每个 bot 都有独立的 data/workspace/memory/Hermes home。使用 hermes-api 时，可给每个 bot 配不同 runtime.profile，网关会调用 /p/{profile}/v1/runs，从而在一个 Hermes API Server 中隔离多 bot 状态。

当前 CoMiClaw 桌面端仍是单个本机 Hermes 运行时，可以先用 hermes-cli 接入。若要在一个 CoMiClaw 桌面进程中承载多个 bot/profile，后续需要在 CoMiClaw 增加兼容这里 run/event 契约的 loopback API。