Files
notes/resource/ai/Hermes 命令 cli.md
T
Docker7530 521496f2df 1779195890
2026-05-19 21:04:53 +08:00

78 lines
33 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
hermes skills search "Self-Improving Agent" --source clawhub
hermes skills search find-skills --source skills-sh
hermes skills install clawhub/community/self-improving-agent-skill
hermes profile create my-agent
hermes dashboard --host 0.0.0.0 --port 9119 --insecure
| 分类 | 指令 | 参数 | 参数说明 | 适用场景 | 注意事项 | | | | | |
| ------------ | ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------- | ---------------------------------- | -------------------------------------------------------------------- | ------------- | ------------------------------------------------------------------- | --------------- | --------- | --------------- |
| 启动/聊天 | `hermes` / `hermes chat` | `-q/--query`, `--image`, `-m/--model`, `--provider`, `-t/--toolsets`, `-s/--skills`, `-v`, `-Q`, `-r/--resume`, `-c/--continue`, `-w/--worktree`, `--checkpoints`, `--max-turns`, `--yolo`, `--tui`, `--dev` | 启动交互/单轮聊天,指定模型、工具集、技能、会话、TUI 等 | 日常使用 Hermes Agent | 顶层也支持 `-z/--oneshot` 脚本模式;`--yolo` 会跳过危险命令审批 | | | | | |
| 启动/聊天 | `hermes -z/--oneshot <prompt>` | `PROMPT`,可配 `-m --provider -t -s --resume --worktree` | 单次执行,只输出最终答案 | 脚本、管道、CI | 自动绕过审批,输出更适合机器消费 | | | | | |
| 模型 | `hermes model` | `--portal-url`, `--inference-url`, `--client-id`, `--scope`, `--no-browser`, `--timeout`, `--ca-bundle`, `--insecure` | 选择/登录默认模型与 provider | 初始化或切换推理后端 | 涉及 OAuth/TLS 参数,`--insecure` 仅测试 | | | | | |
| 模型 | `hermes fallback list/add/remove/clear` | `list(ls)`, `add`, `remove(rm)`, `clear` | 管理主模型失败后的 fallback provider 链 | 抗限流、故障转移 | `add/remove` 通常进入交互选择 | | | | | |
| 网关 | `hermes gateway run` | `-v`, `-q`, `--replace`, `--accept-hooks` | 前台运行消息网关 | WSL/Docker/Termux/调试 | `--replace` 会替换已有实例 | | | | | |
| 网关 | `hermes gateway start/stop/restart` | `--system`, `--all` | 管理 systemd/launchd 后台服务 | 生产运行 Gateway | `--all` 跨 profile 处理,慎用 | | | | | |
| 网关 | `hermes gateway status` | `--deep`, `--full`, `--system` | 查看 Gateway 服务状态 | 排障 | `--deep` 更慢但更完整 | | | | | |
| 网关 | `hermes gateway install/uninstall` | `--force`, `--system`, `--run-as-user` | 安装/卸载 Gateway 服务 | 部署后台消息机器人 | Linux system 服务需明确运行用户 | | | | | |
| 网关 | `hermes gateway list/setup/migrate-legacy` | `migrate-legacy --dry-run -y` | 列 profile 状态、配置平台、清理旧 service | 多平台/升级维护 | `migrate-legacy` 默认会确认 | | | | | |
| 配置 | `hermes setup` | `[model | tts | terminal | gateway | tools | agent]`, `--non-interactive`, `--reset`, `--reconfigure`, `--quick` | 交互式初始化配置 | 首次安装/重新配置 | `--reset` 会重置配置 |
| 集成 | `hermes whatsapp` | 无 | 配置 WhatsApp 并扫码配对 | WhatsApp Gateway | 依赖平台后端 | | | | | |
| 集成 | `hermes slack manifest` | `--write [PATH]`, `--name`, `--description`, `--slashes-only` | 生成 Slack app manifest | 注册 Slack slash commands | Slack 原生命令数量有限,源码有裁剪逻辑 | | | | | |
| 认证 | `hermes login/logout` | `--provider`, OAuth/TLS 参数 | 登录或清除 provider 凭据 | Nous/OpenAI Codex/Spotify 等认证 | `logout` 默认 active provider | | | | | |
| 认证 | `hermes auth add/list/remove/reset/status/logout/spotify` | `provider`, `target`, `--type`, `--api-key`, OAuth 参数;`spotify login/status/logout` | 管理凭据池和 Spotify PKCE | 多账号、多 key、音乐工具 | API key 可交互输入,避免写进 shell 历史 | | | | | |
| 状态 | `hermes status` | `--all`, `--deep` | 展示组件状态 | 总体诊断 | 输出会做分享友好的脱敏 | | | | | |
| 定时 | `hermes cron list/create/add/edit/pause/resume/run/remove/status/tick` | `schedule`, `prompt`, `job_id`, `--name`, `--deliver`, `--repeat`, `--skill`, `--script`, `--no-agent`, `--workdir`, `--accept-hooks` | 管理计划任务 | 定时报表、巡检、自动化 | `--no-agent` 只跑脚本;`run/tick` 可触发 hook 审批 | | | | | |
| Webhook | `hermes webhook subscribe/list/remove/test` | `name`, `--prompt`, `--events`, `--description`, `--skills`, `--deliver`, `--deliver-chat-id`, `--secret`, `--deliver-only`, `--payload` | 动态 webhook 订阅 | 事件驱动触发 agent | `--deliver-only` 零 LLM 成本 | | | | | |
| 看板 | `hermes kanban …` | 全局 `--board` | 多 profile 协作任务系统 | 多 agent 分工、任务队列 | 子命令很多,见下表 | | | | | |
| Hooks | `hermes hooks list/test/revoke/doctor` | `event`, `--for-tool`, `--payload-file`, `command` | 检查/测试 shell hooks 和 consent allowlist | 扩展生命周期钩子 | revoke 重启后生效 | | | | | |
| 诊断 | `hermes doctor` | `--fix`, `--ack ADVISORY_ID` | 检查配置依赖/安全公告 | 安装和故障排查 | `--fix` 会尝试修改环境 | | | | | |
| 诊断 | `hermes dump` | `--show-keys` | 输出紧凑支持信息 | 提 issue/Discord 支持 | 默认不展示 key 片段 | | | | | |
| 诊断 | `hermes debug share/delete` | `--lines`, `--expire`, `--local`, `--no-redact`, `urls…` | 上传/删除 debug paste | 远程排错 | 默认上传前脱敏;`--no-redact` 慎用 | | | | | |
| 备份 | `hermes backup` | `-o/--output`, `-q/--quick`, `-l/--label` | 备份 Hermes home | 迁移/升级前保存状态 | 不备份代码仓库本身 | | | | | |
| 备份 | `hermes import` | `zipfile`, `--force` | 从备份 zip 恢复 | 迁移/回滚 | `--force` 覆盖已有文件 | | | | | |
| Checkpoints | `hermes checkpoints status/list/prune/clear/clear-legacy` | `--limit`, `--retention-days`, `--max-size-mb`, `--keep-orphans`, `-f` | 管理 `/rollback` 文件快照库 | 清理 checkpoint 占用 | `clear` 会删除所有 rollback 历史 | | | | | |
| 配置 | `hermes config show/edit/set/path/env-path/check/migrate` | `key`, `value` | 查看、编辑、设置、迁移配置 | 配置维护 | 非 secret 设置进 `config.yaml`secret 应在 `.env` | | | | | |
| 授权 | `hermes pairing list/approve/revoke/clear-pending` | `platform`, `code`, `user_id` | 管理 DM pairing code | Gateway 用户授权 | 用于受控接入 | | | | | |
| Skills | `hermes skills browse/search/install/inspect/list/check/update/audit/uninstall/reset/publish/snapshot/tap/config` | `identifier`, `query`, `--source`, `--limit`, `--force`, `--yes`, `--category`, `--name`, `--restore`, `--to`, `--repo` | 搜索、安装、审计、发布、配置 skills | 扩展 Hermes 能力 | `config` 是交互式;URL 安装会扫描风险 | | | | | |
| Plugins | `hermes plugins install/update/remove/list/enable/disable` | `identifier`, `name`, `--force`, `--enable`, `--no-enable` | 管理插件 | 安装第三方/本地扩展 | 插件可再注册新 CLI/slash 命令 | | | | | |
| Curator | `hermes curator status/run/pause/resume/pin/unpin/restore/list-archived/archive/prune/backup/rollback` | `skill`, `--sync`, `--background`, `--dry-run`, `--days`, `--yes`, `--reason`, `--list`, `--id` | 技能生命周期维护 | 自动归档 agent-created stale skills | 不会删除 bundled/hub skills;归档可恢复 | | | | | |
| Memory | `hermes memory setup/status/off/reset` | `--yes`, `--target all | memory | user` | 配置外部 memory provider 或清空内置记忆 | 记忆系统维护 | `reset` 会删除 `MEMORY.md/USER.md` | | | |
| Tools | `hermes tools [list | enable | disable]` | `--summary`, `--platform`, `NAME…` | 配置各平台工具/工具集/MCP 工具 | 控制 agent 可用工具 | 无子命令时打开交互 UI | | | |
| Computer Use | `hermes computer-use install/status` | `--upgrade` | 安装/检查 macOS cua-driver | 电脑控制工具集 | macOS 专用 | | | | | |
| MCP | `hermes mcp serve/add/remove/list/test/configure/login` | `name`, `--url`, `--command`, `--args`, `--auth`, `--preset`, `--env`, `--verbose`, `--accept-hooks` | 管理 MCP server 或把 Hermes 暴露为 MCP server | 接入外部工具生态 | `add` 支持 HTTP/SSE 或 stdio | | | | | |
| Sessions | `hermes sessions list/export/delete/prune/stats/rename/browse` | `--source`, `--limit`, `output`, `--session-id`, `session_id`, `--older-than`, `--yes`, `title…` | 管理历史会话数据库 | 查找、导出、删除、恢复会话 | 默认隐藏 source=`tool` 的第三方会话 | | | | | |
| Insights | `hermes insights` | `--days`, `--source` | 生成用量/成本/工具分析 | 复盘使用情况 | 依赖 SQLite session 数据 | | | | | |
| 迁移 | `hermes claw migrate/cleanup` | `--source`, `--dry-run`, `--preset`, `--overwrite`, `--migrate-secrets`, `--no-backup`, `--workspace-target`, `--skill-conflict`, `--yes` | 从 OpenClaw 迁移/清理 | 旧项目迁移到 Hermes | secrets 必须显式 `--migrate-secrets` | | | | | |
| 版本/更新 | `hermes version/update/uninstall` | `update --check --backup --no-backup -y --gateway`; `uninstall --full -y` | 版本查看、更新、卸载 | 维护安装 | `uninstall --full` 会移除配置和数据 | | | | | |
| ACP | `hermes acp` | `--accept-hooks` | 启动 ACP server | VS Code/Zed/JetBrains 集成 | 需要 acp 依赖 | | | | | |
| Profile | `hermes profile list/use/create/delete/show/alias/rename/export/import/install/update/info` | `profile_name`, `archive`, `source`, `--clone`, `--clone-all`, `--clone-from`, `--no-alias`, `--no-skills`, `--force`, `--alias`, `--force-config`, `--yes` | 多 profile 隔离管理 | 多身份、多项目、多环境 | profile 数据相互隔离 | | | | | |
| Shell | `hermes completion` | `bash | zsh | fish` | 输出 shell completion | 命令补全安装 | 默认 bash | | | |
| Dashboard | `hermes dashboard` | `--port`, `--host`, `--no-open`, `--insecure`, `--tui`, `--skip-build`, `--stop`, `--status` | 启动/管理 Web UI | 配置、会话、嵌入 TUI | `--insecure` 会暴露本地管理面板,慎用 | | | | | |
| Logs | `hermes logs` | `[agent | errors | gateway | list]`, `-n`, `-f`, `--level`, `--session`, `--since`, `--component` | 查看/过滤日志 | 排障、跟踪运行 | `-f` 类似 tail -f | | |
| LSP | `hermes lsp status/list/install/install-all/restart/which` | `--json`, `--installed-only`, `server`, `--include-manual` | 管理语义诊断 LSP 层 | 写文件/patch 后诊断 | 某些 server 需手动依赖,如 shellcheck | | | | | |
**Kanban 子命令速查**
| 指令 | 参数 | 适用场景 | 注意事项 |
|---|---|---|---|
| `hermes kanban boards list/create/rm/switch/show/rename` | `slug`, `--json`, `--all`, `--name`, `--description`, `--icon`, `--color`, `--switch`, `--delete` | 多项目看板隔离 | `rm` 默认归档,`--delete` 才硬删 |
| `hermes kanban create/list/show/assign/reclaim/reassign/diagnostics` | `title`, `task_id`, `profile`, `--body`, `--assignee`, `--parent`, `--workspace`, `--tenant`, `--priority`, `--triage`, `--json` | 创建、查询、分配任务 | `--workspace` 支持 `scratch/worktree/dir:<path>` |
| `hermes kanban link/unlink/claim/comment/complete/edit/block/unblock/archive` | `parent_id child_id`, `task_ids`, `--ttl`, `--author`, `--result`, `--summary`, `--metadata`, `--ids` | 依赖、领取、评论、完成、阻塞、归档 | `complete/edit` 可写结构化 metadata |
| `hermes kanban tail/dispatch/daemon/watch/stats/gc` | `--interval`, `--dry-run`, `--max`, `--failure-limit`, `--assignee`, `--tenant`, `--kinds`, `--event-retention-days` | 事件流、调度、统计、清理 | `daemon` 已标注 deprecated,推荐 Gateway 调度 |
| `hermes kanban notify-subscribe/notify-list/notify-unsubscribe/log/runs/heartbeat/assignees/context/specify` | `task_id`, `--platform`, `--chat-id`, `--thread-id`, `--user-id`, `--tail`, `--note`, `--all`, `--author` | Gateway 通知、worker 日志、运行记录、triage 细化 | `specify` 使用 auxiliary LLM |
**源码内置插件 CLI**
| 分类 | 指令 | 参数 | 参数说明 | 适用场景 | 注意事项 |
|---|---|---|---|---|---|
| Google Meet 插件 | `hermes google-meet setup/install/auth/join/status/transcript/say/stop/node` | `join <url> --guest-name --duration --headed`; `transcript --last`; `say <text> --node` | 管理 Meet bot、入会、发言、转录 | 会议自动化 | 插件启用/发现后才注册 |
| Google Meet Node | `hermes google-meet node run/list/approve/remove/status/ping` | `--host`, `--port`, `--display-name`, `name url token` | 远程 meeting node 管理 | 分布式 Meet 控制 | 属于 google_meet 插件子树 |
| Teams Pipeline 插件 | `hermes teams-pipeline list/show/run/fetch/subscriptions/subscribe/renew-subscription/delete-subscription/maintain-subscriptions/token-health/validate` | `job_id`, `--meeting-id`, `--join-web-url`, `--resource`, `--notification-url`, `--expiration`, `--store-path` | Teams/Graph 会议流水线和订阅管理 | 企业会议资料处理 | 依赖 Graph 凭据和插件启用 |
| Honcho memory 插件 | `hermes honcho …` | `status`, `peers`, `sessions`, `map`, `peer`, `mode`, `strategy`, `tokens`, `identity`, `enable/disable/sync` 等 | Honcho 外部 memory provider 配置 | 使用 Honcho 记忆后端 | 只有当前 memory provider 为 Honcho 时通常才暴露 |
动态部分建议用 `hermes --help``hermes plugins list``/commands``/help` 在实际环境里枚举。