Hermes v0.8.0（爱马仕） 纯原生微信绑定教程

前置条件

已安装 Hermes Agent v0.8.0（2026.4.8）
WSL2 / Linux /macOS 环境
一个微信小号（主号有风控风险）

第一步：先修复系统环境（90% 的人卡在这里）

# 更新系统包
sudo apt update -y

# 安装Python3和pip3（Hermes v0.8.0默认没装这个）
sudo apt install python3 python3-pip -y

# 安装微信适配器依赖
sudo pip3 install aiohttp cryptography qrcode pillow requests

第二步：一键直达微信配置（核心）

不要用 hermes setup 从头走！ 直接执行这个命令跳过所有无关步骤：

hermes setup gateway

第三步：一步步精确操作

1：❌ 不要选上面的 WeCom（企业微信）在消息平台列表中，找到 Weixin (WeChat)（个人微信）
2：按 空格键 勾选，再按 回车键 确认
3：✅ Hermes 会自动识别并填入你自己的微信 ID，直接按回车确认私聊权限：选择 Only allow listed user IDs（最安全）
4：群聊权限：选择 Disable group chats（官方推荐，避免刷屏和风控）
5：所有系统通知、定时任务、工具执行结果都会自动推送到你的微信Home Channel：直接按回车确认 Y
6：最后一步：直接按回车确认重启网关

第四步：测试使用

✅ 配置完成后，终端会显示：

✅ Messaging platforms configured!
✅ 网关已重启
✅ 微信通道已连接

现在拿出你的手机微信，给刚才扫码登录的小号发一条 "你好"，1-2 秒内就会收到 Hermes AI 的回复！

常用运维命令（收藏备用）

# 查看通道状态
hermes channels status

# 重启网关
hermes gateway restart

# 停止网关
hermes gateway stop

# 重新登录微信（唯一需要扫码的情况）
hermes login --channel weixin --qr-url

# 查看实时日志（排错用）
hermes logs -f --channel weixin

重要说明

1、登录凭据会永久加密保存在本地，每次启动自动重连重启电脑 / 重启 WSL 不需要重新绑定
2、唯一需要重新扫码的情况你手动在手机微信上退出了这个设备
3、微信安全系统强制过期令牌（半年到一年一次）
4、即使是官方 iLink API，仍有账号限制风险，务必先用小号测试风险提示