元宝接入——腾讯 AI 助手

这篇教程将手把手教你如何把 Hermes Agent 智能体接入腾讯元宝，让 AI 助手在你的企业聊天里随叫随到。

准备工作：先备好三样东西

就像出门旅行前要检查身份证、钱包和手机一样，接入元宝前你需要：

1. 一个元宝账号（要有创建机器人的权限）
2. APP_ID 和 APP_SECRET（相当于机器人的“门牌号”和“钥匙”，找平台管理员要）
3. 安装几个 Python 小工具——别怕，只需一条命令：

pip install websockets httpx aiofiles

第1步：在元宝里创建机器人

打开元宝 App（https://yuanbao.tencent.com/），找到 PAI → 我的机器人，点“新建”。创建成功后，你会看到一串 APP_ID 和一串 APP_SECRET——把它们复制下来，这就是机器人的身份证和钥匙。

第2步：运行设置向导（偷懒神器）

Hermes 提供了一个交互式向导，你只需要在终端输入：

hermes gateway setup

然后按提示选择 Yuanbao，粘贴刚才复制的 APP_ID 和 APP_SECRET，剩下的它全帮你搞定。WebSocket 地址和 API 域名都内置了默认值，不用你操心。

第3步：检查配置文件

向导保存后，打开 ~/.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

第4步：启动网关，让机器人“上线”

hermes gateway

看到连接成功的日志，你的机器人就正式“上岗”了！

机器人能干什么？

接入后，你的机器人就像个全能助理：

• 私聊和群聊都能聊——直接对话或拉进群都行
• 收发图片、文件、语音——自动上传到腾讯云 COS
• 支持 Markdown 排版——长消息会自动分段，不怕超限
• 自动重连——网络断了会自己爬回来，不用你管
• 微信聊天记录解析——用户转发微信聊天记录进来，机器人能读懂完整对话

设置“家庭频道”：定时任务的收件箱

想象一下，机器人每天定时汇报工作，结果发到哪个群？这就需要设置家庭频道。

在任何对话里发送 /sethome，机器人就会回复：“家庭频道已设置为 [聊天名称]”。之后所有定时任务（比如每天早上9点的服务器状态报告）都会自动发到这里。

小技巧：如果你不设置，第一个给机器人发消息的人会自动成为家庭频道主人。

遇到问题？常见故障排查

问题	原因	解决
机器人不回复	认证失败	检查 APP_ID/APP_SECRET 是否正确
连接被拒绝	网络不通	确认 wss:// 开头的地址能访问
图片发不出去	COS 权限问题	找管理员确认上传权限
老掉线	网络不稳定	查看日志 tail -f ~/.hermes/logs/gateway.log

安全设置：谁能跟机器人聊天？

你还可以精细控制谁能私聊机器人、谁能拉它进群：

# 私聊策略：open（所有人）/ allowlist（白名单）/ disabled（关闭）
YUANBAO_DM_POLICY=open
# 群聊策略同理
YUANBAO_GROUP_POLICY=open

---

总结一下：接入元宝只需四步——创建机器人、跑向导、检查配置、启动网关。之后你的 AI 助手就能在企业聊天里收发消息、处理文件、定时汇报了。

下篇预告：机器人接入只是开始，下一篇我们来聊聊如何用 Hermes 的定时任务（Cron）让机器人主动干活——比如每天早上自动整理待办清单，敬请期待！