ATEL MCP Hermes Plugin

独立的 Hermes 接入包，用于让 Hermes Agent 接入 ATEL MCP，并把 ATEL inbox 消息回投到 Hermes 已绑定的消息渠道。

这个包只处理 Hermes，不承载 OpenClaw 逻辑。OpenClaw 仍走 openclaw-plugin/，Hermes 走 hermes-plugin/，避免两个 runtime 的安装、服务和状态文件互相污染。

能力范围

• 写入 ~/.hermes/.env：
  • MCP_ATEL_API_KEY
  • ATEL_MCP_URL
  • HERMES_ATEL_NOTIFY_TARGET
  • ATEL_INBOX_POLL_INTERVAL
• 写入或更新 ~/.hermes/config.yaml 的 mcp_servers.atel。
• 安装 user systemd 服务：atel-mcp-hermes-listener.service。
• 定时轮询 ATEL inbox。
• 通过 hermes send --to <target> 把 ATEL 消息投递到 Hermes 当前消息渠道。
• 成功投递后调用 atel_ack。

安装

发布到 npm 后：

npx -y -p atel-mcp-hermes atel-mcp-hermes install \
  --token "$MCP_ATEL_API_KEY" \
  --mcp-url "https://atelai.xyz/mcp" \
  --target telegram

如果已经在环境变量里设置了 MCP_ATEL_API_KEY，也可以省略 --token：

MCP_ATEL_API_KEY=xxx npx -y -p atel-mcp-hermes atel-mcp-hermes install

发布前可以从仓库根目录先打成本地 tarball：

npm run pack:hermes
npm install -g ./dist/packages/atel-mcp-hermes-0.1.0.tgz
atel-mcp-hermes install --token "$MCP_ATEL_API_KEY"

真正发布时，在仓库根目录执行：

npm run publish:hermes:dry
npm run publish:hermes

常用命令

atel-mcp-hermes detect
atel-mcp-hermes listen
atel-mcp-hermes install --token "$MCP_ATEL_API_KEY"

服务状态

systemctl --user status atel-mcp-hermes-listener.service
journalctl --user -u atel-mcp-hermes-listener.service -f

设计边界

• Hermes 的消息渠道绑定仍由 Hermes 自己负责。
• 本插件不直接实现 Telegram、飞书、钉钉、微信等渠道。
• 本插件只负责 ATEL MCP 配置和 ATEL inbox 到 Hermes 消息渠道的回投。
• OpenClaw 的 DID-Sig、relay poll、channel-aware dispatcher 不放在这里。