Bot Integration
Hermes Agent 平台接入教程
微信接入 / 飞书接入 / Telegram 配置，按步骤操作，快速完成机器人接入
2 步完成微信接入，扫码即连，无需额外配置
1
运行配置向导，选择微信
打开终端，执行：
hermes gateway setup
在平台列表中，用 ↑ ↓ 方向键 移动到 WeChat，按一下 空格键 选中（条目前出现 ●），再按 Enter 确认，按引导完成剩余配置。
💡 注意：必须先按空格选中再按 Enter，直接 Enter 不会生效
2
用浏览器打开链接，扫码登录
配置完成后，终端会输出一个本地链接，将该链接复制到浏览器打开，页面上会显示一个二维码：
最后启动网关，Hermes 开始监听微信消息：
- 用微信扫描该二维码
- 手机上点击确认登录
- 浏览器页面跳转提示成功后，即表示接入完成 🎉
最后启动网关，Hermes 开始监听微信消息：
hermes gateway
使用专用链接一键创建机器人，3 步完成飞书接入，无需繁琐权限配置
1
打开专用创建页面，一键生成机器人
点击下方链接，进入飞书开放平台机器人创建页面，点击页面上的「一键创建机器人」按钮，系统将自动完成应用创建与权限配置：
https://open.feishu.cn/page/openclaw?form=multiAgent
2
复制 App ID 和 App Secret
机器人创建成功后，页面会显示 App ID 和 App Secret，将这两项复制保存好，下一步配置 Gateway 时需要填入：
3
运行 Gateway 配置向导，填入凭证
打开终端（Windows 用户在 WSL2 中运行），执行：
配置完成后，启动网关：
hermes gateway setup
在交互引导中依次填写：
- 选择平台：
Feishu / Lark - 输入
App ID（步骤 2 复制的） - 输入
App Secret（步骤 2 复制的） - User IDs：留空（群内所有人均可与机器人对话）
- Domain：默认
feishu，回车确认 - Connection mode：默认
websocket，回车确认——无需公网域名
配置完成后，启动网关：
hermes gateway
在飞书中找到你的机器人，发送一条消息，Hermes 将自动响应 🎉
通过 @BotFather 创建 Bot，3 步完成 Telegram 接入，支持群聊与私聊
1
在 Telegram 创建 Bot，获取 Token
打开 Telegram，搜索并进入 @BotFather，依次执行：
- 发送
/newbot - 输入 Bot 的展示名称（如
My Hermes Bot） - 输入 Bot 的用户名（必须以
_bot结尾，如myhermes_bot） - BotFather 回复中复制 HTTP API Token（格式：
123456:ABC-DEF...）
💡 如需让 Bot 能读取群聊消息，还需在 @BotFather 中执行
/setprivacy → 选择你的 Bot → Disable
2
运行配置向导，填入 Bot Token
打开终端，执行配置向导：
hermes gateway setup
在平台列表中选择 Telegram（空格选中，Enter 确认），然后按提示填入：
- Bot Token：粘贴步骤 1 复制的 Token
- Allowed User IDs（可选）：填入你的 Telegram 数字 ID 限制访问权限，留空则所有人可用
- Connection Mode：默认
polling，无需公网域名；有域名可选webhook更稳定
📌 如何查找自己的 Telegram 数字 ID：在 Telegram 搜索 @userinfobot，发送
/start 即可获取
3
启动网关，开始对话
配置完成后，启动 Hermes Gateway：
支持群聊：将 Bot 添加到群组，在群内
hermes gateway
打开 Telegram，找到你的 Bot，发送 /start 开始对话。Bot 将实时响应你的消息 🎉
支持群聊：将 Bot 添加到群组，在群内
@你的Bot用户名 即可触发响应。
| 命令 | 功能 |
|---|---|
hermes | 启动交互式对话 |
hermes model | 切换大语言模型 / 提供商 |
hermes setup | 运行完整设置向导 |
hermes gateway | 启动多平台消息网关 |
hermes gateway setup | 配置消息平台接入 |
hermes tools | 管理启用的工具集 |
hermes doctor | 环境与配置诊断 |
hermes update | 更新到最新版本 |
