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 启用调试模式,输出完整的工具调用和模型请求。📖 小节
- CLI 覆盖 100% 功能,是开发者最高效的操作方式
hermes chat交互对话,hermes run单次任务,hermes serveAPI 服务- 对话内
/命令:技能、记忆、模型、检查点 - 管理命令:config、model、health、doctor
- 脚本集成:Shell、Python、Makefile,实现自动化流水线
📝 作业
- 基础题(难度⭐):使用 CLI 完成一次完整流程:初始化 → 对话 → 保存检查点 → 查看成本。
- 进阶题(难度⭐⭐):编写 Shell 脚本,用
hermes run自动完成代码审查+测试+生成报告。 - 挑战题(难度⭐⭐⭐):用 Python HermesClient 开发一个自动化工作流:每天定时拉取 Git 日志 → 生成日报 → 发送通知,集成到 cron。