运行hermes gateway setup卡住或报ModuleNotFoundError: No module named 'aiohttp'，说明Hermes微信网关因缺少aiohttp库无法启动；需先验证python -c "import aiohttp"是否报错，再通过三种方式之一安装aiohttp与cryptography，最后执行hermes gateway restart --force-weixin并验证日志及微信消息响应。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在终端运行 hermes gateway setup 选择 Weixin 后，屏幕卡住、无二维码输出，或直接报错 ModuleNotFoundError: No module named 'aiohttp'，说明 Hermes 微信网关因缺少核心通信库而无法启动——这不是配置问题，是环境缺失的硬性阻断。
确认是否真缺 aiohttp
在终端执行：python -c "import aiohttp"。如果报错，就是确实没装；如果静默返回，说明已存在，问题出在别处，可跳过后续步骤。
安装 aiohttp 的三种方法
方法一：用 Hermes 自带虚拟环境安装（推荐，95%用户适用）
先定位 Hermes 的 venv 路径：which hermes → 通常输出类似 /home/username/.local/bin/hermes，那么 venv 就在 /home/username/.local/ 下；
激活它：source ~/.local/bin/activate；
再安装：pip install aiohttp cryptography。【必须激活后再 pip，否则装到系统 Python 里，Hermes 仍找不到】
方法二：绕过系统 pip 限制，直装进 Hermes Agent 项目目录
进入 Hermes Agent 核心路径：cd ~/.hermes/hermes-agent；
执行：~/.hermes/hermes-agent/venv/bin/pip install aiohttp cryptography；
这行命令跳过了环境激活步骤，强制写入指定 venv，适合被 externally-managed-environment 锁死的 Ubuntu/Debian 系统。
方法三：用系统包管理器安装（仅限 Linux，最稳）
执行：sudo apt update && sudo apt install -y python3-aiohttp python3-cryptography python3-qrcode；
该方式由系统包管理器统一维护，不与 pip 冲突，且自动适配 Python 版本；【若你之前装过 pip 版 aiohttp 却仍报错，优先用此法覆盖】
name wechat-article-writer-pro description 微信公众号文章完整生成技能（专业版）。输入主题即自动完成：信息调研、文章撰写（含章节配图）、5个备选爆款标题、封面图生成、带格式排版的DOCX文档输出。触发词：写公众号文章、生成公众号内容、做微信推文、公众号文章完整版。 agent_created true 微信公众号文章完整生成技能（专业版） 概述 本技能提供微信公众号文章从主题到成品的完整生成流程，在基础版之上增加：章节配图、DOCX 格式输出（含彩色重点文字和表格
验证并重启微信网关
第一步：检查依赖是否就位
运行：python -c "import aiohttp, cryptography" → 无报错即成功。
第二步：强制重载微信网关配置
执行：hermes gateway restart --force-weixin；
该命令会清空旧会话、重新拉取凭证，并跳过缓存校验——比单纯 hermes gateway setup 更彻底。
第三步：观察终端日志
等待出现 weixin gateway started 和 listening for messages 两行关键提示；
此时立刻打开微信，搜索「微信Clawbot」发一条“测试”，5 秒内收到回复即表示 aiohttp 缺失问题已解除。
