词元之母TOK.MOM - 平台充值汇率 1:1 即 1 人民币充值到账 1 美元,支持一个 Key 调用近 600+ 海内外模型,限时特价模型低至 1 折,欢迎上岸!
| 选项 | 说明 |
|---|---|
--version, -V | 显示版本并退出。 |
--profile <name>, -p <name> | 选择本次调用使用的 Hermes profile(配置文件)。覆盖 hermes profile use 设置的粘性默认值。 |
--resume <session>, -r <session> | 通过 ID 或标题恢复之前的会话。 |
--continue [name], -c [name] | 恢复最近的会话,或恢复最近一个匹配标题的会话。 |
--worktree, -w | 在隔离的 git worktree 中启动,用于并行 agent 工作流。 |
--yolo | 跳过危险命令的审批提示。 |
--pass-session-id | 在 agent 的 system prompt(系统提示词)中包含会话 ID。 |
--ignore-user-config | 忽略 ~/.hermes/config.yaml,回退到内置默认值。.env 中的凭据仍会加载。 |
--ignore-rules | 跳过 AGENTS.md、SOUL.md、.cursorrules、memory(记忆)和预加载 skill 的自动注入。 |
--tui | 启动 TUI 而非经典 CLI。等同于 HERMES_TUI=1。 |
--dev | 与 --tui 配合使用:通过 tsx 直接运行 TypeScript 源码而非预构建包(供 TUI 贡献者使用)。 |
| 命令 | 用途 |
|---|---|
hermes chat | 与 agent 进行交互式或单次聊天。 |
hermes model | 交互式选择默认 provider 和模型。 |
hermes fallback | 管理主模型出错时依次尝试的 fallback provider。 |
hermes gateway | 运行或管理消息 gateway 服务。 |
hermes proxy | 本地 OpenAI 兼容代理,附加 OAuth provider 凭据。参见 订阅代理。 |
hermes lsp | 管理 Language Server Protocol 集成(为 write_file/patch 提供语义诊断)。 |
hermes setup | 全部或部分配置的交互式设置向导。 |
hermes whatsapp | 配置并配对 WhatsApp 桥接。 |
hermes slack | Slack 辅助工具(当前功能:生成将每条命令注册为原生斜杠命令的 app manifest)。 |
hermes auth | 管理凭据——添加、列出、删除、重置、设置策略。处理 Codex/Nous/Anthropic 的 OAuth 流程。 |
hermes login / logout | 已弃用 — 请改用 hermes auth。 |
hermes status | 显示 agent、auth 和平台状态。 |
hermes cron | 检查并触发 cron 调度器。 |
hermes kanban | 多 profile 协作看板(任务、链接、调度器)。 |
hermes webhook | 管理用于事件驱动激活的动态 webhook 订阅。 |
hermes hooks | 检查、审批或删除 config.yaml 中声明的 shell 脚本 hook。 |
hermes doctor | 诊断配置和依赖问题。 |
hermes security audit | 对 venv、plugin 依赖和固定 MCP 服务器进行按需供应链审计(OSV.dev)。 |
hermes dump | 可直接复制粘贴的设置摘要,用于支持/调试。 |
hermes debug | 调试工具——上传日志和系统信息以获取支持。 |
hermes backup | 将 Hermes 主目录备份为 zip 文件。 |
hermes checkpoints | 检查/修剪/清除 ~/.hermes/checkpoints/(/rollback 使用的影子存储)。不带参数运行可查看状态概览。 |
hermes import | 从 zip 文件恢复 Hermes 备份。 |
hermes logs | 查看、跟踪和过滤 agent/gateway/错误日志文件。 |
hermes config | 显示、编辑、迁移和查询配置文件。 |
hermes pairing | 审批或撤销消息配对码。 |
hermes skills | 浏览、安装、发布、审计和配置 skill。 |
hermes bundles | 将多个 skill 归组到单个 /<name> 斜杠命令下。参见 Skill Bundles。 |
hermes curator | 后台 skill 维护——状态、运行、暂停、固定。参见 Curator。 |
hermes memory | 配置外部 memory provider。当对应 provider 激活时,特定于 plugin 的子命令(如 hermes honcho)会自动注册。 |
hermes acp | 将 Hermes 作为 ACP 服务器运行,用于编辑器集成。 |
hermes mcp | 管理 MCP 服务器配置,并将 Hermes 作为 MCP 服务器运行。 |
hermes plugins | 管理 Hermes Agent plugin(安装、启用、禁用、删除)。 |
hermes portal | Nous Portal 状态、订阅链接和 Tool Gateway 路由。参见 Tool Gateway。 |
hermes tools | 按平台配置已启用的工具。 |
hermes computer-use | 安装或检查 cua-driver 后端(macOS Computer Use )。 |
hermes sessions | 浏览、导出、修剪、重命名和删除会话。 |
hermes insights | 显示 token/费用/活动分析。 |
hermes claw | OpenClaw 迁移辅助工具。 |
hermes dashboard | 启动用于管理配置、API 密钥和会话的 Web 控制台。 |
hermes profile | 管理 profile——多个隔离的 Hermes 实例。 |
hermes completion | 打印 shell 补全脚本(bash/zsh/fish)。 |
hermes version | 显示版本信息。 |
hermes update | 拉取最新代码并重新安装依赖(git 安装),或检查 PyPI 并执行 pip install --upgrade(pip 安装)。--check 预览而不安装;--backup 在拉取前对 HERMES_HOME 进行快照。 |
hermes uninstall | 从系统中删除 Hermes。 |
hermes chat| 选项 | 说明 |
|---|---|
-q, --query "..." | 单次非交互式 prompt。 |
-m, --model <model> | 覆盖本次运行的模型。 |
-t, --toolsets <csv> | 启用逗号分隔的 toolset 集合。 |
--provider <provider> | 强制指定 provider:auto、openrouter、nous、openai-codex、copilot-acp、copilot、anthropic、gemini、google-gemini-cli、huggingface、novita、zai、kimi-coding、kimi-coding-cn、minimax、minimax-cn、minimax-oauth、kilocode、xiaomi、arcee、gmi、alibaba、alibaba-coding-plan(别名 alibaba_coding)、deepseek、nvidia、ollama-cloud、xai(别名 grok)、xai-oauth(别名 grok-oauth) 、qwen-oauth、bedrock、opencode-zen、opencode-go、azure-foundry、lmstudio、stepfun、tencent-tokenhub(别名 tencent、tokenhub)。 |
-s, --skills <name> | 为会话预加载一个或多个 skill(可重复或逗号分隔)。 |
-v, --verbose | 详细输出。 |
-Q, --quiet | 程序化模式:抑制横幅/spinner/工具预览。 |
--image <path> | 为单次查询附加本地图片。 |
--resume <session> / --continue [name] | 直接从 chat 恢复会 话。 |
--worktree | 为本次运行创建隔离的 git worktree。 |
--checkpoints | 在破坏性文件变更前启用文件系统 checkpoint。 |
--yolo | 跳过审批提示。 |
--pass-session-id | 将会话 ID 传入 system prompt。 |
--ignore-user-config | 忽略 ~/.hermes/config.yaml,使用内置默认值。.env 中的凭据仍会加载。适用于隔离的 CI 运行、可复现的 bug 报告和第三方集成。 |
--ignore-rules | 跳过 AGENTS.md、SOUL.md、.cursorrules、持久 memory 和预加载 skill 的自动注入。与 --ignore-user-config 组合可实现完全隔离的运行。 |
--source <tag> | 用于过滤的会话来源标签(默认:cli)。对于不应出现在用 户会话列表中的第三方集成,使用 tool。 |
--max-turns <N> | 每个对话轮次的最大工具调用迭代次数(默认:90,或 config 中的 agent.max_turns)。 |
hermes -z <prompt> — 脚本化单次调用hermes -z 是最纯粹的单次入口:单个 prompt 输入,最终响应文本输出,stdout 和 stderr 上不输出任何其他内容。 无横幅、无 spinner、无工具预览、无 Session: 行——只有 agent 的最终回复纯文本。~/.hermes/config.yaml):| 标志 | 等效环境变量 | 用途 |
|---|---|---|
-m / --model <model> | HERMES_INFERENCE_MODEL | 覆盖本次运行的模型 |
--provider <provider> | (无) | 覆盖本次运行的 provider |
hermes chat -q;-z 专门用于"我只需要最终答案"的场景。hermes modelhermes model(从终端运行,在任何 Hermes 会话外部)是完整的 provider 设置向导。它可以添加新 provider、运行 OAuth 流程、提示输入 API 密钥并配置端点。/model(在活跃的 Hermes 聊天会话中输入)只能在已设置好的 provider 和模型之间切换。它无法添加新 provider、运行 OAuth 或提示输入 API 密钥。Ctrl+C 或 /quit),然后从终端提示符运行 hermes model。/model 斜杠命令(会话中途)/model # 显示当前模型和可用选项
/model claude-sonnet-4 # 切换模型(自动检测 provider)
/model zai:glm-5 # 切换 provider 和模型
/model custom:qwen-2.5 # 在自定义端点上使用模型
/model custom # 从自定义端点自动检测模型
/model custom:local:qwen-2.5 # 使用命名的自定义 provider
/model openrouter:anthropic/claude-sonnet-4 # 切换回云端/model 的更改仅对当前会话生效。添加 --global 可将更改持久化到 config.yaml:/model claude-sonnet-4 --global # 切换并保存为新默认值/model 将只显示 OpenRouter 模型。要添加其他 provider(Anthropic、DeepSeek、Copilot 等),请退出会话并从终端运行 hermes model。config.yaml。从自定义端点切换走时,过时的 base URL 会被清除,以防止其泄漏到其他 provider。hermes gateway| 子命令 | 说明 |
|---|---|
run | 在前台运行 gateway。推荐用于 WSL、Docker 和 Termux。 |
start | 启动已安装的 systemd/launchd 后台服务。 |
stop | 停止服务(或前台进程)。 |
restart | 重启服务。 |
status | 显示服务状态。 |
list | 列出所有 profile 及每个 profile 的 gateway 当前是否运行(有 PID 时显示)。当你并行运行多个 profile 并需要单一概览时很方便。 |
install | 安装为 systemd(Linux)或 launchd(macOS)后台服务。 |
uninstall | 删除已安装的服务。 |
setup | 交互式消息平台设置。 |
| 选项 | 说明 |
|---|---|
--all | 在 start / restart / stop 时:对每个 profile 的 gateway 执行操作,而不仅限于活跃的 HERMES_HOME。当你并行运行多个 profile 并希望在 hermes update 后全部重启时很有用。 |
--no-supervise | 在 run 时:在 s6-overlay Docker 镜像内部,跳过 s6 自动监管,退回到 pre-s6 前台语义——gateway 作为容器主进程运行,无自动重启。在 s6 镜像之外为空操作。等同于设置 HERMES_GATEWAY_NO_SUPERVISE=1。 |
hermes gateway run 而非 hermes gateway start——WSL 的 systemd 支持不稳定。用 tmux 包裹以保持持久运行:tmux new -s hermes 'hermes gateway run'。详见 WSL FAQ。hermes lspwrite_file 和 patch 使用的写后检查。受 git 工作区检测限制——仅当 cwd 或编辑的文件位于 git worktree 内时,LSP 才会运行。| 子命令 | 说明 |
|---|---|
status | 显示服务状态、已配置的服务器、安装状态。 |
list | 打印支持的服务器注册表。传入 --installed-only 可跳过缺失的服务器。 |
install <id> | 主动安装某个服务器的二进制文件。 |
install-all | 安装所有具有已知自动安装方案的服务器。 |
restart | 关闭正在运行的客户端,以便下次编辑时重新启动。 |
which <id> | 打印某个服务器的已解析二进制路径。 |
hermes setup| 部分 | 说 明 |
|---|---|
model | Provider 和模型设置。 |
terminal | 终端后端和沙箱设置。 |
gateway | 消息平台设置。 |
tools | 按平台启用/禁用工具。 |
agent | Agent 行为设置。 |
| 选项 | 说明 |
|---|---|
--quick | 在已配置用户运行时:仅提示缺失或未设置的项目,跳过已配置的项目。 |
--non-interactive | 使用默认值/环境变量,不显示提示。 |
--reset | 在设置前将配置重置为默认值。 |
--reconfigure | 向后兼容别名——在已有安装上裸运行 hermes setup 现在默认执行此操作。 |
--portal | 一键 Nous Portal 设置:通过 OAuth 登录,将 Nous 设为推理 provider,并选择加入 Tool Gateway。跳过向导其余部分。 |
hermes portalstatus。| 子命令 | 说明 |
|---|---|
status(默认) | Portal 认证状态 + 每个工具的 Tool Gateway 路由摘要。不带子命令时也会显示。 |
open | 在默认浏览器中打开 portal.nousresearch.com/manage-subscription。 |
tools | 列出每个 Tool Gateway 合作伙伴(Firecrawl、FAL、OpenAI TTS、Browser Use、Modal)及哪些通过 Nous 路由。 |
hermes setup --portal。hermes whatsapphermes slackCOMMAND_REGISTRY 中的每条 gateway 命令(/btw、/stop、/model 等)注册为一等公民 Slack 斜杠命令——与 Discord 和 Telegram 保持一致。将输出粘贴到你的 Slack app 配置中:https://api.slack.com/apps → 你的 app → Features → App Manifest → Edit,然后点击 Save。如果 scope 或斜杠命令有变化,Slack 会提示重新安装。| 标志 | 默认值 | 用途 |
|---|---|---|
--write [PATH] | stdout | 写入文件而非 stdout。裸 --write 写入 $HERMES_HOME/slack-manifest.json。 |
--name NAME | Hermes | Slack 中的机器人显示名称。 |
--description DESC | 默认简介 | Slack app 目录中显示的机器人描述。 |
--slashes-only | 关闭 | 仅输出 features.slash_commands,用于合并到手动维护的 manifest 中。 |
hermes update 后重新运行 hermes slack manifest --write 以获取新增命令。hermes login / hermes logout (已弃用)hermes login 已被移除。请使用 hermes auth 管理 OAuth 凭据,使用 hermes model 选择 provider,或使用 hermes setup 进行完整的交互式设置。hermes authadd、list、remove、reset、status、logout、spotify。不带子命令调用时,启动交互式管理向导。hermes status| 选项 | 说明 |
|---|---|
--all | 以可分享的脱敏格式显示所有详情。 |
--deep | 运行可能耗时更长的深度检查。 |
hermes cron| 子命令 | 说明 |
|---|---|
list | 显示已调度的任务。 |
create / add | 从 prompt 创建调度任务,可通过重复 --skill 附加一个或多个 skill。 |
edit | 更新任务的调度、prompt、名称、投递方式、重复次数或附加的 skill。支持 --clear-skills、--add-skill 和 --remove-skill。 |
pause | 暂停任务而不删除。 |
resume | 恢复已暂停的任务并计算下次未来运行时间。 |
run | 在下次调度器 tick 时触发任务。 |
remove | 删除调度任务。 |
status | 检查 cron 调度器是否正在运行。 |
tick | 运行到期任务一次后退出。 |
hermes kanbandefault 的单个看板开始,其数据库为 ~/.hermes/kanban.db(向后兼容);其他看板位于 ~/.hermes/kanban/boards/<slug>/kanban.db。嵌入在 gateway 中的调度器每次 tick 扫描所有看板。| 标志 | 用途 |
|---|---|
--board <slug> | 操作特定看板。默认为当前看板(通过 hermes kanban boards switch、HERMES_KANBAN_BOARD 环境变量或 default 设置)。 |
kanban_* toolset(kanban_show、kanban_complete、kanban_block、kanban_create、kanban_link、kanban_comment、kanban_heartbeat;编排器 profile 还可使用 kanban_list 和 kanban_unblock)驱动看板,而非调用 hermes kanban。Worker 的环境中固定了 HERMES_KANBAN_BOARD,因此物理上无法看到其他看板。| 操作 | 用途 |
|---|---|
init | 如果缺少则创建 kanban.db。幂等操作。 |
boards list / boards ls | 列出所有看板及任务数量。支持 --json、--all(包含已归档)。 |
boards create <slug> | 创建新看板。标志:--name、--description、--icon、--color、--switch(设为活跃)。Slug 为 kebab-case,自动转小写。 |
boards switch <slug> / boards use | 将 <slug> 持久化为活跃看板(写入 ~/.hermes/kanban/current)。 |
boards show / boards current | 打印当前活跃看板的名称、数据库路径和任务数量。 |
boards rename <slug> "<name>" | 更改看板的显示名称。Slug 不可变。 |
boards rm <slug> | 归档(默认)或硬删除看板。--delete 跳过归档步骤。已归档看板移至 boards/_archived/<slug>-<ts>/。default 看板拒绝此操作。 |
create "<title>" | 在活跃看板上创建新任务。标志:--body、--assignee、--parent(可重复)、--workspace scratch|worktree|dir:<path>、--tenant、--priority、--triage、--idempotency-key、--max-runtime、--max-retries、--skill(可重复)。 |
list / ls | 列出活跃看板上的任务。可用 --mine、--assignee、--status、--tenant、--archived、--json 过滤。 |
show <id> | 显示任务及其评论和事件。--json 用于机器输出。 |
assign <id> <profile> | 分配或重新分配。使用 none 取消分配。任务运行时拒绝此操作。 |
link <parent> <child> | 添加依赖关系。检测循环依赖。两个任务必须在同一看板上。 |
unlink <parent> <child> | 删除依赖关系。 |
claim <id> | 原子性地认领就绪任务。打印已解析的工作区路径。 |
comment <id> "<text>" | 追加评论。下一个认领该任务的 worker 会在其 kanban_show() 响应中读取到它。 |
complete <id> | 将任务标记为完成。标志:--result、--summary、--metadata。 |
block <id> "<reason>" | 将任务标记为等待人工输入。同时将原因追加为评论。 |
schedule <id> "<reason>" | 将时间延迟/后续工作停放到 scheduled 状态,使其不显示为人工阻塞项。 |
unblock <id> | 将已阻塞或已调度的任务返回就绪状态(如果依赖仍未完成则返回 todo)。 |
archive <id> | 从默认列表中隐藏。gc 将删除 scratch 工作区。 |
tail <id> | 跟踪任务的事件流。 |
dispatch | 对活跃看板执行一次调度器扫描。标志:--dry-run、--max N、--failure-limit N、--json。 |
context <id> | 打印 worker 将看到的完整上下文(标题 + 正文 + 父任务结果 + 评论)。 |
specify <id> / specify --all | 通过辅助 LLM 将 triage 列中的任务细化为具体规格(标题 + 包含目标、方案、验收标准的正文),然后将其提升到 todo。标志:--tenant(将 --all 限定到一个 tenant)、--author、--json。在 config.yaml 的 auxiliary.triage_specifier 下配置模型。 |
decompose <id> / decompose --all | 将 triage 列中的任务按描述拆分为子任务图,路由到专业 profile(编排器驱动路径)。当 LLM 判断任务不适合拆分时,回退到 specify 风格的单任务提升。与 specify 相同的标志。在 config.yaml 的 auxiliary.kanban_decomposer 下配置模型。当 kanban.auto_decompose: true(默认)时,每次调度器 tick 也会自动运行。参见 自动与手动编排。 |
gc | 删除已归档任务的 scratch 工作区。 |
--board <slug> 标志 → HERMES_KANBAN_BOARD 环境变量 → ~/.hermes/kanban/current 文件 → default。/kanban …),参数界面相同——包括 boards 子命令和 --board 标志。docs/hermes-kanban-v1-spec.pdf 或 Kanban 用户指南。hermes webhook| 子命令 | 说明 |
|---|---|
subscribe / add | 创建 webhook 路由。返回要在你的服务上配置的 URL 和 HMAC 密钥。 |
list / ls | 显示所有 agent 创建的订阅。 |
remove / rm | 删除动态订阅。不影响 config.yaml 中的静态路由。 |
test | 发送测试 POST 以验证订阅是否正常工作。 |
hermes webhook subscribe| 选项 | 说明 |
|---|---|
--prompt | 带有 {dot.notation} payload 引用的 prompt 模板。 |
--events | 要接受的逗号分隔事件类型(如 issues,pull_request)。为空则接受所有。 |
--description | 人类可读的描述。 |
--skills | 为 agent 运行加载的逗号分隔 skill 名称。 |
--deliver | 投递目标:log(默认)、telegram、discord、slack、github_comment。 |
--deliver-chat-id | 跨平台投递的目标聊天/频道 ID。 |
--secret | 自定义 HMAC 密钥。省略时自动生成。 |
--deliver-only | 跳过 agent——将渲染后的 --prompt 作为字面消息投递。零 LLM 成本,亚秒级投递。要求 --deliver 为真实目标(非 log)。 |
~/.hermes/webhook_subscriptions.json,webhook 适配器无需重启 gateway 即可热重载。hermes doctor| 选项 | 说明 |
|---|---|
--fix | 尽可能尝试自动修复。 |
hermes dump| 选项 | 说明 |
|---|---|
--show-keys | 显示脱敏的 API 密钥前缀(首尾各 4 个字符),而非仅显示 set/not set。 |
| 部分 | 详情 |
|---|---|
| Header | Hermes 版本、发布日期、git commit hash |
| Environment | 操作系统、Python 版本、OpenAI SDK 版本 |
| Identity | 活跃 profile 名称、HERMES_HOME 路径 |
| Model | 已配置的默认模型和 provider |
| Terminal | 后端类型(local、docker、ssh 等) |
| API keys | 所有 22 个 provider/工具 API 密钥的存在性检查 |
| Features | 已启用的 toolset、MCP 服务器数量、memory provider |
| Services | Gateway 状态、已配置的消息平台 |
| Workload | Cron 任务数量、已安装 skill 数量 |
| Config overrides | 与默认值不同的所有 config 值 |
--- hermes dump ---
version: 0.8.0 (2026.4.8) [af4abd2f]
os: Linux 6.14.0-37-generic x86_64
python: 3.11.14
openai_sdk: 2.24.0
profile: default
hermes_home: ~/.hermes
model: anthropic/claude-opus-4.6
provider: openrouter
terminal: local
api_keys:
openrouter set
openai not set
anthropic set
nous not set
firecrawl set
...
features:
toolsets: all
mcp_servers: 0
memory_provider: built-in
gateway: running (systemd)
platforms: telegram, discord
cron_jobs: 3 active / 5 total
skills: 42
config_overrides:
agent.max_turns: 250
compression.threshold: 0.85
display.streaming: True
--- end dump ---hermes dump 专为分享而设计。交互式诊断请使用 hermes doctor。可视化概览请使用 hermes status。hermes debug| 选项 | 说明 |
|---|---|
--lines <N> | 每个日志文件包含的日志行数(默认:200)。 |
--expire <days> | 粘贴过期天数(默认:7)。 |
--local | 在本地打印报告而非上传。 |