Hermes Agent接入微信与Discord的完整配置路径及实操要点可在https://hermes-agent.nousresearch.com/docs/user-guide/messaging/weixin查看，涵盖交互式向导、二维码扫码绑定、Discord Bot Token校验、Intent设置、Invite链接授权及多平台环境兼容性说明。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望将Hermes Agent接入微信或Discord等消息平台，但尚未完成基础配置或遇到连接失败、扫码无响应、凭证未写入等问题，则可能是由于依赖缺失、网关未正确选择或环境不兼容所致。以下是解决此问题的步骤：
一、安装必要依赖与运行环境
Hermes Agent在Linux/macOS/WSL2/Android(Termux)环境下运行需预装基础工具链，缺失任一组件将导致setup向导中断或二维码无法生成。确保系统已具备aiohttp、cryptography及qrcode支持。
1、执行命令安装核心依赖：pip install aiohttp cryptography
2、如需在终端直接显示二维码图像，追加安装：pip install qrcode
3、验证Python版本是否为3.9及以上：python --version
4、确认当前用户对~/.hermes目录具有读写权限，避免凭证写入失败。
二、启动网关配置向导并选择平台
运行统一配置入口可触发交互式向导，自动识别可用消息通道，并为所选平台生成专属初始化流程。该步骤绕过手动编辑.env文件，降低配置错误率。
1、在终端中输入启动命令：hermes gateway setup
2、等待向导加载完成，在平台列表中使用方向键高亮选择：Weixin 或 Discord
3、按回车确认后，向导将自动拉取对应适配器、生成临时凭证并准备扫码界面。
4、若终端未显示二维码，请检查是否遗漏qrcode依赖；若显示链接，则复制至浏览器打开并用手机扫码。
三、微信扫码配对与账号绑定
微信接入基于腾讯iLink BotAPI官方接口，采用长轮询机制，无需公网IP或Webhook服务，扫码即完成双向认证与上下文令牌绑定。
1、手机微信打开“扫一扫”，扫描终端中显示的二维码或访问向导提供的URL链接。
OpenClaw 部署前安全检查清单：聚焦合规导向的部署前检查，覆盖防火墙、SSH、API 密钥管理、数据出境合规及多场景验证。清单式检查，逐项打勾并生成报告，适用于个人 Mac、VPS、Docker及企业部署。
2、扫码后手机端弹出“已连接OpenClaw，是否解除？”提示，点击：继续连接
3、跳转至对话框后，点击右上角“…”，选择“更多”→“添加到桌面”（可选，便于后续快速唤起）。
4、返回终端，等待提示“Account credentials saved to ~/.hermes/weixin/accounts/”即表示绑定成功。
四、Discord机器人令牌配置
Discord接入需通过Discord Developer Portal创建应用并获取Bot Token，该Token将作为身份凭证写入Hermes本地配置，不可泄露或硬编码于公开脚本中。
1、访问 https://discord.com/developers/applications，点击“New Application”，填写应用名称。
2、进入左侧菜单“Bot” → “Add Bot”，复制生成的Token（非Client ID）。
3、在终端中运行：hermes gateway setup，选择Discord后，向导将提示粘贴Token。
4、粘贴时确保无前后空格，按回车后向导自动校验格式并写入~/.hermes/discord/accounts/目录。
五、验证私聊策略与凭证路径
接入完成后，Hermes默认启用私聊开放策略（WEIXIN_DM_POLICY=open），但实际生效依赖于凭证文件是否存在且可读。需人工确认关键路径与内容完整性。
1、检查微信凭证路径是否存在且非空：ls -l ~/.hermes/weixin/accounts/
2、检查Discord凭证路径是否包含json文件：ls ~/.hermes/discord/accounts/*.json
3、查看私聊策略当前值：grep WEIXIN_DM_POLICY ~/.hermes/.env
4、若策略显示disabled或allowlist，但未配置WEIXIN_ALLOWED_USERS，则所有私聊消息将被静默丢弃。
