Tham khảo lệnh CLI

Trang này bao gồm lệnh đầu cuối bạn chạy từ trình bao của mình.

Để biết các lệnh gạch chéo trong cuộc trò chuyện, hãy xem Tham khảo lệnh gạch chéo.

Điểm vào toàn cầu

hermes [global-options] <command> [subcommand/options]

Tùy chọn toàn cầu

Tùy chọn	Mô tả
--version, -V	Hiển thị phiên bản và thoát.
--profile <name>, -p <name>	Chọn hồ sơ Hermes nào sẽ sử dụng cho lệnh gọi này. Ghi đè mặc định cố định được đặt bởi sử dụng hồ sơ hermes.
--tiếp tục <phiên>, -r <phiên>	Tiếp tục phiên trước đó theo ID hoặc tiêu đề.
--tiếp tục [tên], -c [tên]	Tiếp tục phiên gần đây nhất hoặc phiên gần đây nhất khớp với tiêu đề.
--worktree, -w	Bắt đầu trong một cây công việc git biệt lập cho quy trình làm việc của tác nhân song song.
--yolo	Bỏ qua lời nhắc phê duyệt lệnh nguy hiểm.
--pass-session-id	Bao gồm ID phiên trong lời nhắc hệ thống của tổng đài viên.

Lệnh cấp cao nhất

Lệnh	Mục đích
Trò chuyện Hermes	Trò chuyện tương tác hoặc một lần với đại lý.
người mẫu Hermes	Tương tác chọn nhà cung cấp và mô hình mặc định.
cổng Hermes	Chạy hoặc quản lý dịch vụ cổng nhắn tin.
thiết lập hermes	Trình hướng dẫn thiết lập tương tác cho tất cả hoặc một phần cấu hình.
hermes whatsapp	Định cấu hình và ghép nối cầu WhatsApp.
hermes xác thực	Quản lý thông tin xác thực - thêm, liệt kê, xóa, đặt lại, đặt chiến lược. Xử lý các luồng OAuth cho Codex/Nous/Anthropic.
hermes đăng nhập / đăng xuất	Không được dùng nữa — thay vào đó hãy sử dụng hermes auth.
trạng thái hermes	Hiển thị trạng thái đại lý, xác thực và nền tảng.
hermes cron	Kiểm tra và đánh dấu vào lịch trình cron.
webhook	Quản lý đăng ký webhook động để kích hoạt theo sự kiện.
bác sĩ Hermes	Chẩn đoán các vấn đề về cấu hình và phụ thuộc.
cấu hình hermes	Hiển thị, chỉnh sửa, di chuyển và truy vấn các tệp cấu hình.
Hermes ghép đôi	Phê duyệt hoặc thu hồi mã ghép nối tin nhắn.
kỹ năng của hermes	Duyệt, cài đặt, xuất bản, kiểm tra và cấu hình các kỹ năng.
hermes honcho	Quản lý tích hợp bộ nhớ phiên chéo Honcho.
ký ức Hermes	Cấu hình nhà cung cấp bộ nhớ ngoài.
hermes acp	Chạy Hermes dưới dạng máy chủ ACP để tích hợp trình soạn thảo.
hermes mcp	Quản lý cấu hình máy chủ MCP và chạy Hermes dưới dạng máy chủ MCP.
plugin hermes	Quản lý plugin Hermes Agent (cài đặt, bật, tắt, xóa).
công cụ Hermes	Định cấu hình các công cụ được kích hoạt trên mỗi nền tảng.
phiên Hermes	Duyệt, xuất, cắt tỉa, đổi tên và xóa phiên.
những hiểu biết sâu sắc của Hermes	Hiển thị phân tích mã thông báo/chi phí/hoạt động.
móng vuốt Hermes	Người trợ giúp di chuyển OpenClaw.
hồ sơ hermes	Quản lý hồ sơ - nhiều phiên bản Hermes bị cô lập.
hoàn thành Hermes	In tập lệnh hoàn thành shell (bash/zsh).
phiên bản Hermes	Hiển thị thông tin phiên bản.
cập nhật Hermes	Kéo mã mới nhất và cài đặt lại các phần phụ thuộc.
gỡ cài đặt hermes	Loại bỏ Hermes khỏi hệ thống.

hermes trò chuyện

hermes chat [options]

Các tùy chọn phổ biến:

Tùy chọn	Mô tả
-q, --query "..."	Lời nhắc một lần, không tương tác.
-m, --model <model>	Ghi đè mô hình cho lần chạy này.
-t, --toolsets <csv>	Kích hoạt bộ công cụ được phân tách bằng dấu phẩy.
--nhà cung cấp <nhà cung cấp>	Buộc nhà cung cấp: auto, openrouter, nous, openai-codex, copilot-acp, copilot, anthropic, huggingface, zai, kimi-coding, minimax, minimax-cn, deepseek, ai-gateway, opencode-zen, opencode-go, kilocode, alibaba.
-s, --skills <name>	Tải trước một hoặc nhiều kỹ năng cho buổi học (có thể lặp lại hoặc phân tách bằng dấu phẩy).
-v, --verbose	Đầu ra dài dòng.
-Q, --quiet	Chế độ có lập trình: chặn xem trước biểu ngữ/spinner/công cụ.
--tiếp tục <phiên> / --tiếp tục [tên]	Tiếp tục phiên trực tiếp từ chat.
--worktree	Tạo một cây công việc git riêng biệt cho lần chạy này.
--điểm kiểm tra	Kích hoạt điểm kiểm tra hệ thống tập tin trước khi thay đổi tập tin phá hoại.
--yolo	Bỏ qua lời nhắc phê duyệt.
--pass-session-id	Chuyển ID phiên vào dấu nhắc hệ thống.
--nguồn <tag>	Thẻ nguồn phiên để lọc (mặc định: cli). Sử dụng tool cho các tiện ích tích hợp của bên thứ ba không xuất hiện trong danh sách phiên của người dùng.
--xoay tối đa <N>	Số lần lặp lại lệnh gọi công cụ tối đa cho mỗi lượt hội thoại (mặc định: 90 hoặc agent.max_turns trong cấu hình).

Ví dụ:

hermes
hermes chat -q "Summarize the latest PRs"
hermes chat --provider openrouter --model anthropic/claude-sonnet-4.6
hermes chat --toolsets web,terminal,skills
hermes chat --quiet -q "Return only JSON"
hermes chat --worktree -q "Review this repo and open a PR"

người mẫu Hermes

Nhà cung cấp tương tác + bộ chọn mô hình.

hermes model

Sử dụng điều này khi bạn muốn:

• chuyển đổi nhà cung cấp mặc định
• đăng nhập vào các nhà cung cấp được OAuth hỗ trợ trong quá trình chọn mô hình
• chọn từ danh sách mô hình dành riêng cho nhà cung cấp
• định cấu hình điểm cuối tùy chỉnh/tự lưu trữ
• lưu mặc định mới vào config

Lệnh gạch chéo ### /model (giữa phiên)

Chuyển đổi mô hình mà không cần rời khỏi phiên:

/model                              # Show current model and available options
/model claude-sonnet-4              # Switch model (auto-detects provider)
/model zai:glm-5                    # Switch provider and model
/model custom:qwen-2.5              # Use model on your custom endpoint
/model custom                       # Auto-detect model from custom endpoint
/model custom:local:qwen-2.5        # Use a named custom provider
/model openrouter:anthropic/claude-sonnet-4  # Switch back to cloud

Các thay đổi của nhà cung cấp và URL cơ sở được tự động lưu giữ thành config.yaml. Khi chuyển khỏi điểm cuối tùy chỉnh, URL cơ sở cũ sẽ bị xóa để ngăn chặn việc rò rỉ sang các nhà cung cấp khác.

`` cổng hermes`

hermes gateway <subcommand>

Lệnh phụ:

Tiểu ban	Mô tả
chạy	Chạy cổng ở phía trước.
bắt đầu	Bắt đầu dịch vụ cổng đã cài đặt.
dừng lại	Dừng dịch vụ.
khởi động lại	Khởi động lại dịch vụ.
trạng thái	Hiển thị trạng thái dịch vụ.
cài đặt	Cài đặt dưới dạng dịch vụ người dùng (systemd trên Linux, launchd trên macOS).
gỡ cài đặt	Xóa dịch vụ đã cài đặt.
thiết lập	Thiết lập nền tảng nhắn tin tương tác.

thiết lập hermes

hermes setup [model|terminal|gateway|tools|agent] [--non-interactive] [--reset]

Sử dụng trình hướng dẫn đầy đủ hoặc chuyển sang một phần:

Phần	Mô tả
người mẫu	Thiết lập nhà cung cấp và mô hình.
thiết bị đầu cuối	Thiết lập phụ trợ thiết bị đầu cuối và hộp cát.
cổng	Thiết lập nền tảng nhắn tin.
công cụ	Bật/tắt các công cụ trên mỗi nền tảng.
đại lý	Cài đặt hành vi của đại lý.

Tùy chọn:

Tùy chọn	Mô tả
--không tương tác	Sử dụng giá trị mặc định/môi trường mà không cần lời nhắc.
--đặt lại	Đặt lại cấu hình về mặc định trước khi thiết lập.

hermes whatsapp

hermes whatsapp

Chạy quy trình ghép nối/thiết lập WhatsApp, bao gồm lựa chọn chế độ và ghép nối mã QR.

hermes login / hermes logout (Không dùng nữa)

cẩn thận

đăng nhập Hermes đã bị xóa. Sử dụng hermes auth để quản lý thông tin xác thực OAuth, hermes model để chọn nhà cung cấp hoặc hermes setup để thiết lập tương tác đầy đủ.

hermes xác thực

Quản lý nhóm thông tin xác thực để xoay vòng khóa của cùng một nhà cung cấp. Xem Nhóm thông tin xác thực để biết tài liệu đầy đủ.

hermes auth                                              # Interactive wizard
hermes auth list                                         # Show all pools
hermes auth list openrouter                              # Show specific provider
hermes auth add openrouter --api-key sk-or-v1-xxx        # Add API key
hermes auth add anthropic --type oauth                   # Add OAuth credential
hermes auth remove openrouter 2                          # Remove by index
hermes auth reset openrouter                             # Clear cooldowns

Các lệnh phụ: add, list, remove, reset. Khi được gọi mà không có lệnh phụ, hãy khởi chạy trình hướng dẫn quản lý tương tác.

trạng thái hermes

hermes status [--all] [--deep]

Tùy chọn	Mô tả
--all	Hiển thị tất cả thông tin chi tiết ở định dạng được biên tập lại có thể chia sẻ.
--sâu	Chạy kiểm tra sâu hơn có thể mất nhiều thời gian hơn.

hermes cron

hermes cron <list|create|edit|pause|resume|run|remove|status|tick>

Tiểu ban	Mô tả
danh sách	Hiển thị công việc theo lịch trình.
tạo / thêm	Tạo công việc đã lên lịch từ lời nhắc, tùy ý đính kèm một hoặc nhiều kỹ năng thông qua --skill lặp đi lặp lại.
chỉnh sửa	Cập nhật lịch trình, lời nhắc, tên, phân phối, số lần lặp lại hoặc các kỹ năng kèm theo của công việc. Hỗ trợ --clear-skills, --add-skill, và --remove-skill.
tạm dừng	Tạm dừng công việc mà không xóa nó.
sơ yếu lý lịch	Tiếp tục công việc bị tạm dừng và tính toán lần chạy tiếp theo trong tương lai.
chạy	Kích hoạt một công việc trên lịch trình đánh dấu tiếp theo.
xóa	Xóa một công việc đã lên lịch.
trạng thái	Kiểm tra xem bộ lập lịch cron có đang chạy không.
đánh dấu	Chạy các công việc đến hạn một lần và thoát.

hermes webhook

hermes webhook <subscribe|list|remove|test>

Quản lý đăng ký webhook động để kích hoạt tổng đài viên theo sự kiện. Yêu cầu bật nền tảng webhook trong cấu hình — nếu chưa được định cấu hình, sẽ in hướng dẫn thiết lập.

Tiểu ban	Mô tả
đăng ký / thêm	Tạo một lộ trình webhook. Trả về URL và bí mật HMAC để định cấu hình trên dịch vụ của bạn.
danh sách / ls	Hiển thị tất cả các đăng ký do đại lý tạo.
xóa / rm	Xóa đăng ký động. Các tuyến tĩnh từ config.yaml không bị ảnh hưởng.
kiểm tra	Gửi POST thử nghiệm để xác minh đăng ký đang hoạt động.

đăng ký webhook hermes

hermes webhook subscribe <name> [options]

Tùy chọn	Mô tả
--promp	Mẫu lời nhắc có tham chiếu tải trọng {dot.notation}.
--sự kiện	Các loại sự kiện được phân tách bằng dấu phẩy để chấp nhận (ví dụ: vấn đề,pull_request). Trống rỗng = tất cả.
--mô tả	Mô tả con người có thể đọc được.
--kỹ năng	Tên kỹ năng được phân tách bằng dấu phẩy để tải khi chạy đại lý.
--giao	Mục tiêu phân phối: log (mặc định), telegram, discord, slack, github_comment.
--deliver-chat-id	Nhắm mục tiêu trò chuyện/ID kênh để phân phối trên nhiều nền tảng.
--bí mật	Bí mật HMAC tùy chỉnh. Tự động tạo nếu bị bỏ qua.

Các gói đăng ký vẫn tồn tại ở ~/.hermes/webhook_subscriptions.json và được bộ chuyển đổi webhook tải lại nóng mà không cần khởi động lại cổng.

bác sĩ hermes

hermes doctor [--fix]

Tùy chọn	Mô tả
--sửa	Cố gắng sửa chữa tự động nếu có thể.

cấu hình hermes

hermes config <subcommand>

Lệnh phụ:

Tiểu ban	Mô tả
show	Hiển thị giá trị cấu hình hiện tại.
chỉnh sửa	Mở config.yaml trong trình chỉnh sửa của bạn.
đặt <khóa> <giá trị>	Đặt giá trị cấu hình.
con đường	In đường dẫn tập tin cấu hình.
env-path	Print the .env file path.
check	Check for missing or stale config.
migrate	Add newly introduced options interactively.

hermes pairing

hermes pairing <list|approve|revoke|clear-pending>

Subcommand	Description
list	Show pending and approved users.
approve <platform> <code>	Approve a pairing code.
revoke <platform> <user-id>	Revoke a user's access.
clear-pending	Clear pending pairing codes.

hermes skills

hermes skills <subcommand>

Subcommands:

Subcommand	Description
browse	Paginated browser for skill registries.
search	Search skill registries.
install	Install a skill.
inspect	Preview a skill without installing it.
list	List installed skills.
check	Check installed hub skills for upstream updates.
update	Reinstall hub skills with upstream changes when available.
audit	Re-scan installed hub skills.
uninstall	Remove a hub-installed skill.
publish	Publish a skill to a registry.
snapshot	Export/import skill configurations.
tap	Manage custom skill sources.
config	Interactive enable/disable configuration for skills by platform.

Common examples:

hermes skills browse
hermes skills browse --source official
hermes skills search react --source skills-sh
hermes skills search https://mintlify.com/docs --source well-known
hermes skills inspect official/security/1password
hermes skills inspect skills-sh/vercel-labs/json-render/json-render-react
hermes skills install official/migration/openclaw-migration
hermes skills install skills-sh/anthropics/skills/pdf --force
hermes skills check
hermes skills update
hermes skills config

Notes:

• --force can override non-dangerous policy blocks for third-party/community skills.
• --force does not override a dangerous scan verdict.
• --source skills-sh searches the public skills.sh directory.
• --source well-known lets you point Hermes at a site exposing /.well-known/skills/index.json.

hermes honcho

hermes honcho [--target-profile NAME] <subcommand>

Manage Honcho cross-session memory integration. This command is provided by the Honcho memory provider plugin and is only available when memory.provider is set to honcho in your config.

The --target-profile flag lets you manage another profile's Honcho config without switching to it.

Subcommands:

Subcommand	Description
setup	Redirects to hermes memory setup (unified setup path).
status [--all]	Show current Honcho config and connection status. --all shows a cross-profile overview.
peers	Show peer identities across all profiles.
sessions	List known Honcho session mappings.
map [name]	Map the current directory to a Honcho session name. Omit name to list current mappings.
peer	Show or update peer names and dialectic reasoning level. Options: --user NAME, --ai NAME, --reasoning LEVEL.
mode [mode]	Show or set recall mode: hybrid, context, or tools. Omit to show current.
tokens	Show or set token budgets for context and dialectic. Options: --context N, --dialectic N.
identity [file] [--show]	Seed or show the AI peer identity representation.
enable	Enable Honcho for the active profile.
disable	Disable Honcho for the active profile.
sync	Sync Honcho config to all existing profiles (creates missing host blocks).
migrate	Step-by-step migration guide from openclaw-honcho to Hermes Honcho.

hermes memory

hermes memory <subcommand>

Set up and manage external memory provider plugins. Available providers: honcho, openviking, mem0, hindsight, holographic, retaindb, byterover, supermemory. Only one external provider can be active at a time. Built-in memory (MEMORY.md/USER.md) is always active.

Subcommands:

Subcommand	Description
setup	Interactive provider selection and configuration.
status	Show current memory provider config.
off	Disable external provider (built-in only).

hermes acp

hermes acp

Starts Hermes as an ACP (Agent Client Protocol) stdio server for editor integration.

Related entrypoints:

hermes-acp
python -m acp_adapter

Install support first:

pip install -e '.[acp]'

See ACP Editor Integration and ACP Internals.

hermes mcp

hermes mcp <subcommand>

Manage MCP (Model Context Protocol) server configurations and run Hermes as an MCP server.

Subcommand	Description
serve [-v|--verbose]	Run Hermes as an MCP server — expose conversations to other agents.
add <name> [--url URL] [--command CMD] [--args ...] [--auth oauth|header]	Add an MCP server with automatic tool discovery.
remove <name> (alias: rm)	Remove an MCP server from config.
list (alias: ls)	List configured MCP servers.
test <name>	Test connection to an MCP server.
configure <name> (alias: config)	Toggle tool selection for a server.

See MCP Config Reference, Use MCP with Hermes, and MCP Server Mode.

hermes plugins

hermes plugins [subcommand]

Manage Hermes Agent plugins. Running hermes plugins with no subcommand launches an interactive curses checklist to enable/disable installed plugins.

Subcommand	Description
(none)	Interactive toggle UI — enable/disable plugins with arrow keys and space.
install <identifier> [--force]	Install a plugin from a Git URL or owner/repo.
update <name>	Pull latest changes for an installed plugin.
remove <name> (aliases: rm, uninstall)	Remove an installed plugin.
enable <name>	Enable a disabled plugin.
disable <name>	Disable a plugin without removing it.
list (alias: ls)	List installed plugins with enabled/disabled status.

Disabled plugins are stored in config.yaml under plugins.disabled and skipped during loading.

See Plugins and Build a Hermes Plugin.

hermes tools

hermes tools [--summary]

Option	Description
--summary	Print the current enabled-tools summary and exit.

Without --summary, this launches the interactive per-platform tool configuration UI.

hermes sessions

hermes sessions <subcommand>

Subcommands:

Subcommand	Description
list	List recent sessions.
browse	Interactive session picker with search and resume.
export <output> [--session-id ID]	Export sessions to JSONL.
delete <session-id>	Delete one session.
prune	Delete old sessions.
stats	Show session-store statistics.
rename <session-id> <title>	Set or change a session title.

hermes insights

hermes insights [--days N] [--source platform]

Option	Description
--days <n>	Analyze the last n days (default: 30).
--source <platform>	Filter by source such as cli, telegram, or discord.

hermes claw

hermes claw migrate [options]

Migrate your OpenClaw setup to Hermes. Reads from ~/.openclaw (or a custom path) and writes to ~/.hermes. Automatically detects legacy directory names (~/.clawdbot, ~/.moldbot) and config filenames (clawdbot.json, moldbot.json).

Option	Description
--dry-run	Preview what would be migrated without writing anything.
--preset <name>	Migration preset: full (default, includes secrets) or user-data (excludes API keys).
--overwrite	Overwrite existing Hermes files on conflicts (default: skip).
--migrate-secrets	Include API keys in migration (enabled by default with --preset full).
--source <path>	Custom OpenClaw directory (default: ~/.openclaw).
--workspace-target <path>	Target directory for workspace instructions (AGENTS.md).
--skill-conflict <mode>	Handle skill name collisions: skip (default), overwrite, or rename.
--yes	Skip the confirmation prompt.

What gets migrated

The migration covers 30+ categories across persona, memory, skills, model providers, messaging platforms, agent behavior, session policies, MCP servers, TTS, and more. Items are either directly imported into Hermes equivalents or archived for manual review.

Directly imported: SOUL.md, MEMORY.md, USER.md, AGENTS.md, skills (4 source directories), default model, custom providers, MCP servers, messaging platform tokens and allowlists (Telegram, Discord, Slack, WhatsApp, Signal, Matrix, Mattermost), agent defaults (reasoning effort, compression, human delay, timezone, sandbox), session reset policies, approval rules, TTS config, browser settings, tool settings, exec timeout, command allowlist, gateway config, and API keys from 3 sources.

Archived for manual review: Cron jobs, plugins, hooks/webhooks, memory backend (QMD), skills registry config, UI/identity, logging, multi-agent setup, channel bindings, IDENTITY.md, TOOLS.md, HEARTBEAT.md, BOOTSTRAP.md.

API key resolution checks three sources in priority order: config values → ~/.openclaw/.env → auth-profiles.json. All token fields handle plain strings, env templates (${VAR}), and SecretRef objects.

For the complete config key mapping, SecretRef handling details, and post-migration checklist, see the full migration guide.

Examples

# Preview what would be migrated
hermes claw migrate --dry-run

# Full migration including API keys
hermes claw migrate --preset full

# Migrate user data only (no secrets), overwrite conflicts
hermes claw migrate --preset user-data --overwrite

# Migrate from a custom OpenClaw path
hermes claw migrate --source /home/user/old-openclaw

hermes profile

hermes profile <subcommand>

Manage profiles — multiple isolated Hermes instances, each with its own config, sessions, skills, and home directory.

Subcommand	Description
list	List all profiles.
use <name>	Set a sticky default profile.
create <name> [--clone] [--clone-all] [--clone-from <source>] [--no-alias]	Create a new profile. --clone copies config, .env, and SOUL.md from the active profile. --clone-all copies all state. --clone-from specifies a source profile.
delete <name> [-y]	Delete a profile.
show <name>	Show profile details (home directory, config, etc.).
alias <name> [--remove] [--name NAME]	Manage wrapper scripts for quick profile access.
rename <old> <new>	Rename a profile.
export <name> [-o FILE]	Export a profile to a .tar.gz archive.
import <archive> [--name NAME]	Import a profile from a .tar.gz archive.

Examples:

hermes profile list
hermes profile create work --clone
hermes profile use work
hermes profile alias work --name h-work
hermes profile export work -o work-backup.tar.gz
hermes profile import work-backup.tar.gz --name restored
hermes -p work chat -q "Hello from work profile"

hermes completion

hermes completion [bash|zsh]

Print a shell completion script to stdout. Source the output in your shell profile for tab-completion of Hermes commands, subcommands, and profile names.

Examples:

# Bash
hermes completion bash >> ~/.bashrc

# Zsh
hermes completion zsh >> ~/.zshrc

Maintenance commands

Command	Description
hermes version	Print version information.
hermes update	Pull latest changes and reinstall dependencies.
hermes uninstall [--full] [--yes]	Remove Hermes, optionally deleting all config/data.

See also

• Slash Commands Reference
• CLI Interface
• Sessions
• Skills System
• Skins & Themes