Hermes-Agent：踩坑与常见问题
目录
排障分层：先判断是哪一类问题
建议按「环境 → 配置 → 网关 → 工具链」分层定位，避免在错误层级里调参：
平台与安装
Q：Windows 能原生安装吗？
A：官方 README 写明 不支持原生 Windows，请使用 WSL2（README 给出 Microsoft 文档链接）。原因通常是脚本依赖、路径差异与生态支持范围，不建议硬扛。
Q：Android / Termux 安装失败或依赖冲突？
A：README 指出 .[all] extra 可能拉取 不兼容 Android 的语音依赖；请按官方 Termux guide 使用 curated extra，而不是盲目装全量依赖。
Q：安装脚本执行了但 hermes 命令没有？
A：检查 shell 是否 reload、PATH 是否包含安装目录；必要时重新打开终端。
模型与提供商
Q：hermes model 里模型很多，怎么选？
A：先选你已有账号与合规允许的 provider；再按任务选「工具调用稳定」的模型。配置总览见 Configuration。
Q：切换模型后行为不一致？
A：不同模型的工具调用与遵循指令能力差异很大；把「成功标准」写进工作区/技能，而不是只靠对话里临时提醒。
Q：调用很慢但不确定慢在哪？
A：先区分：模型推理慢、工具慢、还是网络慢；结合日志与 doctor 输出定位。
Gateway 与消息渠道
Q：CLI 正常，IM 没反应？
A：先确认 hermes gateway 是否按文档启动并完成平台侧配置；对照 Messaging Gateway 逐步核对（token、webhook、权限、频道可见性等）。
Q：Slash 命令记不住？
A：用 README 的「CLI vs Messaging Quick Reference」表作为速查；更全列表见 CLI guide。
工具与 MCP
Q：工具开了太多，结果不可控？
A：回到 最小工具集原则；阅读 Tools & Toolsets 的分组逻辑，并对高风险工具加审批（见 Security）。
Q：MCP 接了但调用失败？
A：检查 MCP server 是否可达、凭证是否正确、以及是否被网络策略拦截；详见 MCP Integration。
记忆、技能与隐私
Q：记忆会不会把敏感数据写进去？
A：会——取决于你怎么用它。请阅读 Memory 的最佳实践，并在组织场景做脱敏与留存策略。
Q：技能和 OpenClaw 导入冲突？
A：迁移目录与覆盖策略见 hermes claw migrate --help；大规模迁移前先 --dry-run。
与 OpenClaw 迁移相关
Q：迁移后密钥是否要重新审计？
A：建议默认要。迁移节省时间，但不等于安全审查可以省略。
Q：迁移完想回退？
A：保留 OpenClaw 工作区备份；Hermes 与 OpenClaw 并行运行会带来渠道与身份冲突，通常不建议「双写」同一 bot token。
Q：迁移命令原文在哪？
A：见 Migrating from OpenClaw。