必须通过hermes内置gateway统一接入telegram、discord和微信,禁止单独部署;需python 3.10+,安装时必带[all]选项,端口固定8000,微信仅支持个人账号扫码绑定。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在 Telegram、Discord 和微信三个平台同时接入 Hermes Agent 并实现消息互通,必须通过其内置的 hermes gateway 统一管理,不能单独为每个平台重复安装或配置独立服务,否则会触发端口冲突和记忆同步中断。
准备基础运行环境
确认系统已安装 Python 3.10 或更高版本,并确保 pip 已升级至最新:pip install --upgrade pip。
克隆官方仓库并进入项目目录:git clone https://github.com/nousresearch/hermes-agent.git && cd hermes-agent。
安装核心依赖:pip install -e ".[all]"。这一步必须包含 【all】 选项,否则 Telegram/Discord 的适配器模块不会被安装,后续 gateway 启动时将报错“no adapter found for telegram”。
初始化网关并启动基础服务
执行 hermes gateway init,生成默认配置目录 ~/.hermes/gateway/。
运行 hermes gateway start,此时终端会输出类似 Gateway listening on http://127.0.0.1:8000 的提示——说明网关进程已就绪,但尚未接入任何平台。
注意:若看到 Failed to bind port 8000,请先执行 lsof -i :8000 | grep LISTEN 查杀占用进程,【不要强行修改默认端口】,因为微信扫码绑定流程硬编码依赖 8000 端口回调。
逐平台接入配置
第一步:接入 Telegram
访问 BotFather 创建新 Bot,获取 Token;然后执行:hermes gateway setup telegram --token YOUR_TELEGRAM_BOT_TOKEN。
第二步:接入 Discord
前往 Discord Developer Portal 创建应用 → 新建 Bot → 复制 Token;再运行:hermes gateway setup discord --token YOUR_DISCORD_BOT_TOKEN --client-id YOUR_DISCORD_CLIENT_ID。
第三步:接入微信(原生支持)
执行 hermes gateway setup wechat,终端将生成一个二维码;用任意微信(非企业微信)客户端扫码,完成账号绑定;绑定成功后,该微信账号即成为 Hermes Agent 的「主控入口」,所有其他平台消息都会路由至此进行统一上下文调度。
这一步操作起来很简单,直接把文件拖进去就行——但必须使用个人微信扫码,【企业微信、微信工作台、微信公众号后台均不支持】,否则 gateway 会卡在 waiting for scan 状态超过 90 秒后自动退出。











