hermes agent v0.17.0官方安装脚本在国内直接运行会因raw.githubusercontent.com被干扰、pypi.org超时、playwright.azureedge.net证书校验失败而卡在github克隆/uv解析/chromium下载环节，成功率低于5%；换用国内cdn托管的优化脚本curl -fssl https://res1.hermesagent.org.cn/install.sh | bash可一键解决，覆盖github、pypi、node.js、npm、termux五类源，并需确保~/.bashrc有写权限。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Hermes Agent v0.17.0官方安装脚本在国内直接运行会卡在GitHub克隆、uv依赖解析或Playwright Chromium下载任一环节，根本原因是脚本默认调用境外源——raw.githubusercontent.com被干扰、pypi.org响应超时、playwright.azureedge.net证书校验失败，三道网络墙叠加导致安装成功率低于5%。
换国内镜像源一键执行
直接使用已替换全部境外地址的优化版脚本，覆盖GitHub克隆、PyPI、Node.js、npm、Termux五类源：
执行命令：curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash
该地址托管于国内CDN，所有资源均经镜像加速。若提示command not found: curl，先运行sudo apt update && sudo apt install -y curl（Ubuntu/Debian）或brew install curl（macOS）。
【必须确认终端当前用户有~/.bashrc写权限】，否则环境变量无法注入，后续hermes命令不可用。可用ls -l ~/.bashrc检查，若显示-r--r--r--则需先执行chmod u+w ~/.bashrc。
手动分步修复卡点
当一键脚本仍失败（如WSL2中apt未更新或DNS异常），按以下顺序逐项处理：
第一步：强制刷新DNS并测试基础连通性 → echo "nameserver 8.8.8.8" | sudo tee /etc/resolv.conf && curl -I https://mirror.ghproxy.com
第二步：若返回HTTP 200，则继续 → 克隆仓库：git clone https://mirror.ghproxy.com/https://github.com/NousResearch/hermes-agent.git ~/.hermes/hermes-agent
第三步：跳过uv自动安装，改用清华源pip → 进入目录后执行：python3.11 -m pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ --upgrade pip && python3.11 -m pip install -e ".[all]"
第四步：Playwright Chromium手动安装 → 运行：npx playwright install-deps chromium && npx playwright install --with-deps chromium，该命令会自动从淘宝镜像拉取二进制依赖。
飞书/微信网关插件失效补救
v0.17.0起飞书插件不再默认安装，且容器内权限限制导致静默禁用：
方法一（Docker用户）：进入容器终端 → 执行pip install lark-oapi==1.5.3 → 再执行chmod -R o+rX /opt/data/.local/lib/python3.13/site-packages/
方法二（本地部署）：在Hermes Agent根目录下运行pip install --user lark-oapi==1.5.3，无需修权限。
微信插件同理，需单独安装wechaty-puppet-wechaty，命令为：pip install --user wechaty-puppet-wechaty。
