元宝接入——腾讯 AI 助手

元宝接入——腾讯 AI 助手

嘿，朋友们！今天咱们来聊聊怎么把 Hermes 接到腾讯元宝上。元宝是腾讯自家的企业级消息平台，相当于企业内部版的微信。接入之后，你的 Hermes 就能在元宝里跟你聊天、汇报任务、发通知，还能收发图片、文件和语音消息，非常实用！

准备工作

动手之前，先确认几件事：

• 一个能创建机器人的元宝账号
• 从平台管理员那里拿到 APP_ID 和 APP_SECRET
• 安装必要的 Python 包：

pip install websockets httpx aiofiles

三步搞定接入

第一步：创建机器人

1. 从 https://yuanbao.tencent.com/ 下载元宝 App
2. 打开 App，进入 PAI → 我的机器人，新建一个机器人
3. 创建完成后，复制 APP_ID 和 APP_SECRET

第二步：运行配置向导

最省事的方式是用交互式向导：

hermes gateway setup

选择 Yuanbao，然后按提示输入 APP_ID 和 APP_SECRET 就行。WebSocket 地址和 API 域名都有默认值，不用你操心，填两个密钥就能跑起来。

第三步：启动网关

hermes gateway

搞定！适配器会自动连接元宝的 WebSocket 网关，用 HMAC 签名完成认证，开始处理消息。

常用配置

配置保存在 ~/.hermes/.env 里，核心变量就这几个：

YUANBAO_APP_ID=你的应用ID
YUANBAO_APP_SECRET=你的应用密钥
YUANBAO_WS_URL=wss://api.yuanbao.example.com/ws
YUANBAO_API_DOMAIN=https://api.yuanbao.example.com

聊天 ID 格式

元宝用前缀来区分聊天类型：

聊天类型	格式	示例
私聊 (C2C)	direct:<账号>	direct:user123
群聊	group:<群码>	group:grp456

设置消息接收频道

想让定时任务的结果发到指定聊天？用 /sethome 命令就行：

1. 在元宝里跟机器人发起对话
2. 发送 /sethome
3. 机器人会回复确认信息，之后定时任务的结果就都发到这里

小技巧：如果没设置，第一个给机器人发消息的人会自动成为默认接收者。如果当前是群聊，第一条私聊消息会自动升级为新的接收频道。

定时任务示例

/cron "0 9 * * *" 检查服务器状态

每天上午 9 点，结果就会自动推送到你的元宝频道。

亮点功能一览

• 实时双向通信——WebSocket 网关，消息秒达
• 媒体支持——图片、文件、语音都能收发（走腾讯云 COS）
• Markdown 自动分块——长消息自动拆分，不怕超限
• 消息去重——同一消息不会重复处理
• 自动重连——断线后指数退避重连，稳得很
• 正在输入提示——Agent 处理时显示“正在输入…”
• 微信聊天记录解析——转发微信聊天记录到元宝，Agent 能读懂完整对话
• 表情包支持——TIMFaceElem 贴纸和 emoji 都能发

常用命令

所有标准 Hermes 命令都能用，比如 /new 开新对话、/model 切换模型等等。

---

接入过程就这么简单！有问题欢迎在评论区留言，咱们下期见！🚀