Hermes Agent 深度教程

Appearance

第三章：多平台接入 (Gateway) ​

Gateway 模块能够把 Hermes 接到飞书、钉钉、微信等平台，让你在手机上就能随时发派任务。

3.1 网关常用管理命令 ​

无论接入哪个平台，底层服务管理命令是通用的：

bash
hermes gateway setup    # 交互式配置平台
hermes gateway run      # 前台运行（方便查看报错调试）
hermes gateway install  # 安装为系统后台服务，保证关闭终端后继续运行
hermes gateway start    # 启动后台服务
hermes gateway status   # 查看服务状态

3.2 飞书接入指南 ​

  1. 运行向导：hermes gateway setup，选择 Feishu / Lark。
  2. 连接模式：强烈推荐选择 WebSocket。这种模式不需要公网服务器和内网穿透（ngrok），Hermes 会主动连接飞书服务器。
  3. 扫码配置：如果版本支持，终端会弹出二维码，用飞书 App 扫码，Hermes 会自动创建 Bot 应用并保存凭证到 ~/.hermes/.env。
  4. 安全配置（极为重要）：为了防止公司其他人通过飞书 Bot 操控你的本地电脑，必须在 .env 中限制用户：
    env
    FEISHU_ALLOWED_USERS=ou_你的飞书ID
  5. 日常使用：启动网关后，在飞书里直接私聊机器人即可。群聊中建议通过 @Bot 来唤醒。

3.3 钉钉与企业微信接入 ​

  • 流程与飞书类似。运行 hermes gateway setup 选择对应平台。
  • 对于钉钉/企微，通常需要你手动登录开放平台后台，创建一个内部自建应用（机器人），获取 AppKey / CorpID 和 AppSecret，并赋予发送消息和接收消息的权限。将凭证填入向导或 .env 文件后即可启动。

3.4 会话内高频快捷指令 (Slash Commands) ​

在终端或聊天软件中，输入 / 可以触发快捷指令：

  • /new 或 /reset：开启全新对话，清空上下文。
  • /retry：重试上一条，删掉上次回复重新发。
  • /undo：撤销上一轮（连同你的消息一起删）。
  • /rollback：回滚文件改动，像时光机一样撤销错误代码。
  • /background 提示词：把任务扔到后台跑，不打断当前对话。
  • /yolo：危险指令！跳过所有高危命令的确认提示，调试时使用，用完记得关。