HermesAgent微信网关启动失败报错排查

2026-04-16 人工智能

微信网关启动失败的主因是凭证缺失、SSL验证失败、防火墙拦截、配置语法错误或日志级别过低；需依次验证账户凭证、禁用SSL校验、放行HTTPS出站规则、修正.env格式，并启用DEBUG日志定位首条致命错误。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您尝试启动HermesAgent微信网关，但服务立即退出或日志中持续出现报错信息，则可能是由于凭证缺失、网络拦截、SSL验证失败或配置项冲突所致。以下是解决此问题的步骤：

一、验证微信账户凭证有效性与自动恢复机制

微信网关依赖iLink Bot API提供的长期有效凭证（account_id、session_key等），若凭证过期、被主动注销或首次扫码未完成授权流程，将导致启动时认证失败并退出。

1、检查凭证文件是否存在且可读：执行ls -l ~/.hermes/weixin/accounts/，确认目录下有非空JSON文件。

2、若文件为空或不存在，删除整个~/.hermes/weixin/accounts/目录后重新运行hermes gateway setup，严格使用手机版微信扫码并完成“确认登录”操作。

3、扫码成功后，终端应明确输出微信连接成功,account_id=your-account-id；若仅显示二维码无后续响应，说明iLink服务端未回调成功，需检查服务器能否访问https://api.ilink.bot。

二、禁用SSL证书验证以绕过内网自签名证书拦截

在企业内网或私有部署环境中，微信网关底层依赖的httpx与requests库会因无法校验iLink Bot API返回的自签名SSL证书而抛出[SSL: CERTIFICATE_VERIFY_FAILED]异常，导致进程崩溃。

1、创建补丁脚本：mkdir -p ~/.hermes/hermes-agent && nano ~/.hermes/hermes-agent/hermes_agent_ssl_patch.py。

2、粘贴以下内容并保存：

import httpx, ssl, warnings, requests

from requests.adapters import HTTPAdapter

class NoVerifySession(requests.Session): def request(self, *args, **kwargs): kwargs.setdefault('verify', False); return super().request(*args, **kwargs)

requests.sessions.Session = NoVerifySession

def _make_ssl_patch(init_method): def wrapper(self, *args, **kwargs): if 'verify' not in kwargs: kwargs['verify'] = False; init_method(self, *args, **kwargs); return wrapper

httpx.Client.__init__ = _make_ssl_patch(httpx.Client.__init__)

httpx.AsyncClient.__init__ = _make_ssl_patch(httpx.AsyncClient.__init__)

Axiom

Axiom是一个浏览器扩展，用于自动化重复任务和web抓取。

下载

3、确保该脚本在Agent启动前被导入：编辑~/.hermes/hermes-agent/__init__.py（若不存在则新建），添加一行import hermes_agent_ssl_patch。