一、安装与升级（8 条）
| 命令 |
作用 |
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash |
一行命令安装 |
curl -fsSL https://ghproxy.com/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash |
国内镜像版安装 |
hermes --version |
查看版本 |
hermes upgrade |
升级到最新版 |
hermes upgrade --beta |
升级到 beta 版 |
hermes upgrade --version 0.7.5 |
指定版本 |
hermes uninstall |
卸载（保留 ~/.hermes） |
hermes uninstall --purge |
完全卸载（含数据） |
二、初始化与配置（10 条）
| 命令 |
作用 |
hermes setup |
交互式配置向导 |
hermes setup --reset |
重置后重新配置 |
hermes config edit |
用默认编辑器打开 config.yaml |
hermes config edit SOUL |
编辑 SOUL.md |
hermes config get <key> |
读某项配置 |
hermes config set <key> <value> |
设某项配置 |
hermes config unset <key> |
取消某项配置 |
hermes config list |
列出所有配置 |
hermes config export ~/backup.yaml |
导出配置 |
hermes config import ~/backup.yaml |
导入配置 |
三、健康与诊断（6 条）
| 命令 |
作用 |
hermes doctor |
体检：网络/模型/工具/存储 |
hermes doctor --verbose |
详细体检 |
hermes doctor --fix |
自动修复能修的 |
hermes mind |
Dashboard：会话/记忆/技能统计 |
hermes status |
看 Hermes 是否在运行 |
hermes ping |
测试 API 连通性 |
四、模型管理（8 条）
| 命令 |
作用 |
hermes model |
看当前用的模型 |
hermes model list |
列出所有可用模型 |
hermes model set <name> |
切换默认模型 |
hermes model test <name> |
测试某模型连通 + 速度 |
hermes model cost |
看本月各模型花费 |
hermes model fallback add <name> |
加一个兜底模型 |
hermes model routing edit |
编辑路由规则 |
hermes model budget set monthly 30 |
设月度预算（美元） |
五、交互模式与基本对话（8 条）
| 命令 |
作用 |
hermes |
启动交互模式 |
hermes --voice |
启动语音模式 |
hermes --continue |
接最近一次对话 |
hermes --continue <session-id> |
接指定会话 |
hermes --new |
强制开新会话 |
hermes -p "..." |
一次性提示词，跑完就退出 |
hermes -m claude-opus-4 "..." |
临时指定模型 |
hermes -w |
在 git worktree 模式启动 |
六、交互模式内置斜杠命令（10 条）
| 命令 |
作用 |
/help |
看所有可用命令 |
/exit 或 Ctrl+D |
退出 |
/clear |
清空当前上下文（不删长期记忆） |
/model <name> |
切换本次对话用的模型 |
/save <text> |
把这句话存入持久记忆 |
/recall <keyword> |
从持久记忆唤起相关条目 |
/skills |
看可用 Skill 列表 |
/skill run <name> |
直接跑某个 Skill |
/tools |
看可用工具 |
/tool toggle <name> |
临时启用/禁用某工具 |
七、工具管理（8 条）
| 命令 |
作用 |
hermes tools |
看所有工具及状态 |
hermes tools enable <name> |
启用 |
hermes tools disable <name> |
禁用 |
hermes tools enable "browser.*" |
启用一类 |
hermes tools confirm <name> |
设为"需要每次确认" |
hermes tools allowlist add <path> |
加允许访问的路径 |
hermes tools denylist add <path> |
加禁止访问的路径 |
hermes tools usage --last 7d |
看工具调用统计 |
八、MCP 服务器（6 条）
| 命令 |
作用 |
hermes mcp list |
看已配置的 MCP 服务器 |
hermes mcp add <name> <config> |
添加 MCP 服务器 |
hermes mcp remove <name> |
移除 |
hermes mcp test <name> |
测试 MCP 服务器是否能连 |
hermes mcp restart <name> |
重启某个 |
hermes mcp install agentskills/<name> |
从社区安装 |
九、记忆管理（10 条）
| 命令 |
作用 |
hermes memory list |
看所有记忆 |
hermes memory search <keyword> |
搜记忆 |
hermes memory add "..." |
手动加一条 |
hermes memory delete <id> |
删一条 |
hermes memory edit <id> |
编辑某条 |
hermes memory export ~/backup/memory.json |
导出 |
hermes memory import ~/backup/memory.json |
导入 |
hermes memory rebuild |
重建索引 |
hermes memory user-profile generate |
生成用户画像 |
hermes memory prune --older-than 1y |
清理 1 年以上记忆 |
十、Skills（10 条）
| 命令 |
作用 |
hermes skill list |
看所有 Skill |
hermes skill show <name> |
看 Skill 内容 |
hermes skill edit <name> |
编辑 |
hermes skill run <name> [args] |
直接跑 |
hermes skill delete <name> |
删除 |
hermes skill export <name> > out.md |
导出单个 |
hermes skill export-all ~/skills-backup/ |
导出所有 |
hermes skill import out.md |
导入 |
hermes skill install agentskills/<name> |
从社区装 |
hermes skill publish <name> |
发布到社区 |
十一、定时任务 / Cron（10 条）
| 命令 |
作用 |
hermes schedule "<自然语言描述>" |
用自然语言创建任务 |
hermes schedule --cron "0 8 * * *" --task "..." |
用 cron 表达式创建 |
hermes schedule list |
看所有任务 |
hermes schedule show <id> |
看某个任务详情 |
hermes schedule pause <id> |
暂停 |
hermes schedule resume <id> |
恢复 |
hermes schedule remove <id> |
删除 |
hermes schedule run <id> |
立即跑一次 |
hermes schedule run <id> --dry-run |
模拟跑（不真做） |
hermes schedule history <id> |
看历史执行记录 |
十二、工作流 Workflow（5 条）
| 命令 |
作用 |
hermes workflow list |
看所有工作流 |
hermes workflow enable <name> |
启用 |
hermes workflow disable <name> |
禁用 |
hermes workflow run <name> --inputs '{...}' |
手动跑 |
hermes workflow validate <file> |
验证 yaml 格式 |
十三、网关 Gateway（10 条）
| 命令 |
作用 |
hermes gateway list |
看所有 Gateway |
hermes gateway setup <type> |
配某个 Gateway |
hermes gateway start <type> |
启动 |
hermes gateway start --all |
启动所有已配置的 |
hermes gateway stop <type> |
停止 |
hermes gateway restart <type> |
重启 |
hermes gateway status |
看在线状态 |
hermes gateway config <type> --allowed-users a,b,c |
设白名单 |
hermes gateway logs <type> --follow |
实时看日志 |
hermes gateway test <type> |
测试连通 |
十四、子代理 Subagent（5 条）
| 命令 |
作用 |
hermes subagent list --active |
看正在跑的子代理 |
hermes subagent kill <id> |
杀掉某个 |
hermes subagent kill-all |
杀所有子代理 |
hermes subagent stats |
子代理统计 |
hermes subagent budget set 0.50 |
设子代理预算 |
十五、执行后端 Terminal Backend（5 条）
| 命令 |
作用 |
hermes backend list |
看所有支持的后端 |
hermes backend set <name> |
切换默认后端 |
hermes backend test <name> |
测试某后端 |
hermes backend docker rebuild |
重新构建 Docker 镜像 |
hermes backend ssh setup <host> |
配 SSH 后端 |
十六、ACP / IDE 集成（4 条）
| 命令 |
作用 |
hermes acp start |
启动 ACP 服务（默认端口 9123） |
hermes acp start --port 9124 |
自定端口 |
hermes acp stop |
停止 |
hermes acp status |
看是否在跑 |
十七、会话管理（5 条）
| 命令 |
作用 |
hermes sessions list |
看历史会话 |
hermes sessions show <id> |
看某次会话内容 |
hermes sessions search <keyword> |
搜某话题 |
hermes sessions export <id> > out.md |
导出 |
hermes sessions prune --older-than 90d |
清理 90 天前会话 |
十八、备份与导入（5 条）
| 命令 |
作用 |
hermes export --all ~/backup.tar.gz |
全量备份 |
hermes import ~/backup.tar.gz |
导入 |
hermes sync push |
推到云端（如果配了 sync） |
hermes sync pull |
从云端拉 |
hermes sync status |
看同步状态 |
十九、调试与日志（6 条）
| 命令 |
作用 |
hermes logs tail |
看实时日志 |
hermes logs tail --follow |
跟踪 |
hermes logs tail --schedule <id> |
只看某任务的 |
hermes audit review --last 7d |
审计回顾 |
hermes debug enable |
开启 debug 模式 |
hermes debug dump > dump.txt |
导出诊断信息 |
二十、Daemon 与服务（5 条）
| 命令 |
作用 |
hermes daemon |
以 daemon 方式启动 |
hermes daemon stop |
停止 daemon |
hermes daemon restart |
重启 |
hermes service install |
装系统服务（systemd / launchd） |
hermes service uninstall |
卸载系统服务 |
二十一、认证与权限（5 条）
| 命令 |
作用 |
hermes auth list |
看所有 API 认证 |
hermes auth add <provider> |
加 |
hermes auth remove <provider> |
删 |
hermes auth rotate <provider> |
换 Key |
hermes auth test <provider> |
测试 |
二十二、批量操作（4 条）
| 命令 |
作用 |
hermes batch process ~/data/*.csv -p "..." |
批量处理文件 |
hermes batch run ~/scripts/jobs.yaml |
批量跑任务 |
hermes batch report |
看批量任务进度 |
hermes batch cancel <id> |
取消批量任务 |
二十三、紧急 / 救命命令（5 条）
| 命令 |
作用 |
pkill -f hermes |
强杀所有 Hermes 进程 |
hermes schedule pause-all |
暂停所有定时任务 |
hermes auth revoke-all |
一次性禁用所有 Key |
rm -f ~/.hermes/state.db-{shm,wal} |
解 SQLite 锁 |
hermes restore --from ~/backup.tar.gz |
从备份恢复 |
命令组合：一行搞定的常用任务
# 一键体检 + 升级 + 重建索引
hermes doctor --fix && hermes upgrade && hermes memory rebuild
# 备份 + 推到 Dropbox
hermes export --all - | gpg -c > ~/Dropbox/hermes-$(date +%Y%m%d).tar.gz.gpg
# 看本月所有定时任务花了多少钱
hermes schedule history --all --last 30d --field cost | awk '{sum+=$1} END {print sum}'
# 把所有 Skills 推到一个新仓库
hermes skill export-all /tmp/skills/ && cd /tmp/skills && git init && git add . && git commit -m "init"
# 一键启动整个工作环境（适合开机自启）
hermes daemon && hermes gateway start --all && hermes schedule resume-all
# 用 watch 实时监控 Hermes 状态
watch -n 5 'hermes mind | head -30'
配置文件速查
所有 Hermes 配置默认在 ~/.hermes/：
| 文件 |
作用 |
config.yaml |
主配置 |
.env |
API Key 等敏感信息 |
auth.json |
OAuth token（自动管理） |
SOUL.md |
全局人格 |
mcp.json |
MCP 服务器配置 |
gateway.yaml |
网关配置 |
notify.yaml |
通知路由配置 |
memories/ |
持久记忆 |
skills/ |
技能库 |
cron/ |
定时任务定义 |
workflows/ |
工作流定义 |
sessions/ |
会话历史 |
logs/ |
日志 |
state.db |
SQLite 状态库 |
audit.log |
审计日志 |
永无岛