一、启动与会话
容器内启动方式
# 容器内（venv 已激活）:
hermes # 新会话
hermes -c # 继续最后会话
hermes -c 名称 # 继续指定名称会话
hermes --resume <session_id> # 恢复指定 ID 会话
# 宿主机 docker exec:
docker exec -it hermes-agent-at /opt/hermes/.venv/bin/hermes
docker exec -it hermes-agent-at /opt/hermes/.venv/bin/hermes -c
| 命令/选项 | 用途 |
|---|
hermes | 默认交互式聊天（chat） |
hermes chat -q "xxx" | 单次查询模式，输出后退出 |
hermes -z "prompt" | One-shot 模式，仅输出回复文本，用于脚本管道 |
-c, --continue [名称] | 继续最近/指定名称的会话 |
-r, --resume <id> | 按 ID 恢复指定会话 |
-m, --model MODEL | 临时切换模型 |
--provider PROVIDER | 临时切换提供商 |
-t, --toolsets LIST | 指定启用的工具集（逗号分隔） |
-s, --skills SKILLS | 预加载技能 |
-w, --worktree | 隔离 git worktree 模式（并行 agent） |
--yolo | 跳过危险命令审批 |
sessions list | 列出最近会话 |
sessions browse | 交互式会话选择器 |
sessions rename <id> <t> | 重命名会话 |
sessions delete <id> | 删除会话 |
sessions export <file> | 导出为 JSONL |
sessions prune | 清理旧会话（--older-than N days） |
二、本体配置
| 命令 | 用途 |
|---|
setup | 交互式设置向导（model/terminal/gateway/tools/agent） |
model | 选择默认模型和提供商 |
fallback | 管理后备提供商链（主模型失败时尝试） |
config | 查看和编辑配置（edit / set / path / check / migrate） |
doctor [--fix] | 检查配置和依赖，--fix 自动修复 |
status | 显示所有组件状态 |
login <provider> | OAuth 登录（nous / openai-codex / qwen-oauth） |
logout | 清除已存储的认证 |
auth | 管理池化凭证（add/list/remove/reset） |
pairing | 管理 DM 配对码（用户授权） |
profile | 多配置管理（list/create/use/delete/export/import） |
memory | 配置外部记忆提供者 |
update / version | 更新到最新版本 / 查看版本信息 |
backup / import | 备份/恢复 Hermes home 目录 |
insights [--days N] | 使用分析 |
uninstall | 卸载 Hermes |
三、平台与能力扩展
| 命令 | 用途 |
|---|
gateway | 消息网关管理（run/install/start/stop/restart/status/setup） |
skills | 技能管理（list/search/install/uninstall/config/check/update/publish） |
tools | 工具开关管理（list/enable/disable，交互式 UI） |
mcp | MCP 服务器管理（list/add/remove/test/configure） |
plugins | 插件管理（list/install/remove） |
curator | 后台技能维护（status/run/pause/pin） |
cron | 定时任务管理（list/create/edit/pause/resume/run/remove） |
webhook | 动态 Webhook 订阅管理 |
logs | 查看日志（-f 实时跟踪，errors 错误日志，--since 1h 按时间） |
dashboard | 启动/停止/查看 Web UI（--stop / --status） |
dump / debug | 输出设置摘要 / 上传日志用于排查 |
proxy | 本地 OpenAI 兼容代理（OAuth 提供商） |
lsp | 语言服务器协议管理 |
acp | 运行 ACP（Agent Client Protocol）服务器 |
computer-use | 管理 Computer Use 后端（macOS） |
completion bash|zsh|fish | 生成 Shell 补全脚本 |
postinstall | 引导 pip 安装后的非 Python 依赖 |
hooks | 检查和管理 Shell Hook |