Hermes-Agent API 手册¶
命令行接口¶
hermes chat¶
交互式聊天或单次查询。
hermes chat [options]
# 常用选项
-q, --query TEXT # 单次查询内容
-m, --model MODEL # 指定模型 (e.g., deepseek/deepseek-chat-v4-flash)
-Q, --quiet # 安静模式，只输出响应
-c, --continue # 继续上次会话
-r, --resume SESSION # 恢复指定会话
--pass-session-id # 传递会话 ID
--yolo # 跳过确认直接执行
--dev # 调试模式
-t, --tui # 启用 TUI 界面
hermes model¶
模型和 Provider 管理。
hermes model [options]
# 选项
--portal-url URL # Nous Portal 地址
--inference-url URL # 推理 API 地址
--no-browser # 不自动打开浏览器
hermes skills¶
Skills 管理。
hermes skills <command> [options]
# 子命令
browse # 浏览可用 skills
search [keyword] # 搜索 skills
install <skill-name> # 安装 skill
list # 列出已安装
inspect <skill-name> # 预览 skill（不安装）
update [skill-name] # 更新 skill
uninstall <skill-name> # 卸载 skill
config <skill-name> # 配置 skill
hermes sessions¶
会话管理。
hermes sessions <command>
# 子命令
list # 列出所有会话
export <name> # 导出会话
import <file> # 导入会话
delete <name> # 删除会话
hermes config¶
配置管理。
hermes config <command>
# 子命令
get <key> # 获取配置项
set <key> <value> # 设置配置项
list # 列出所有配置
edit # 编辑配置文件
hermes status¶
查看系统状态。
hermes memory¶
记忆管理。
hermes memory <command>
# 子命令
list # 列出记忆
add <content> # 添加记忆
search <query> # 搜索记忆
delete <id> # 删除记忆
环境变量¶
| 变量 | 说明 | 示例 |
|---|---|---|
DEEPSEEK_API_KEY |
DeepSeek API Key | sk-xxxxxxxx |
DEEPSEEK_API_BASE |
DeepSeek API 地址 | https://api.deepseek.com/v1 |
OPENROUTER_API_KEY |
OpenRouter API Key | sk-or-v1-xxx |
DEFAULT_MODEL |
默认模型 | deepseek/deepseek-chat-v4-flash |
DEFAULT_PROVIDER |
默认 Provider | openrouter |
HERMES_HOME |
Hermes 配置目录 | ~/.hermes |
配置文件¶
位置：~/.hermes/
~/.hermes/
├── .env # 环境变量
├── config.json # 主配置
├── skills/ # Skills 配置
├── memory/ # 记忆存储
├── sessions/ # 会话历史
└── logs/ # 日志文件
退出码¶
| 退出码 | 含义 |
|---|---|
| 0 | 成功 |
| 1 | 一般错误 |
| 2 | 配置错误 |
| 130 | 用户中断 (Ctrl+C) |
快捷键（TUI 模式）¶
| 快捷键 | 功能 |
|---|---|
Ctrl+C |
中断当前操作 |
Ctrl+D |
退出 |
Ctrl+L |
清屏 |
Tab |
自动补全 |
↑/↓ |
历史命令 |