notes/resource/ai/Hermes 命令 cli.md

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 在实际环境里枚举。