Telegram 接 Hermes Agent 常見坑與解法

Telegram 整合最常見兩個坑：Telegram 有 100 個斜線指令上限（用 skills.platform_disabled 停用不需要的 skill），以及 WSL 下 gateway 斷線（改用 hermes gateway run 前景模式或 tmux）。

這頁適合誰：把 Hermes 接上 Telegram bot 後遇到指令消失或斷線的人。

步驟

  1. 坑一：斜線指令超過 100 個

    Telegram 平台限制 100 個指令。官方解法：在 config.yaml 停用該平台不需要的 skills，改完重啟 gateway。

    skills:
  platform_disabled:
    telegram: [skill-a, skill-b]

  2. 坑二：WSL 下 gateway 一直斷

    官方 FAQ：systemd 在 WSL 不可靠，改用前景模式或 tmux 常駐。

    hermes gateway run
# 或
tmux new -s hermes 'hermes gateway run'

  3. 多人共用要設授權

    官方訊息閘道支援 allowlist 與 DM 配對，在 config.yaml 的 gateway 設定授權模式。

完成後怎麼驗證

常見問題

從 OpenClaw 搬過來，Telegram 允許名單要重設嗎？

官方遷移工具會搬 TELEGRAM_ALLOWED_USERS 等相容設定；帶 --migrate-secrets 也會搬 TELEGRAM_BOT_TOKEN。見 OpenClaw 搬家教學。

相關頁