Hermes Agent: CLI 命令行

最后更新:2026-08-31

CLI 是 Hermes Agent 最强大的操作方式——所有功能都能通过命令行完成,支持脚本集成、批量操作、自动化流水线。

💡 提示:CLI 是开发者最高效的 Hermes 使用方式。桌面版和 Web 版覆盖 80% 功能,CLI 覆盖 100%。自动化场景必须用 CLI。

📋 前置知识:第2课 安装、第3课 配置文件

1. 你将学到

编号 内容
CLI 命令总览
核心命令详解
对话与交互命令
管理与运维命令
脚本集成与自动化

2. 故事

(1) 痛点:每次都要手动操作

Bob 每天:打开 Hermes → 切换模型 → 开始对话 → 保存结果 → 发送通知。5 个手动步骤,烦且容易忘。

(2) 解法:一条命令搞定

Alice 写了一个脚本,每天自动执行:

BASH
#!/bin/bash
# daily-workflow.sh
hermes chat --model gpt-4o --skill daily-briefing --output report.md
hermes notify telegram --file report.md
hermes checkpoint save "daily-$(date +%Y%m%d)"

3. CLI 命令总览

(1) 命令分类

类别 命令 说明
核心 hermes chat 交互式对话
hermes serve 启动 API 服务
hermes run 单次执行任务
配置 hermes init 初始化
hermes config 配置管理
hermes model 模型管理
记忆 hermes memory 记忆管理
技能 hermes skill 技能管理
工具 hermes tool 工具管理
平台 hermes platform 平台管理
定时 hermes cron 定时任务
检查点 hermes checkpoint 检查点管理
委托 hermes delegate 委托任务
插件 hermes plugin 插件管理
仪表盘 hermes dashboard 数据面板
Profile hermes profile 用户配置

4. 核心命令详解

(1) hermes chat

BASH
# 基础对话
hermes chat

# 指定模型
hermes chat --model gpt-4o

# 指定用户
hermes chat --user alice

# 指定技能
hermes chat --skill code-review

# 非交互模式(单次输入)
hermes chat --message "审查 src/main.py" --no-interactive

# 管道输入
cat error.log | hermes chat --message "分析这个错误日志"

# 指定工具集
hermes chat --toolset frontend-dev

# 输出到文件
hermes chat --output report.md

(2) hermes run

BASH
# 单次任务执行
hermes run "搜索 React 19 新特性并生成摘要"

# 指定模型和技能
hermes run --model gpt-4o --skill research "调研 Vue 4 的变化"

# 委托模式
hermes run --delegate --max-sub-agents 3 "审查整个项目的代码质量"

# 输出格式
hermes run --format json "分析这个 API 的响应格式"

(3) hermes serve

BASH
# 启动 API 服务
hermes serve --host 0.0.0.0 --port 8080

# 后台运行
hermes serve --daemon

# 指定配置
hermes serve --config /path/to/config.yaml

# 启用所有平台
hermes serve --platforms telegram,discord,slack

5. 对话与交互命令

(1) 对话内命令

hermes chat 交互模式中,以 / 开头的命令:

命令 功能
/learn <内容> 教 Agent 新技能
/remember <内容> 保存记忆
/forget <id> 删除记忆
/skill <名称> 调用技能
/model <名称> 切换模型
/toolset <名称> 切换工具集
/profile <名称> 切换用户
/checkpoint save <名称> 保存检查点
/checkpoint restore <名称> 恢复检查点
/delegate status 查看委托状态
/honcho profile 查看用户画像
/cost 查看当前会话成本
/help 帮助
/exit 退出

(2) 对话快捷键

快捷键 功能
↑/↓ 浏览历史输入
Tab 自动补全命令/技能/工具名
Ctrl+C 中断当前操作
Ctrl+D 退出对话
Ctrl+L 清屏

6. 管理与运维命令

(1) 配置管理

BASH
# 查看配置
hermes config show
hermes config get model.default
hermes config get memory.working_memory_limit

# 设置配置
hermes config set model.default gpt-4o
hermes config set personality.tone professional

# 验证配置
hermes config validate

# 导出/导入
hermes config export > backup.yaml
hermes config import backup.yaml

# 重置
hermes config reset

(2) 模型管理

BASH
# 列出可用模型
hermes model list

# 测试模型连接
hermes model test gpt-4o

# 添加自定义模型
hermes model add --name my-model --provider ollama

# 查看模型详情
hermes model info gpt-4o

(3) 健康检查

BASH
# 完整健康检查
hermes doctor

# 快速检查
hermes health

# 查看版本
hermes --version

# 查看系统信息
hermes info

7. 脚本集成与自动化

(1) Shell 脚本集成

BASH
#!/bin/bash
# CI/CD 集成示例

# 1. 代码审查
hermes run --skill code-review --output review.md "审查 PR #$PR_NUMBER"

# 2. 检查审查结果
if grep -q "🔴 严重" review.md; then
  echo "发现严重问题,阻止合并"
  exit 1
fi

# 3. 运行测试
hermes run --skill test-runner "运行完整测试套件"

# 4. 生成发布说明
hermes run --model gpt-4o --output CHANGELOG.md "根据 git log 生成发布说明"

(2) Python 集成

PYTHON
from hermes import HermesClient

client = HermesClient(base_url="http://localhost:8080")

# 发送消息
response = client.chat(
    message="审查这个文件的代码质量",
    model="gpt-4o",
    files=["src/main.py"]
)

print(response.text)

# 批量执行
results = client.batch_run([
    {"message": "搜索 React 19", "model": "gpt-4o-mini"},
    {"message": "搜索 Vue 4", "model": "gpt-4o-mini"},
    {"message": "搜索 Svelte 5", "model": "gpt-4o-mini"},
])

for r in results:
    print(f"Task: {r.task}, Cost: ${r.cost:.4f}")

(3) Makefile 集成

MAKEFILE
.PHONY: review test deploy

review:
	hermes run --skill code-review "审查所有修改的文件"

test:
	hermes run --skill test-runner "运行测试套件"

deploy: review test
	hermes run "部署到 staging 环境"
	@echo "部署完成"

❓ 常见问题

Q CLI 支持 Windows 吗?
A 支持。PowerShell 和 CMD 都可运行。部分管道功能在 WSL2 中体验更好。
Q 如何查看命令帮助?
A hermes --help 查看全局帮助,hermes chat --help 查看子命令帮助。
Q 非交互模式适合什么场景?
A 脚本集成、CI/CD、定时任务、批量处理。不需要人工交互的自动化场景。
Q 如何并行运行多个任务?
A Shell 后台运行 hermes run ... & 或 Python 多线程。CLI 本身支持 --delegate 并行。
Q CLI 日志在哪里?
A 默认 ~/.hermes/logs/hermes chat --verbose 实时显示详细日志。
Q 如何调试 CLI 问题?
A hermes chat --debug 启用调试模式,输出完整的工具调用和模型请求。

📖 小节


📝 作业

  1. 基础题(难度⭐):使用 CLI 完成一次完整流程:初始化 → 对话 → 保存检查点 → 查看成本。
  2. 进阶题(难度⭐⭐):编写 Shell 脚本,用 hermes run 自动完成代码审查+测试+生成报告。
  3. 挑战题(难度⭐⭐⭐):用 Python HermesClient 开发一个自动化工作流:每天定时拉取 Git 日志 → 生成日报 → 发送通知,集成到 cron。
Web-Tutorial.com

Web-Tutorial 技术团队

由多位开发者共同维护的编程教程平台。每篇教程由对应领域的开发者编写和审核,确保内容准确可靠。如发现任何问题,欢迎向我们反馈。

100%

🙏 帮我们做得更好

我们是刚上线的编程教程站,几个人的小团队,精力有限。页面虽经检查,难免还有疏漏——链接失效、排版错乱、内容有误、语言生硬……

如果您发现了,麻烦告诉我们,我们会在收到反馈后第一时间进行修复,再次感谢您的光临 🙏