HermesAgent脚本编写入门指南

想让Hermes Agent真正听你指挥、自动完成网页抓取、命令执行、文件处理等复杂任务？关键不在写Python或Shell脚本，而在于掌握其专属的YAML技能（Skill）编写艺术——从定义结构化任务流程、串联内置工具链、注入动态变量，到设置确认机制、绑定SOUL.md人格约束，再到CLI一键注册调试，整套方法既声明式简洁又具备生产级可控性，助你快速构建可复用、可调度、有边界感的智能自动化能力。

如果您希望让Hermes Agent执行结构化、可复用、可调度的自动化任务，则需通过编写脚本实现。Hermes Agent本身不依赖传统编程语言脚本文件（如.py或.sh），而是基于其内置技能（Skill）系统，以 YAML 格式定义任务流程与工具调用逻辑。以下是编写 Hermes Agent 脚本的核心方法：

一、使用 Skill YAML 定义可复用技能

Hermes Agent 的“脚本”本质是 Skill 文件，存放在 ~/.hermes/skills/ 目录下，以 .yaml 后缀命名。每个 Skill 描述一个完整任务单元，包含触发条件、输入参数、执行步骤与输出格式。

1、在终端中进入技能目录：
cd ~/.hermes/skills/

2、创建新技能文件：
touch web_scrape_summary.yaml

3、用文本编辑器打开该文件，填入标准 YAML 结构：

4、确保 skill.name 字段唯一且不含空格，例如 use_web_scrape_summary

5、在 steps 列表中按顺序声明工具调用，每个 step 必须包含 tool 和 input 字段

二、调用内置工具组合构建脚本逻辑

Hermes Agent 提供数十种预置工具（如 browser、shell、file、code、image_gen），脚本通过串联这些工具形成执行链。工具调用支持变量注入与上下文传递，无需硬编码值。

1、在 YAML 的 input 字段中使用双大括号语法引用上下文变量，例如 {{ query }} 或 {{ url }}

2、在 step 中指定 tool: browser，并设置 input: { url: "{{ url }}", action: "scrape" }

3、后续 step 可直接使用前一步 output 中的 key，例如 {{ previous_step.summary }}

4、为防止敏感操作误执行，对 shell 或 file.write 类工具，必须显式添加 confirm: true 字段

三、通过 CLI 注册并测试自定义脚本

YAML 文件保存后需注册进 Hermes 运行时环境才能被识别和调用。注册过程会校验语法、工具可用性及参数完整性，失败时返回具体错误位置。

1、执行注册命令：
hermes skill register web_scrape_summary.yaml

2、查看已注册技能列表：
hermes skill list

3、手动触发测试运行：
hermes skill run use_web_scrape_summary --url "https://example.com"

4、若提示 tool not found，检查 ~/.hermes/.env 中是否启用对应插件，例如 ENABLE_BROWSER=true

四、利用 SOUL.md 约束脚本行为风格

SOUL.md 是 Hermes Agent 的人格配置文件，位于 ~/.hermes/SOUL.md。它不直接执行逻辑，但深度影响脚本输出的语气、长度、技术深度与安全边界，属于脚本运行的隐式上下文层。

1、打开 SOUL.md 文件：
vim ~/.hermes/SOUL.md

2、在文件末尾添加约束块：
```behavior_constraints
- 拒绝生成任何可执行二进制文件路径
- 输出摘要不得超过 300 字
- 所有代码示例必须带注释说明用途```

3、保存后重启 Hermes 进程使约束生效：
killall hermes && hermes start

4、再次运行同一脚本，观察输出是否符合新增约束

五、调试脚本执行流程与错误定位

脚本执行失败时，Hermes 默认仅返回简短错误消息。需启用详细日志模式才能查看每一步工具输入、输出、耗时与异常堆栈，这对修复 YAML 语法错误、参数类型不匹配或工具权限问题至关重要。

1、临时启用调试日志：
hermes skill run use_web_scrape_summary --debug --url "https://example.com"

2、日志中定位含 ERROR 或 FAILED 的行，重点关注 tool 返回状态码与 stderr 内容

3、若报错 Permission denied for file.write，检查 ~/.hermes/ 目录所属用户是否与当前运行用户一致

4、若 browser 工具超时，确认 CAMOFOX_URL 环境变量已正确配置且服务进程正在运行

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于科技周边的相关知识，也可关注golang学习网公众号。