Hermes Agent 深度指南 05：多平台集成——飞书/Telegram/Discord

hermes gateway setup
# 选 Feishu → 输入 App ID → 输入 App Secret → 输入 Verification Token

# ~/.hermes/config.yaml
gateway:
  enabled: true
  listen: "0.0.0.0:8080"

  platforms:
    feishu:
      enabled: true
      app_id: "cli_xxxxxxxxxxxx"
      app_secret: ${FEISHU_APP_SECRET}
      verification_token: ${FEISHU_VERIFY_TOKEN}
      encrypt_key: ${FEISHU_ENCRYPT_KEY}  # 如果启用了加密

hermes gateway run
# 输出：Gateway listening on :8080
#       ✅ Feishu connected
#       ✅ Telegram connected
#       ⚠️  Discord not configured

gateway:
  platforms:
    telegram:
      enabled: true
      token: ${TELEGRAM_BOT_TOKEN}
      # 可选：限制只有这些用户能用
      allowed_users:
        - 123456789   # 你的 Telegram user ID
        - 987654321

gateway:
  platforms:
    telegram:
      webhook_url: "https://your-server.com/hermes/telegram"

# 用 ngrok 临时测试
ngrok http 8080
# 拿到 https://xxxx.ngrok.io 后填到 webhook_url

gateway:
  platforms:
    discord:
      enabled: true
      token: ${DISCORD_BOT_TOKEN}
      application_id: "1234567890123456789"
      # 可选：监听特定频道
      allowed_channels:
        - "1234567890123456789"   # #hermes-test
        - "9876543210987654321"   # #dev-chat
      # 可选：只回复 @mention 的消息
      mention_only: false

gateway:
  platforms:
    discord:
      slash_commands: true
      commands:
        - name: ask
          description: "直接问 Hermes 一个问题"
        - name: summarize
          description: "总结最近的聊天内容"
        - name: translate
          description: "翻译消息"

gateway:
  routing:
    # 规则从上到下匹配，命中即停止
    rules:
      # 规则 1：Cron 任务的输出，按任务配置的通知渠道发
      - source: cron
        notify: "{{.task.notify.channel}}"

      # 规则 2：来自飞书运维群的消息，只路由到运维相关的 Skills
      - source: feishu
        chat_id: "oc_xxxxxxxxxxxx"
        skills: [server-health, deployment]
        model: deepseek-v4-pro

      # 规则 3：来自 Discord 的消息，用便宜模型
      - source: discord
        model: gemini-3-flash
        provider: google

      # 规则 4：Telegram 私聊，完整能力
      - source: telegram
        chat_type: private
        skills: [*]          # 所有 Skills 都可用
        toolsets: [*]        # 所有 toolsets

      # 默认：兜底规则
      - default: true
        model: deepseek-v4-pro

gateway:
  permissions:
    admin:
      - telegram:123456789          # 你自己，完整权限
    trusted:
      - feishu:ou_xxxxxxx           # 同事，可以用 web_search 但不能写文件
      - discord:987654321098765432
    guest:
      - discord:*                   # 其他人，只能聊天

  permission_sets:
    admin:
      toolsets: [*]
      skills: [*]
    trusted:
      toolsets: [web, file, search]
      skills: [public-*]            # 只有 public- 开头的 Skills
    guest:
      toolsets: [web]
      skills: []                    # 没有任何 Skills

# ~/.hermes/config.yaml 完整配置
gateway:
  enabled: true
  listen: "0.0.0.0:8080"

  platforms:
    feishu:
      enabled: true
      app_id: ${FEISHU_APP_ID}
      app_secret: ${FEISHU_APP_SECRET}
      verification_token: ${FEISHU_VERIFY_TOKEN}

    telegram:
      enabled: true
      token: ${TELEGRAM_BOT_TOKEN}
      webhook_url: "https://hermes.yourdomain.com/telegram"
      allowed_users: [123456789]

    discord:
      enabled: false  # 先不开

  routing:
    rules:
      - source: cron
        notify: "{{.task.notify.channel}}"

      - source: feishu
        chat_id: "oc_xxxxx"
        skills: [server-health]
        model: deepseek-v4-pro

      - source: telegram
        chat_type: private
        skills: [blog-deploy, news-digest, rss-reader]
        model: deepseek-v4-pro
        toolsets: [terminal, web, file]

  permissions:
    admin:
      - telegram:123456789
    admin_toolsets: [*]

cron:
  enabled: true
  tasks:
    - name: daily-ai-digest
      schedule: "30 8 * * *"
      description: "每日 AI 资讯摘要"
      model: deepseek-v4-pro
      toolsets: [web]
      skills: [news-digest]
      notify:
        channel: feishu
        webhook_url: ${FEISHU_WEBHOOK}

    - name: blog-auto-deploy
      schedule: "0 22 * * *"
      description: "博客自动部署"
      toolsets: [terminal, file, web]
      skills: [blog-deploy]
      notify:
        channel: telegram
        chat_id: "123456789"

# 最简单的方案：Caddy 反向代理 + 自动 HTTPS
sudo apt install caddy

# /etc/caddy/Caddyfile
hermes.yourdomain.com {
    reverse_proxy localhost:8080
}

# ~/.bashrc 或 ~/.zshrc
export FEISHU_APP_SECRET="your-secret"
export TELEGRAM_BOT_TOKEN="1234567890:ABCdef..."
export DISCORD_BOT_TOKEN="your-discord-token"

hermes cron create "*/5 * * * *" "
检查 Gateway 是否在运行：
1. 用 terminal 执行：curl -s http://localhost:8080/health
2. 如果返回不是 200，或者连接失败，用 gateway 推送到 Telegram：
   '⚠️ Hermes Gateway 挂了，快去重启'
3. 如果返回 200，什么都不做
"

# /etc/systemd/system/hermes-gateway.service
[Unit]
Description=Hermes Gateway
After=network.target

[Service]
Type=simple
User=ubuntu
ExecStart=/usr/local/bin/hermes gateway run
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

sudo systemctl enable --now hermes-gateway