Hermes Agent进阶工具按需配置策略与技巧

Hermes Agent 运行一周后，对话与记忆积累已趋于稳定。下一步，需要将其从对话引擎扩展到可执行操作——操控网页、运行终端命令、读写文件。这些能力默认关闭，必须手动启用。否则，所有操作指令都会返回“相关工具模块未激活”的提示。

诊断工具模块激活状态

开始配置前，先快速扫描当前工具模块状态。运行诊断命令：

hermes doctor --tools

hermes doctor --tools 将输出所有工具模块的启用标记。每条工具后跟✅（已启用）或❌（禁用）。注意：该检查仅验证配置声明，不测试浏览器是否可执行或命令行是否可达。

例如，若输出显示 web_scraping: false 而你计划让 Agent 采集网页数据，或 terminal_commands: false 但需要执行脚本，则必须手动启用对应模块。

分场景启用关键工具模块

编辑核心配置文件 ~/.hermes/config.yaml，定位到 platform.tools 区块。

按使用场景分别处理：

• 网页自动化（依赖Camofox）
  将 browser_operations 与 web_scraping 均设为 true。若缺失此配置，Hermes 无法启动浏览器实例。Camofox 是必需组件而非可选插件——未安装时，任何点击、输入、滚动指令均会立即失败，不可跳过。
• 终端命令执行
  设置 terminal_commands 为 true。⚠️ 安全警告：启用后，Agent 获得终端 Shell 执行权限，可运行任意命令（含破坏性命令如 rm -rf /）。Hermes 不会每次询问确认，仅在日志中记录“正在执行危险命令”。请确认操作后果后再开启。
• 文件读写与解析
  启用 file_operations，并检查 allowed_extensions 列表。该列表限定 Agent 可处理的文件格式。默认仅包含 .txt 和 .log。若需处理 PDF、Markdown、CSV 等文件，手动添加对应扩展名（如 .pdf、.md、.csv）。列表外的文件将被静默拒绝访问。

验证工具有效性

修改配置后，必须执行以下验证步骤，确保工具就绪。

第一步：重启服务
使配置生效。执行：

hermes stop && hermes start

第二步：功能验证
通过简单任务测试文件操作。在对话界面发送：请读取 ~/.hermes/memories/user.md 的前5行。若成功返回内容，则 file_operations 工作正常。若返回“权限被拒”或“模块未启用”，则配置未生效或文件权限异常。

第三步：集成测试
执行联调任务，检查网页操作与文件保存的协同。发送：打开 https://example.com，截图首页，保存为 screenshot.png。若成功，则 browser_operations 与 file_operations 均就绪。若失败，优先确认 Camofox 是否正确安装。注意：Camofox 不会随 hermes setup 自动安装，需单独运行 hermes setup camofox 初始化。