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 Slash Commands Reference.
Đ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 do
`Hermes profile use
` đặt. |
|
--resume <session>
,
-r <session>
` | Tiếp tục phiên trước đó theo ID hoặc tiêu đề. |
|
--Continue [name]
,
-c [name]
` | 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. |
|
--ignore-user-config
` | Bỏ qua
~/.Hermes/config.yaml
` và quay lại các giá trị mặc định tích hợp sẵn. Thông tin xác thực trong
.env
` vẫn được tải. |
|
--ignore-rules
` | Bỏ qua tính năng tự động tiêm
`AGENTS.md
,
`SOUL.md
,
.Cursorrules
, bộ nhớ và các kỹ năng được tải sẵn. |
|
--TUI
` | Khởi chạy [TUI](../user-guide/TUI.md) thay vì CLI cổ điển. Tương đương với
`Hermes_TUI=1
. |
|
--dev
` | Với
--TUI
: chạy trực tiếp các nguồn TypeScript thông qua
`tsx
` thay vì gói dựng sẵn (dành cho những người đóng góp TUI). |
## Lệnh cấp cao nhất| Lệnh | Mục đích |
|----------|----------|
|
`Hermes chat
` | Trò chuyện tương tác hoặc một lần với đại lý. |
|
`Hermes model
` | Tương tác chọn nhà cung cấp và mô hình mặc định. |
|
`Hermes fallback
` | Quản lý nhà cung cấp dự phòng đã thử khi mô hình chính bị lỗi. |
|
`Hermes gateway
` | Chạy hoặc quản lý dịch vụ cổng nhắn tin. |
|
`Hermes proxy
` | Proxy tương thích OpenAI cục bộ đính kèm thông tin xác thực của nhà cung cấp OAuth. Xem [Subscription Proxy](../user-guide/features/subscription-proxy.md). |
|
`Hermes lsp
` | Quản lý tích hợp Giao thức máy chủ ngôn ngữ (chẩn đoán ngữ nghĩa cho write_file/patch). |
|
`Hermes setup
` | 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 Slack
` | Người trợ giúp Slack (hiện tại: tạo bảng kê khai ứng dụng với mọi lệnh dưới dạng dấu gạch chéo gốc). |
|
`Hermes auth
` | 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 login
` /
`logout
` | **Không được dùng nữa** — thay vào đó hãy sử dụng
`Hermes auth
. |
|
`Hermes status
` | 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. |
|
`Hermes kanban
` | Bảng cộng tác đa cấu hình (nhiệm vụ, liên kết, điều phối). |
|
`Hermes webhook
` | Quản lý đăng ký webhook động để kích hoạt theo sự kiện. |
|
`Hermes hooks
` | Kiểm tra, phê duyệt hoặc xóa các móc shell-script được khai báo trong
`config.yaml
. |
|
`Hermes doctor
` | Chẩn đoán các vấn đề về cấu hình và phụ thuộc. |
|
`Hermes dump
` | Tóm tắt thiết lập có thể sao chép và dán để hỗ trợ/gỡ lỗi. |
|
`Hermes debug
` | Công cụ gỡ lỗi - tải lên nhật ký và thông tin hệ thống để được hỗ trợ. |
|
`Hermes backup
` | Sao lưu thư mục chính của Hermes vào một tệp zip. |
|
`Hermes checkpoints
` | Kiểm tra/cắt tỉa/xóa
~/.Hermes/checkpoints/
` (cửa hàng bóng được
/rollback
` sử dụng). Chạy không có đối số để biết tổng quan về trạng thái. |
|
`Hermes import
` | Khôi phục bản sao lưu Hermes từ tệp zip. |
|
`Hermes logs
` | Xem, theo dõi và lọc các tệp nhật ký tác nhân/cổng/lỗi. |
|
`Hermes config
` | Hiển thị, chỉnh sửa, di chuyển và truy vấn các tệp cấu hình. |
|
`Hermes pairing
` | Phê duyệt hoặc thu hồi mã ghép nối tin nhắn. |
|
`Hermes skills
` | Duyệt, cài đặt, xuất bản, kiểm tra và cấu hình các kỹ năng. |
|
`Hermes bundles
` | Nhóm một số kỹ năng dưới một lệnh gạch chéo
/<name
. Xem [Skill Bundles](../user-guide/features/skills.md#skill-bundles). |
|
`Hermes curator
` | Bảo trì kỹ năng nền - trạng thái, chạy, tạm dừng, ghim. Xem [Curator](../user-guide/features/curator.md). |
|
`Hermes memory
` | Cấu hình nhà cung cấp bộ nhớ ngoài. Các lệnh phụ dành riêng cho plugin (ví dụ:
`Hermes Honcho
) tự động đăng ký khi nhà cung cấp của chúng hoạt động. |
|
`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. |
|
`Hermes plugins
` | Quản lý plugin Hermes Agent (cài đặt, bật, tắt, xóa). |
|
`Hermes portal
` | Trạng thái Nous Portal, liên kết đăng ký và định tuyến Cổng công cụ. Xem [Tool Gateway](../user-guide/features/tool-gateway.md). |
|
`Hermes tools
` | Định cấu hình các công cụ được kích hoạt trên mỗi nền tảng. |
|
`Hermes computer-use
` | Cài đặt hoặc kiểm tra backend cua-driver (Sử dụng máy tính macOS). |
|
`Hermes sessions
` | Duyệt, xuất, cắt tỉa, đổi tên và xóa phiên. |
|
`Hermes insights
` | Hiển thị phân tích mã thông báo/chi phí/hoạt động. |
|
`Hermes claw
` | Người trợ giúp di chuyển OpenClaw. |
|
`Hermes dashboard
` | Khởi chạy trang tổng quan web để quản lý cấu hình, khóa API và phiên. |
|
`Hermes profile
` | Quản lý hồ sơ - nhiều phiên bản Hermes bị cô lập. |
|
`Hermes completion
` | In các tập lệnh hoàn thành shell (bash/zsh/fish). |
|
`Hermes version
` | Hiển thị thông tin phiên bản. |
|
`Hermes update
` | Lấy mã mới nhất và cài đặt lại các phần phụ thuộc (cài đặt git) hoặc kiểm tra PyPI và
`pip install --upgrade
` (cài đặt pip). Xem trước
--check
` mà không cần cài đặt;
--backup
` chụp ảnh chụp nhanh
`Hermes_HOME
` trước khi kéo. |
|
`Hermes uninstall
` | Loại bỏ Hermes khỏi hệ thống. |
##
`Hermes chat
`
``` bash
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. |
|
--provider <provider>
` | Buộc nhà cung cấp:
`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
` (bí danh
`alibaba_coding
),
`DeepSeek
,
`nvidia
,
`OLlama-cloud
,
`xai
` (bí danh
`grok
),
`xai-OAuth
` (bí danh
`grok-OAuth
),
`qwen-OAuth
,
`bedrock
,
`opencode-zen
,
`opencode-go
,
`ai-gateway
,
`azure-foundry
,
`lmstudio
,
`stepfun
,
`tencent-tokenhub
` (bí danh
`tencent
,
`tokenhub
). |
|
-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ế độ lập trình: chặn xem trước biểu ngữ/spinner/công cụ. |
|
--image <path>
` | Đính kèm hình ảnh cục bộ vào một truy vấn. |
|
--resume <session>
` /
--Continue [name]
` | 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. |
|
--checkpoints
` | 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. |
|
--ignore-user-config
` | Bỏ qua
~/.Hermes/config.yaml
` và sử dụng các giá trị mặc định tích hợp sẵn. Thông tin xác thực trong
.env
` vẫn được tải. Hữu ích cho các lần chạy CI riêng biệt, báo cáo lỗi có thể tái tạo và tích hợp của bên thứ ba. |
|
--ignore-rules
` | Bỏ qua tính năng tự động tiêm
`AGENTS.md
,
`SOUL.md
,
.Cursorrules
, bộ nhớ liên tục và các kỹ năng được tải sẵn. Kết hợp với
--ignore-user-config
` để chạy cách ly hoàn toàn. |
|
--source <tag>
` | Thẻ nguồn phiên để lọc (mặc định:
`CLI
). Sử dụng
`tool
` cho các 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. |
|
--max-turns <N>
` | Số lần lặp 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ụ:
``` bash
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"
Hermes chat --ignore-user-config --ignore-rules -q "Repro without my personal setup"
`
###
`Hermes -z <prompt>
` — kịch bản một lần
Đối với người gọi có lập trình (tập lệnh shell, CI, cron, xử lý đường dẫn gốc trong lời nhắc),
`Hermes -z
` là điểm truy cập một lần thuần túy nhất: **dấu nhắc duy nhất, văn bản phản hồi cuối cùng xuất ra, không có gì khác trên thiết bị xuất chuẩn hoặc thiết bị xuất chuẩn.** Không có biểu ngữ, không có vòng quay, không có bản xem trước công cụ, không có dòng
`Session:
` — chỉ là câu trả lời cuối cùng của tổng đài viên dưới dạng văn bản thuần túy.
`bash
Hermes -z "What's the cAPItal of France?"
# → Paris.
# Parent scripts can cleanly capture the response:
answer=$(Hermes -z "summarize this" < /path/to/file.txt)
`
``Ghi đè mỗi lần chạy (không có đột biến đối với
~/.Hermes/config.yaml
):
| Cờ | Tương đương env var | Mục đích |
|---|---|---|
|
-m
` /
--model <model>
` |
`Hermes_INFERENCE_MODEL
` | Ghi đè mô hình cho lần chạy này |
|
--provider <provider>
` | _(không có)_ | Ghi đè nhà cung cấp cho lần chạy này |
``` bash
Hermes -z "…" --provider OpenRouter --model OpenAI/GPT-5.5
# or:
Hermes_INFERENCE_MODEL=Anthropic/Claude-sonnet-4.6 Hermes -z "…"
`
``Cùng một tác nhân, cùng một công cụ, cùng một kỹ năng - chỉ loại bỏ mọi lớp tương tác/mỹ phẩm. Nếu bạn cũng cần đầu ra công cụ trong bản ghi, hãy sử dụng
`Hermes chat -q
;
-z
` rõ ràng là dành cho "Tôi chỉ muốn câu trả lời cuối cùng".
##
`Hermes model
``Nhà cung cấp tương tác + bộ chọn mô hình. **Đây là lệnh để thêm nhà cung cấp mới, thiết lập khóa API và chạy luồng OAuth.** Chạy lệnh này từ terminal của bạn — không phải từ bên trong phiên trò chuyện Hermes đang hoạt động.
``` bash
Hermes model
`
``Sử dụng điều này khi bạn muốn:
- **thêm nhà cung cấp mới** (OpenRouter, Anthropic, Copilot, DeepSeek, tùy chỉnh, v.v.)
- đăng nhập vào các nhà cung cấp được OAuth hỗ trợ (Anthropic, Copilot, Codex, Nous Portal)
- nhập hoặc cập nhật khóa API
- 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:::warning Hermes model vs /model — know the difference
**
`Hermes model
** (chạy từ terminal của bạn, bên ngoài bất kỳ phiên Hermes nào) là **trình hướng dẫn thiết lập nhà cung cấp đầy đủ**. Nó có thể thêm nhà cung cấp mới, chạy luồng OAuth, nhắc khóa API và định cấu hình điểm cuối.
**
/model
** (được nhập vào phiên trò chuyện Hermes đang hoạt động) chỉ có thể **chuyển đổi giữa nhà cung cấp và mô hình bạn đã thiết lập**. Nó không thể thêm nhà cung cấp mới, chạy OAuth hoặc nhắc khóa API.
**Nếu bạn cần thêm nhà cung cấp mới:** Trước tiên hãy thoát khỏi phiên Hermes của bạn (
`Ctrl+C
` hoặc
/quit
), sau đó chạy
`Hermes model
` từ lời nhắc terminal của bạn.
:::
### Lệnh gạch chéo
/model
` (giữa phiên)
Chuyển đổi giữa các mô hình đã được định cấu 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
`
``Theo mặc định, các thay đổi
/model
` chỉ áp dụng ** cho phiên hiện tại**. Thêm
--global
` để tiếp tục thay đổi thành
`config.yaml
:
`
/model Claude-sonnet-4 --global # Switch and save as new default
`
:::info[What if I only see OpenRouter models?]
Nếu bạn chỉ định cấu hình OpenRouter,
/model
` sẽ chỉ hiển thị các mẫu OpenRouter. Để thêm nhà cung cấp khác (Anthropic, DeepSeek, Copilot, v.v.), hãy thoát phiên của bạn và chạy
`Hermes model
` từ terminal.
:::
Các thay đổi của nhà cung cấp và URL cơ sở được tự động duy trì 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.
##
`Hermes gateway
`
``` bash
Hermes gateway <subcommand>
`
``Lệnh phụ:
| Tiểu ban | Mô tả |
|----------||-------------|
|
`run
` | Chạy cổng ở phía trước. Được đề xuất cho WSL, Docker và Termux. |
|
`start
` | Bắt đầu dịch vụ nền systemd/launchd đã cài đặt. |
|
`stop
` | Dừng dịch vụ (hoặc quá trình tiền cảnh). |
|
`restart
` | Khởi động lại dịch vụ. |
|
`status
` | Hiển thị trạng thái dịch vụ. |
|
`list
` | Liệt kê **tất cả cấu hình** và liệu cổng của mỗi cấu hình hiện có đang chạy hay không (với PID nếu có). Hữu ích khi bạn chạy nhiều cấu hình cạnh nhau và muốn có một cái nhìn tổng quan duy nhất. |
|
`install
` | Cài đặt dưới dạng dịch vụ nền systemd (Linux) hoặc launchd (macOS). |
|
`uninstall
` | Xóa dịch vụ đã cài đặt. |
|
`setup
` | Thiết lập nền tảng nhắn tin tương tác. |
Tùy chọn:
| Tùy chọn | Mô tả |
|--------|-------------|
|
`
--all
` | Trên
`start
` /
`restart
` /
`stop
: hoạt động trên cổng **của mọi cấu hình**, không chỉ
`Hermes_HOME
` đang hoạt động. Hữu ích nếu bạn chạy nhiều cấu hình cạnh nhau và muốn khởi động lại tất cả chúng sau
`Hermes update
. |
:::tip[WSL users]
Sử dụng
`Hermes gateway run
` thay vì
`Hermes gateway start
- hỗ trợ systemd của WSL không đáng tin cậy. Gói nó trong tmux để duy trì sự bền bỉ:
`tmux new -s Hermes 'Hermes gateway run'
. Xem [WSL FAQ](/docs/reference/faq#wsl-gateway-keeps-disconnecting-or-Hermes-gateway-start-fails) để biết chi tiết.
:::
##
`Hermes lsp
`
``` bash
Hermes lsp <subcommand>
`
``Quản lý tích hợp Giao thức máy chủ ngôn ngữ. LSP chạy thật
máy chủ ngôn ngữ (pyright, gopls, Rust-analyzer, ...) trong
làm nền và đưa thông tin chẩn đoán của họ vào quá trình kiểm tra sau khi viết
được sử dụng bởi
`write_file
` và
`patch
. Kiểm soát việc phát hiện không gian làm việc của git
— LSP chỉ chạy khi tệp cwd hoặc tệp đã chỉnh sửa nằm trong git
cây làm việc.
Lệnh phụ:
| Tiểu ban | Mô tả |
|----------||-------------|
|
`status
` | Hiển thị trạng thái dịch vụ, máy chủ được cấu hình, trạng thái cài đặt. |
|
`list
` | In sổ đăng ký của các máy chủ được hỗ trợ. Vượt qua
`
--installed-only
` để bỏ qua những cái còn thiếu. |
|
`install <id>
` | Háo hức cài đặt nhị phân của một máy chủ. |
|
`install-all
` | Cài đặt mọi máy chủ với công thức cài đặt tự động đã biết. |
|
`restart
` | Loại bỏ các máy khách đang chạy để lần chỉnh sửa tiếp theo xuất hiện lại. |
|
`which <id>
` | In đường dẫn nhị phân đã giải quyết cho một máy chủ. |
Xem [LSP — Semantic Diagnostics](/docs/user-guide/features/lsp) để biết
hướng dẫn đầy đủ, ngôn ngữ được hỗ trợ và nút cấu hình.
##
`Hermes setup
`
``` bash
Hermes setup [model|tts|terminal|gateway|tools|agent] [--non-interactive] [--reset] [--quick] [--reconfigure] [--portal]
`
``**Lần chạy đầu tiên:** khởi chạy trình hướng dẫn lần đầu tiên.
**Người dùng cũ (đã được định cấu hình):** chuyển thẳng vào trình hướng dẫn cấu hình lại đầy đủ — mọi lời nhắc đều hiển thị giá trị hiện tại của bạn làm giá trị mặc định, nhấn Enter để giữ hoặc nhập một giá trị mới. Không có thực đơn.
Chuyển đến một phần thay vì trình hướng dẫn đầy đủ:| Phần | Mô tả |
|----------|-------------|
|
`model
` | Thiết lập nhà cung cấp và mô hình. |
|
`terminal
` | Thiết lập phụ trợ terminal và hộp cát. |
|
`gateway
` | Thiết lập nền tảng nhắn tin. |
|
`tools
` | Bật/tắt các công cụ trên mỗi nền tảng. |
|
`agent
` | Cài đặt hành vi của đại lý. |
Tùy chọn:
| Tùy chọn | Mô tả |
|--------|-------------|
|
`
--quick
` | Khi người dùng quay lại chạy: chỉ nhắc các mục bị thiếu hoặc chưa được đặt. Bỏ qua các mục bạn đã cấu hình. |
|
--non-interactive
` | Sử dụng giá trị mặc định/môi trường mà không cần lời nhắc. |
|
--reset
` | Đặt lại cấu hình về mặc định trước khi thiết lập. |
|
--reconfigure
` | Bí danh tương thích ngược -
`Hermes setup
` trần trên bản cài đặt hiện có hiện thực hiện điều này theo mặc định. |
|
--portal
` | Thiết lập Nous Portal một lần: đăng nhập qua OAuth, đặt Nous làm nhà cung cấp suy luận và chọn tham gia [Tool Gateway](../user-guide/features/tool-gateway.md). Bỏ qua phần còn lại của trình hướng dẫn. |
##
`Hermes portal
`
``` bash
Hermes portal [status|open|tools]
`
``Kiểm tra xác thực Nous Portal, định tuyến Cổng công cụ và truy cập trang đăng ký. Lệnh gọi không có lệnh phụ chạy
`status
.
| Tiểu ban | Mô tả |
|----------||-------------|
|
`status
` (mặc định) | Trạng thái xác thực cổng thông tin + tóm tắt định tuyến Cổng công cụ trên mỗi công cụ. Cũng được hiển thị khi không có lệnh phụ nào được đưa ra. |
|
`open
` | Mở
`portal.NousResearch.com/manage-subscription
` trong trình duyệt mặc định của bạn. |
|
`tools
` | Liệt kê mọi đối tác Cổng công cụ (Firecrawl, FAL, OpenAI TTS, Sử dụng trình duyệt, Phương thức) và được định tuyến qua Nous. |
Để biết cấu hình của chính cổng đó, hãy xem [Tool Gateway](../user-guide/features/tool-gateway.md). Để biết đường dẫn thiết lập một lần, hãy xem
`Hermes setup --portal
` ở trên.
##
`Hermes WhatsApp
`
`bash
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 Slack
`
`bash
Hermes Slack manifest # print manifest to stdout
Hermes Slack manifest --write # write to ~/.Hermes/Slack-manifest.JSON
Hermes Slack manifest --slashes-only # just the features.slash_commands array
`
``Tạo một bảng kê khai ứng dụng Slack đăng ký mọi lệnh cổng trong
`COMMAND_REGISTRY
` (
/btw
,
/stop
,
/model
, …) là hạng nhất
Lệnh gạch chéo Slack - khớp với tính chẵn lẻ của Discord và Telegram. Dán
xuất vào cấu hình ứng dụng Slack của bạn tại
[https://API.Slack.com/apps](https://API.Slack.com/apps) → ứng dụng của bạn →
**Tính năng → Bản kê khai ứng dụng → Chỉnh sửa**, sau đó **Lưu**. Lời nhắc của Slack cho
cài đặt lại nếu phạm vi hoặc lệnh gạch chéo thay đổi.
| Cờ | Mặc định | Mục đích |
|------|----------|----------|
|
--write [PATH]
` | thiết bị xuất chuẩn | Ghi vào một tập tin thay vì thiết bị xuất chuẩn. Bare
--write
` viết
$Hermes_HOME/Slack-manifest.JSON
. |
|
--name NAME
` |
`Hermes
` | Tên hiển thị của bot trong Slack. |
|
--description DESC
` | lời giới thiệu mặc định | Mô tả bot hiển thị trong thư mục ứng dụng Slack. |
|
--slashes-only
` | tắt | Chỉ phát ra
`features.slash_commands
` để hợp nhất vào một bảng kê khai được duy trì thủ công. |
Chạy lại
`Hermes Slack manifest --write
` sau
`Hermes update
` để chọn
thêm bất kỳ lệnh mới nào.
##
`Hermes login
` /
`Hermes logout
` *(Không dùng nữa)*
:::caution
`Hermes login
` đã 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 auth
``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 [Credential Pools](/docs/user-guide/features/credential-pools) để biết tài liệu đầy đủ.
``` bash
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
Hermes auth status Anthropic # Show auth status for a provider
Hermes auth logout Anthropic # Log out and clear stored auth state
Hermes auth spotify # Authenticate Hermes with Spotify via PKCE
`
``Các lệnh phụ:
`add
,
`list
,
`remove
,
`reset
,
`status
,
`logout
,
`spotify
. 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.
##
`Hermes status
`
`bash
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ẻ. |
|
--deep
` | Chạy kiểm tra sâu hơn có thể mất nhiều thời gian hơn. |
##
`Hermes cron
`
``` bash
Hermes cron <list|create|edit|pause|resume|run|remove|status|tick>
`
| Tiểu ban | Mô tả |
|----------||-------------|
|
`list
` | Hiển thị công việc theo lịch trình. |
|
`create
` /
`add
` | Tạo công việc theo lịch trình từ lời nhắc, tùy chọn đính kèm một hoặc nhiều kỹ năng thông qua
`
--skill
` lặp đi lặp lại. |
|
`edit
` | 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
. |
|
`pause
` | Tạm dừng công việc mà không xóa nó. |
|
`resume
` | 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. |
|
`run
` | Kích hoạt một công việc trên lịch trình đánh dấu tiếp theo. |
|
`remove
` | Xóa một công việc đã lên lịch. |
|
`status
` | Kiểm tra xem bộ lập lịch cron có đang chạy không. |
|
`tick
` | Chạy các công việc đến hạn một lần và thoát. |
##
`Hermes kanban
`
``` bash
Hermes kanban [--board <slug>] <action> [options]
`
``Ban cộng tác đa hồ sơ, đa dự án. Mỗi lần cài đặt có thể lưu trữ nhiều bảng (một bảng cho mỗi dự án, kho lưu trữ hoặc tên miền); mỗi bảng là một hàng đợi độc lập với phạm vi bộ điều phối và cơ sở dữ liệu SQLite riêng. Các bản cài đặt mới bắt đầu với một bo mạch có tên
`default
, có DB là
~/.Hermes/kanban.db
` để tương thích ngược; các bảng bổ sung có tại
~/.Hermes/kanban/boards/<slug/kanban.db
. Bộ điều phối được nhúng vào cổng sẽ quét từng bảng trên mỗi tích tắc.
**Cờ toàn cầu (áp dụng cho mọi hành động bên dưới):**
| Cờ | Mục đích |
|------|----------|
|
`
--board <slug
` | Hoạt động trên một bảng cụ thể. Mặc định cho bảng hiện tại (được đặt qua
`Hermes kanban boards switch
,
`Hermes_KANBAN_BOARD
` env var hoặc
`default
). |`**Đây là bề mặt con người / tập lệnh.** Nhân viên đặc vụ do người điều phối sinh ra điều khiển bảng thông qua
`kanban_*
` [toolset](/docs/user-guide/features/kanban#how-workers-interact-with-the-board) chuyên dụng (
`kanban_show
,
`kanban_complete
,
`kanban_block
,
`kanban_create
,
`kanban_link
,
`kanban_comment
,
`kanban_heartbeat
; hồ sơ người điều phối cũng nhận được
`kanban_list
` và
`kanban_unblock
) thay vì tách thành
`Hermes kanban
. Công nhân đã ghim
`Hermes_KANBAN_BOARD
` trong môi trường của họ để họ không thể nhìn thấy các bảng khác.| Hành động | Mục đích |
|--------|----------|
|
`init
` | Tạo
`kanban.db
` nếu thiếu. Bình thường. |
|
`boards list
` /
`boards ls
` | Liệt kê tất cả các bảng có số lượng nhiệm vụ.
--JSON
,
--all
` (bao gồm đã lưu trữ). |
|
`boards create <slug>
` | Tạo một bảng mới. Cờ:
--name
,
--description
,
--icon
,
--color
,
--switch
` (kích hoạt). Slug là kebab-case, tự động rút gọn. |
|
`boards switch <slug>
` /
`boards use
` | Duy trì
<slug
` làm bảng hoạt động (ghi
~/.Hermes/kanban/current
). |
|
`boards show
` /
`boards current
` | In tên, đường dẫn DB và số lượng nhiệm vụ của bảng hiện đang hoạt động. |
|
`boards rename <slug> "<name>"
` | Thay đổi tên hiển thị của bảng. Slug là bất biến. |
|
`boards rm <slug>
` | Lưu trữ (mặc định) hoặc xóa cứng một bảng.
--delete
` bỏ qua bước lưu trữ. Các bảng đã lưu trữ chuyển sang
`boards/_archived/<slug>-<ts>/
. Từ chối
`default
. |
|
`create "<title>"
` | Tạo một nhiệm vụ mới trên bảng hoạt động. Cờ:
--body
,
--assignee
,
--parent
` (có thể lặp lại),
--workspace scratch\|worktree\|dir:<path>
,
--tenant
,
--priority
,
--triage
,
--idempotency-key
,
--max-runtime
,
--max-retries
,
--skill
` (có thể lặp lại). |
|
`list
` /
`ls
` | Liệt kê các nhiệm vụ trên bảng hoạt động. Bộ lọc với
--mine
,
--assignee
,
--status
,
--tenant
,
--archived
,
--JSON
. |
|
`show <id>
` | Hiển thị một nhiệm vụ với các bình luận và sự kiện.
--JSON
` cho đầu ra máy. |
|
`assign <id> <profile>
` | Phân công hoặc phân công lại. Sử dụng
`none
` để bỏ chỉ định. Bị từ chối trong khi tác vụ đang chạy. |
|
`link <parent> <child>
` | Thêm một phụ thuộc. Đã phát hiện chu kỳ. Cả hai nhiệm vụ phải ở trên cùng một bảng. |
|
`unlink <parent> <child>
` | Loại bỏ một phụ thuộc. |
|
`claim <id>
` | Về mặt nguyên tử, hãy yêu cầu một nhiệm vụ đã sẵn sàng. In đường dẫn không gian làm việc đã giải quyết. |
|
`comment <id> "<text>"
` | Thêm một bình luận. Nhân viên tiếp theo xác nhận nhiệm vụ sẽ đọc nhiệm vụ đó như một phần của phản hồi
`kanban_show()
. |
|
`complete <id>
` | Đánh dấu nhiệm vụ đã hoàn thành. Cờ:
--result
,
--summary
,
--metadata
. |
|
`block <id> "<reason>"
` | Đánh dấu nhiệm vụ bị chặn đối với đầu vào của con người. Cũng nối thêm lý do như một bình luận. |
|
`schedule <id> "<reason>"
` | Công việc trì hoãn/theo dõi thời gian đỗ xe trong
`scheduled
` nên nó không được hiển thị dưới dạng trình chặn con người. |
|
`unblock <id>
` | Đưa tác vụ bị chặn hoặc theo lịch trình về trạng thái sẵn sàng (hoặc
`todo
` nếu phần phụ thuộc vẫn mở). |
|
`archive <id>
` | Ẩn khỏi danh sách mặc định.
`gc
` sẽ loại bỏ các không gian làm việc bị trầy xước. |
|
`tail <id>
` | Theo dõi luồng sự kiện của nhiệm vụ. |
|
`dispatch
` | Một người điều phối vượt qua bảng hoạt động. Cờ:
--dry-run
,
--max N
,
--failure-limit N
,
--JSON
. |
|
`context <id>
` | In toàn bộ ngữ cảnh mà nhân viên sẽ thấy (tiêu đề + nội dung + kết quả gốc + nhận xét). |
|
`specify <id>
` /
`specify --all
` | Đưa nhiệm vụ theo cột phân loại thành thông số kỹ thuật cụ thể (tiêu đề + nội dung với mục tiêu, cách tiếp cận, tiêu chí chấp nhận) thông qua LLM phụ trợ, sau đó quảng bá nó lên
`todo
. Cờ:
--tenant
` (phạm vi
--all
` cho một đối tượng thuê),
--author
,
--JSON
. Định cấu hình mô hình theo
`auxiliary.triage_specifier
` trong
`config.yaml
. |
|
`decompose <id>
` /
`decompose --all
` | Sắp xếp một nhiệm vụ theo cột phân loại thành biểu đồ gồm các nhiệm vụ con được định tuyến đến hồ sơ chuyên gia theo mô tả (đường dẫn do người điều phối điều khiển). Quay lại xúc tiến một nhiệm vụ theo kiểu chỉ định khi LLM quyết định rằng nhiệm vụ đó không được hưởng lợi từ việc phân bổ nhiệm vụ. Các cờ tương tự như
`specify
. Định cấu hình mô hình theo
`auxiliary.kanban_decomposer
` trong
`config.yaml
. Cũng tự động chạy mỗi khi đánh dấu bộ điều phối
`kanban.auto_decompose: true
` (mặc định). Xem [Auto vs Manual orchestration](/docs/user-guide/features/kanban#auto-vs-manual-orchestration). |
|
`gc
` | Loại bỏ không gian làm việc thô cho các tác vụ đã lưu trữ. |
Ví dụ:
``` bash
# Create a second board and put a task on it without switching away.
Hermes kanban boards create atm10-server --name "ATM10 Server" --icon 🎮
Hermes kanban --board atm10-server create "Restart server" --assignee ops
# Switch the active board for subsequent calls.
Hermes kanban boards switch atm10-server
Hermes kanban list # shows atm10-server tasks
# Archive a board (recoverable) or hard-delete it.
Hermes kanban boards rm atm10-server
Hermes kanban boards rm atm10-server --delete
`
``Thứ tự giải quyết hội đồng (ưu tiên cao nhất trước): Cờ
--board <slug
` →
`Hermes_KANBAN_BOARD
` env var → tệp
~/.Hermes/kanban/current
` →
`default
.Tất cả hành động cũng có sẵn dưới dạng lệnh gạch chéo trong cổng (
/kanban …
), với cùng bề mặt đối số — bao gồm các lệnh phụ
`boards
` và cờ
--board
.
Để có thiết kế đầy đủ — so sánh với CLIne Kanban / PaperCLIp / NanoClaw / Gemini Enterprise, tám mẫu cộng tác, bốn câu chuyện của người dùng, bằng chứng về tính đúng đắn của đồng thời — xem
`docs/Hermes-kanban-v1-spec.pdf
` trong kho lưu trữ hoặc [Kanban user guide](/docs/user-guide/features/kanban).
##
`Hermes webhook
`
``` bash
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ả |
|----------||-------------|
|
`subscribe
` /
`add
` | 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. |
|
`list
` /
`ls
` | Hiển thị tất cả các đăng ký do đại lý tạo. |
|
`remove
` /
`rm
` | Xóa đăng ký động. Các tuyến tĩnh từ config.yaml không bị ảnh hưởng. |
|
`test
` | Gửi POST thử nghiệm để xác minh đăng ký đang hoạt động. |
###
`Hermes webhook subscribe
`
`bash
Hermes webhook subscribe <name [options]
`
| Tùy chọn | Mô tả |
|--------|-------------|
|
`
--prompt
` | Mẫu lời nhắc có tham chiếu tải trọng
\{dot.notation}
. |
|
--events
` | Các loại sự kiện được phân tách bằng dấu phẩy để chấp nhận (ví dụ:
`issues,pull_request
). Trống rỗng = tất cả. |
|
--description
` | Mô tả con người có thể đọc được. |
|
--skills
` | Tên kỹ năng được phân tách bằng dấu phẩy để tải khi chạy đại lý. |
|
--deliver
` | 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. |
|
--secret
` | Bí mật HMAC tùy chỉnh. Tự động tạo nếu bị bỏ qua. |
|
--deliver-only
` | Bỏ qua tác nhân — gửi
--prompt
` được hiển thị dưới dạng thông báo theo nghĩa đen. Chi phí LLM bằng không, giao hàng dưới giây. Yêu cầu
--deliver
` phải là mục tiêu thực sự (không phải
`log
). |
Các gói đăng ký vẫn tồn tại với
~/.Hermes/webhook_subscriptions.JSON
` và được bộ chuyển đổi webhook tải lại nhanh mà không cần khởi động lại cổng.
##
`Hermes doctor
`
``` bash
Hermes doctor [--fix]
`
| Tùy chọn | Mô tả |
|--------|-------------|
|
`
--fix
` | Cố gắng sửa chữa tự động nếu có thể. |
##
`Hermes dump
`
``` bash
Hermes dump [--show-keys]
`
``Xuất bản tóm tắt ngắn gọn, bằng văn bản đơn giản về toàn bộ quá trình thiết lập Hermes của bạn. Được thiết kế để sao chép và dán vào Discord, GitHub hoặc Telegram khi yêu cầu hỗ trợ — không có màu ANSI, không có định dạng đặc biệt, chỉ có dữ liệu.
| Tùy chọn | Mô tả |
|--------|-------------|
|
`
--show-keys
` | Hiển thị tiền tố khóa API được sắp xếp lại (4 ký tự đầu tiên và cuối cùng) thay vì chỉ
`set
/
`not set
. |
### Nó bao gồm những gì
| Phần | Chi tiết |
|----------|----------|
| **Tiêu đề** | Phiên bản Hermes, ngày phát hành, hàm băm git commit |
| **Môi trường** | HĐH, phiên bản Python, phiên bản OpenAI SDK |
| **Danh tính** | Tên hồ sơ đang hoạt động, đường dẫn Hermes_HOME |
| **Người mẫu** | Nhà cung cấp và mô hình mặc định được định cấu hình |
| **Thiết bị đầu cuối** | Loại phụ trợ (cục bộ, Docker, SSH, v.v.) |
| **Khóa API** | Kiểm tra sự hiện diện của tất cả 22 khóa API nhà cung cấp/công cụ |
| **Tính năng** | Bộ công cụ được kích hoạt, số lượng máy chủ MCP, nhà cung cấp bộ nhớ |
| **Dịch vụ** | Trạng thái cổng, nền tảng nhắn tin được định cấu hình |
| **Khối lượng công việc** | Số lượng công việc định kỳ, số lượng kỹ năng đã cài đặt |
| **Ghi đè cấu hình** | Bất kỳ giá trị cấu hình nào khác với giá trị mặc định |
### Đầu ra ví dụ
`
--- 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 ---
### Khi nào nên sử dụng
- Báo cáo lỗi trên GitHub — dán kết xuất vào vấn đề của bạn
- Yêu cầu trợ giúp trong Discord — chia sẻ nó trong khối mã
- So sánh thiết lập của bạn với người khác
- Kiểm tra độ tỉnh táo nhanh khi có gì đó không hoạt động
:::tip
`Hermes dump
` được thiết kế đặc biệt để chia sẻ. Để chẩn đoán tương tác, hãy sử dụng
`Hermes doctor
. Để có cái nhìn tổng quan trực quan, hãy sử dụng
`Hermes status
.
:::
##
`Hermes debug
`
``` bash
Hermes debug share [options]
`
``Tải báo cáo gỡ lỗi (thông tin hệ thống + nhật ký gần đây) lên dịch vụ dán và nhận URL có thể chia sẻ. Hữu ích cho các yêu cầu hỗ trợ nhanh — bao gồm mọi thứ mà người trợ giúp cần để chẩn đoán sự cố của bạn.| Tùy chọn | Mô tả |
|--------|-------------|
|
`
--lines <N>
` | Số dòng nhật ký cần đưa vào mỗi tệp nhật ký (mặc định: 200). |
|
--expire <days>
` | Dán hết hạn theo ngày (mặc định: 7). |
|
--local
` | In báo cáo cục bộ thay vì tải lên. |
Báo cáo bao gồm thông tin hệ thống (OS, phiên bản Python, phiên bản Hermes), nhật ký cổng và tác nhân gần đây (giới hạn 512 KB cho mỗi tệp) và trạng thái khóa API được xử lý lại. Chìa khóa luôn được sắp xếp lại — không có bí mật nào được tải lên.
Các dịch vụ dán đã thử theo thứ tự: dán.rs, dpaste.com.
### Ví dụ
``` bash
Hermes debug share # Upload debug report, print URL
Hermes debug share --lines 500 # Include more log lines
Hermes debug share --expire 30 # Keep paste for 30 days
Hermes debug share --local # Print report to terminal (no upload)
`
##
`Hermes backup
`
`bash
Hermes backup [options]
`
``Tạo một kho lưu trữ zip về cấu hình, kỹ năng, phiên và dữ liệu Hermes của bạn. Bản sao lưu không bao gồm cơ sở mã Hermes-agent.
| Tùy chọn | Mô tả |
|--------|-------------|
|
`
-o
,
--output <path
` | Đường dẫn đầu ra cho tệp zip (mặc định:
~/Hermes-backup-<timestamp.zip
). |
|
-q
,
--quick
` | Ảnh chụp nhanh: chỉ các tệp trạng thái quan trọng (config.yaml, state.db, .env, auth, cron jobs). Nhanh hơn nhiều so với bản sao lưu đầy đủ. |
|
-l
,
--label <name
` | Nhãn cho ảnh chụp nhanh (chỉ được sử dụng với
--quick
). |
Bản sao lưu sử dụng API
`backup()
` của SQLite để sao chép an toàn, do đó, nó hoạt động chính xác ngay cả khi Hermes đang chạy (chế độ WAL an toàn).
**Những gì bị loại trừ khỏi zip:**
-
*.db-wal
,
*.db-shm
,
*.db-journal
` — WAL / bộ nhớ dùng chung / sidecar tạp chí của SQLite. Tệp
*.db
` đã có ảnh chụp nhanh nhất quán thông qua
`SQLite3.backup()
; vận chuyển các sidecar trực tiếp cùng với nó sẽ cho phép khôi phục thấy trạng thái cam kết một nửa.
-
`checkpoints/
` — bộ đệm quỹ đạo mỗi phiên. Khóa băm và được tạo lại mỗi phiên; Dù sao thì cũng sẽ không chuyển sang bản cài đặt khác một cách sạch sẽ.
- Bản thân mã
`Hermes-agent
` (đây là bản sao lưu dữ liệu người dùng, không phải bản chụp nhanh repo).
### Ví dụ
``` bash
Hermes backup # Full backup to ~/Hermes-backup-*.zip
Hermes backup -o /tmp/Hermes.zip # Full backup to specific path
Hermes backup --quick # Quick state-only snapshot
Hermes backup --quick --label "pre-upgrade" # Quick snapshot with label
`
##
`Hermes checkpoints
`
`bash
Hermes checkpoints [COMMAND]
`
``Kiểm tra và quản lý kho lưu trữ bóng git tại
~/.Hermes/checkpoints/
- lớp lưu trữ đằng sau lệnh
/rollback
` trong phiên. An toàn để chạy bất cứ lúc nào; không yêu cầu tác nhân phải chạy.
| Tiểu ban | Mô tả |
|----------||-------------|
|
`status
` (mặc định) | Hiển thị tổng quy mô, số lượng dự án và phân tích từng dự án. Trần
`Hermes checkpoints
` tương đương. |
|
`list
` | Bí danh cho
`status
. |
|
`prune
` | Buộc quét dọn - xóa các dự án mồ côi và cũ, GC cửa hàng, thực thi giới hạn kích thước. Bỏ qua điểm đánh dấu tạm thời 24h. |
|
`clear
` | Xóa toàn bộ cơ sở trạm kiểm soát. Không thể đảo ngược; yêu cầu xác nhận trừ khi
`
-f
. |
|
`clear-legacy
` | Chỉ xóa các kho lưu trữ
`legacy-<timestamp>/
` được tạo bởi quá trình di chuyển v1→v2. |
### Tùy chọn
| Tùy chọn | Tiểu ban | Mô tả |
|--------|-------------|-------------|
|
--limit N
` |
`status
,
`list
` | Các dự án tối đa được liệt kê (mặc định là 20). |
|
--retention-days N
` |
`prune
` | Loại bỏ các dự án có
`last_touch
` cũ hơn N ngày (mặc định là 7). |
|
--max-size-mb N
` |
`prune
` | Sau thẻ mồ côi/cũ, hãy bỏ cam kết cũ nhất cho mỗi dự án cho đến khi tổng kích thước cửa hàng ≤ N MB (mặc định là 500). |
|
--keep-orphans
` |
`prune
` | Bỏ qua việc xóa các dự án có thư mục làm việc không còn tồn tại. |
|
-f
,
--force
` |
`clear
,
`clear-legacy
` | Bỏ qua lời nhắc xác nhận. |
### Ví dụ
``` bash
Hermes checkpoints # status overview
Hermes checkpoints prune --retention-days 3 # aggressive cleanup
Hermes checkpoints prune --max-size-mb 200 # tighten size cap once
Hermes checkpoints clear-legacy -f # drop v1 archive dirs
Hermes checkpoints clear -f # wipe everything
`
``Xem [Checkpoints and XPROTECTX537XPROTECTX](../user-guide/checkpoints-and-rollback.md) để biết kiến trúc đầy đủ và các lệnh trong phiên.
##
`Hermes import
`
`bash
Hermes import <zipfile [options]
`
``Khôi phục bản sao lưu Hermes đã tạo trước đó vào thư mục chính Hermes của bạn. Tất cả các tệp trong kho lưu trữ sẽ ghi đè lên các tệp hiện có trong nhà Hermes của bạn;
`
--force
` chỉ bỏ qua lời nhắc xác nhận sẽ kích hoạt khi mục tiêu đã cài đặt Hermes.
| Tùy chọn | Mô tả |
|--------|-------------|
|
-f
,
--force
` | Bỏ qua lời nhắc xác nhận cài đặt hiện có. |
:::warning
Dừng cổng trước khi nhập để tránh xung đột với các tiến trình đang chạy.
:::
### Ví dụ
`
``` bash
Hermes import ~/Hermes-backup-20260423.zip # Prompts before overwriting existing config
Hermes import ~/Hermes-backup-20260423.zip --force # Overwrite without prompting
`
##
`Hermes logs
`
`bash
Hermes logs [log_name] [options]
`
`Xem, theo dõi và lọc các tệp nhật ký Hermes. Tất cả nhật ký được lưu trữ trong
~/.Hermes/logs/
` (hoặc
<profile>/logs/
` cho các cấu hình không mặc định).
### Tệp nhật ký
| Tên | Tập tin | Nó chụp được gì |
|------|------|-----------------|
|
`agent
` (mặc định) |
`agent.log
` | Tất cả hoạt động của tác nhân - Cuộc gọi API, gửi công cụ, vòng đời phiên (INFO trở lên) |
|
`errors
` |
`errors.log
` | Chỉ cảnh báo và lỗi — một tập hợp con được lọc của Agent.log |
|
`gateway
` |
`gateway.log
` | Hoạt động của cổng nhắn tin — kết nối nền tảng, gửi tin nhắn, sự kiện webhook |
### Tùy chọn
| Tùy chọn | Mô tả |
|--------|-------------|
|
`log_name
` | Nhật ký nào để xem:
`agent
` (mặc định),
`errors
,
`gateway
` hoặc
`list
` để hiển thị các tệp có sẵn với kích thước. |
|
`
-n
,
--lines <N>
` | Số dòng hiển thị (mặc định: 50). |
|
-f
,
--follow
` | Theo dõi nhật ký theo thời gian thực, như
`tail -f
. Nhấn Ctrl+C để dừng. |
|
--level <LEVEL>
` | Cấp nhật ký tối thiểu để hiển thị:
`DEBUG
,
`INFO
,
`WARNING
,
`ERROR
,
`CRITICAL
. |
|
--session <ID>
` | Lọc các dòng chứa chuỗi con ID phiên. |
|
--since <TIME>
` | Hiển thị các dòng từ thời điểm tương đối trước:
`30m
,
`1h
,
`2d
, v.v. Hỗ trợ
`s
` (giây),
`m
` (phút),
`h
` (giờ),
`d
` (ngày). |
|
--component <NAME>
` | Lọc theo thành phần:
`gateway
,
`agent
,
`tools
,
`CLI
,
`cron
. |
### Ví dụ
``` bash
# View the last 50 lines of agent.log (default)
Hermes logs
# Follow agent.log in real time
Hermes logs -f
# View the last 100 lines of gateway.log
Hermes logs gateway -n 100
# Show only warnings and errors from the last hour
Hermes logs --level WARNING --since 1h
# Filter by a specific session
Hermes logs --session abc123
# Follow errors.log, starting from 30 minutes ago
Hermes logs errors --since 30m -f
# List all log files with their sizes
Hermes logs list
`
### Lọc
Bộ lọc có thể được kết hợp. Khi nhiều bộ lọc hoạt động, một dòng nhật ký phải vượt qua **tất cả** các bộ lọc đó để được hiển thị:
``` bash
# WARNING+ lines from the last 2 hours containing session "tg-12345"
Hermes logs --level WARNING --since 2h --session tg-12345
`
``Các dòng không có dấu thời gian có thể phân tích cú pháp được bao gồm khi
--since
` đang hoạt động (chúng có thể là các dòng tiếp tục từ mục nhập nhật ký nhiều dòng). Các dòng không có mức có thể phát hiện được sẽ được bao gồm khi
--level
` đang hoạt động.
### Xoay vòng nhật ký
Hermes sử dụng
`RotatingFileHandler
` của Python. Nhật ký cũ được xoay tự động - hãy tìm
`agent.log.1
,
`agent.log.2
, v.v. Lệnh con
`Hermes logs list
` hiển thị tất cả các tệp nhật ký bao gồm cả các tệp nhật ký được xoay.
##
`Hermes config
`
``` bash
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. |
|
`edit
` | Mở
`config.yaml
` trong trình chỉnh sửa của bạn. |
|
`set <key <value
` | Đặt giá trị cấu hình. |
|
`path
` | In đường dẫn tập tin cấu hình. |
|
`env-path
` | In đường dẫn tệp
.env
. |
|
`check
` | Kiểm tra cấu hình bị thiếu hoặc cũ. |
|
`migrate
` | Thêm các tùy chọn mới được giới thiệu một cách tương tác. |
##
`Hermes pairing
`
`bash
Hermes pairing <list|approve|revoke|clear-pending>
`
| Tiểu ban | Mô tả |
|----------||-------------|
|
`list
` | Hiển thị người dùng đang chờ xử lý và được phê duyệt. |
|
`approve <platform> <code>
` | Phê duyệt mã ghép nối. |
|
`revoke <platform> <user-id>
` | Thu hồi quyền truy cập của người dùng. |
|
`clear-pending
` | Xóa mã ghép nối đang chờ xử lý. |
##
`Hermes skills
`
`bash
Hermes skills <subcommand
`
``Lệnh phụ:
| Tiểu ban | Mô tả |
|----------||-------------|
|
`browse
` | Trình duyệt được phân trang để đăng ký kỹ năng. |
|
`search
` | Tìm kiếm đăng ký kỹ năng. |
|
`install
` | Cài đặt một kỹ năng. |
|
`inspect
` | Xem trước một kỹ năng mà không cần cài đặt nó. |
|
`list
` | Liệt kê các kỹ năng đã cài đặt. |
|
`check
` | Kiểm tra các kỹ năng trung tâm đã cài đặt để biết các bản cập nhật ngược dòng. |
|
`update
` | Cài đặt lại các kỹ năng của trung tâm với những thay đổi ngược dòng khi có sẵn. |
|
`audit
` | Quét lại các kỹ năng trung tâm đã cài đặt. |
|
`uninstall
` | Loại bỏ một kỹ năng được cài đặt trong trung tâm. |
|
`reset
` | Bỏ dính một kỹ năng đi kèm được gắn cờ là
`user_modified
` bằng cách xóa mục nhập bảng kê khai của nó. Với
`
--restore
, cũng thay thế bản sao của người dùng bằng phiên bản đi kèm. |
|
`publish
` | Xuất bản một kỹ năng vào sổ đăng ký. |
|
`snapshot
` | Xuất/nhập cấu hình kỹ năng. |
|
`tap
` | Quản lý các nguồn kỹ năng tùy chỉnh. |
|
`config
` | Cấu hình bật/tắt tương tác cho các kỹ năng theo nền tảng. |
Các ví dụ phổ biến:
`
``` bash
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 install https://sharethis.chat/SKILL.md # Direct URL (single-file SKILL.md)
Hermes skills install https://example.com/SKILL.md --name my-skill # Override name when frontmatter has none
Hermes skills check
Hermes skills update
Hermes skills config
Hermes skills reset Google-workspace
Hermes skills reset Google-workspace --restore --yes
`
``Ghi chú:
-
--force
` có thể ghi đè các khối chính sách không nguy hiểm đối với các kỹ năng của bên thứ ba/cộng đồng.
-
--force
` không ghi đè kết quả quét
`dangerous
.
-
--source skills-sh
` tìm kiếm thư mục
`skills.sh
` công khai.
-
--source well-known
` cho phép bạn chỉ cho Hermes một trang web tiết lộ
/.well-known/skills/index.JSON
.
-
--source browse-sh
` tìm kiếm danh mục hơn 200 kỹ năng tự động hóa trình duyệt dành riêng cho trang web của [browse.sh](https://browse.sh). Mã định danh trông giống như
`browse-sh/airbnb.com/search-listings-ddgioa
.
- Việc chuyển URL
`http(s)://…/*.md
` sẽ cài đặt trực tiếp một tệp SKILL.md. Khi frontmatter không có
`name:
` và sên URL không phải là số nhận dạng hợp lệ, terminal tương tác sẽ nhắc tên; các bề mặt không tương tác (
/skills install
` bên trong TUI, nền tảng cổng) yêu cầu
--name <x
` thay thế.
##
`Hermes bundles
`
``` bash
Hermes bundles <subcommand>
`
``Các gói kỹ năng nhóm một số kỹ năng dưới một lệnh gạch chéo
/<bundle-name>
. Việc gọi gói sẽ tải mọi kỹ năng được tham chiếu vào một thông báo kết hợp duy nhất cho người dùng. Bộ nhớ:
~/.Hermes/skill-bundles/<slug>.YAML
. Xem [Skill Bundles](../user-guide/features/skills.md#skill-bundles) để biết lược đồ và hành vi YAML.
Lệnh phụ:
| Tiểu ban | Mô tả |
|----------||-------------|
|
`list
` | Liệt kê các gói đã cài đặt (mặc định khi không có lệnh phụ nào được đưa ra) |
|
`show <name>
` | Hiển thị tên, mô tả, kỹ năng và đường dẫn tệp của một gói |
|
`create <name>
` | Tạo một gói mới. Vượt qua
`
--skill <id>
` (lặp lại) hoặc bỏ qua đối với mục tương tác.
--description
,
--instruction
,
--force
` có sẵn. |
|
`delete <name>
` | Xóa một tập tin bó |
|
`reload
` | Quét lại
~/.Hermes/skill-bundles/
` và báo cáo các gói đã thêm/xóa |
Ví dụ:
``` bash
Hermes bundles create backend-dev \
--skill GitHub-code-review \
--skill test-driven-development \
--skill GitHub-pr-workflow \
-d "Backend feature work"
Hermes bundles list
Hermes bundles show backend-dev
Hermes bundles delete backend-dev
`
``Trong phiên trò chuyện,
/bundles
` liệt kê các gói đã cài đặt và
/<bundle-name>
` tải một gói.
##
`Hermes curator
`
``` bash
Hermes curator <subcommand
`
``Người phụ trách là một nhiệm vụ nền của mô hình phụ trợ, định kỳ xem xét các kỹ năng do tác nhân tạo ra, loại bỏ những kỹ năng cũ, hợp nhất các phần chồng chéo và lưu trữ các kỹ năng lỗi thời. Các kỹ năng được đóng gói và cài đặt trong trung tâm không bao giờ được chạm tới. Tài liệu lưu trữ có thể phục hồi được; tự động xóa không bao giờ xảy ra.
| Tiểu ban | Mô tả |
|----------||-------------|
|
`status
` | Hiển thị trạng thái người quản lý và chỉ số kỹ năng |
|
`run
` | Kích hoạt đánh giá của người quản lý ngay bây giờ (chặn cho đến khi quá trình vượt qua LLM kết thúc) |
|
`run --background
` | Bắt đầu vượt qua LLM trong chuỗi nền và quay lại ngay lập tức |
|
`run --dry-run
` | Chỉ xem trước - tạo báo cáo đánh giá không có đột biến |
|
`backup
` | Chụp ảnh nhanh tar.gz thủ công của
~/.Hermes/skills/
` (người phụ trách cũng tự động chụp ảnh nhanh trước mỗi lần chạy thực) |
|
`rollback
` | Khôi phục
~/.Hermes/skills/
` từ ảnh chụp nhanh (mặc định là mới nhất) |
|
`rollback --list
` | Liệt kê các ảnh chụp nhanh có sẵn |
|
`rollback --id <ts
` | Khôi phục ảnh chụp nhanh cụ thể theo id |
|
`rollback -y
` | Bỏ qua lời nhắc xác nhận |
|
`pause
` | Tạm dừng người quản lý cho đến khi tiếp tục |
|
`resume
` | Tiếp tục người phụ trách đang tạm dừng |
|
`pin <skill
` | Ghim một kỹ năng để người phụ trách không bao giờ tự động chuyển đổi nó |
|
`unpin <skill
` | Bỏ ghim một kỹ năng |
|
`restore <skill
` | Khôi phục kỹ năng đã lưu trữ |
|
`archive <skill
` | Lưu trữ kỹ năng theo cách thủ công |
|
`prune
` | Cắt tỉa các kỹ năng theo cách thủ công mà người phụ trách thường dọn dẹp |
|
`list-archived
` | Danh sách các kỹ năng đã lưu trữ (có thể phục hồi qua
`restore
) |
Khi cài đặt mới, thẻ theo lịch trình đầu tiên được hoãn lại bởi một
`interval_hours
` đầy đủ (7 ngày theo mặc định) - cổng sẽ không quản lý ngay trong tích tắc đầu tiên sau
`Hermes update
. Sử dụng
`Hermes curator run --dry-run
` để xem trước trước khi điều đó xảy ra.
Xem [Curator](../user-guide/features/curator.md) để biết hành vi và cấu hình.
##
`Hermes fallback
`
`bash
Hermes fallback <subcommand>
`
``Quản lý chuỗi nhà cung cấp dự phòng. Các nhà cung cấp dự phòng được thử theo thứ tự khi mô hình chính bị lỗi do lỗi giới hạn tốc độ, quá tải hoặc kết nối.| Tiểu ban | Mô tả |
|----------||-------------|
|
`list
` (bí danh:
`ls
) | Hiển thị chuỗi dự phòng hiện tại (mặc định khi không có lệnh phụ) |
|
`add
` | Chọn một nhà cung cấp + mô hình (cùng một bộ chọn với
`Hermes model
) và nối vào chuỗi |
|
`remove
` (bí danh:
`rm
) | Chọn một mục để xóa khỏi chuỗi |
|
`clear
` | Xóa tất cả các mục dự phòng |
Xem [Fallback Providers](../user-guide/features/fallback-providers.md).
##
`Hermes hooks
`
`bash
Hermes hooks <subcommand
`
``Kiểm tra các móc tập lệnh shell được khai báo trong
~/.Hermes/config.yaml
, kiểm tra chúng với tải trọng tổng hợp và quản lý danh sách cho phép sử dụng lần đầu tại
~/.Hermes/shell-hooks-allowlist.JSON
.
| Tiểu ban | Mô tả |
|----------||-------------|
|
`list
` (bí danh:
`ls
) | Liệt kê các hook được định cấu hình với trình so khớp, thời gian chờ và trạng thái đồng ý |
|
`test <event
` | Bắn mọi móc phù hợp
<event
` với tải trọng tổng hợp |
|
`revoke
` (bí danh:
`remove
,
`rm
) | Xóa các mục trong danh sách cho phép của lệnh (có hiệu lực vào lần khởi động lại tiếp theo) |
|
`doctor
` | Kiểm tra từng hook được định cấu hình: bit thực thi, danh sách cho phép, độ trôi thời gian, tính hợp lệ của JSON và thời gian chạy tổng hợp |
Xem [Hooks](../user-guide/features/hooks.md) để biết chữ ký sự kiện và hình dạng tải trọng.
##
`Hermes memory
`
`bash
Hermes memory <subcommand>
`
``Thiết lập và quản lý các plugin cung cấp bộ nhớ ngoài. Các nhà cung cấp có sẵn: Honcho, openviking, mem0,hindsight,holographic, giữ lạidb, byterover, supermemory. Mỗi lần chỉ có một nhà cung cấp bên ngoài có thể hoạt động. Bộ nhớ trong (MEMORY.md/USER.md) luôn hoạt động.
Lệnh phụ:
| Tiểu ban | Mô tả |
|----------||-------------|
|
`setup
` | Lựa chọn và cấu hình nhà cung cấp tương tác. |
|
`status
` | Hiển thị cấu hình nhà cung cấp bộ nhớ hiện tại. |
|
`off
` | Vô hiệu hóa nhà cung cấp bên ngoài (chỉ tích hợp sẵn). |
:::info[Provider-specific subcommands]
Khi nhà cung cấp bộ nhớ ngoài đang hoạt động, nó có thể đăng ký lệnh
`Hermes <provider>
` cấp cao nhất của riêng mình để quản lý dành riêng cho nhà cung cấp (ví dụ:
`Hermes Honcho
` khi Honcho hoạt động). Các nhà cung cấp không hoạt động không hiển thị các lệnh phụ của họ. Chạy
`Hermes --help
` để xem những gì hiện đang được kết nối.
:::
##
`Hermes ACP
`
``` bash
Hermes ACP
`
``Khởi động Hermes dưới dạng máy chủ stdio ACP (Agent CLIent Protocol) để tích hợp trình chỉnh sửa.
Các điểm vào liên quan:
`bash
Hermes-ACP
Python -m ACP_adapter
`
``Cài đặt hỗ trợ đầu tiên:
`bash
pip install -e '.[ACP]'
`
``Xem [ACP Editor Integration](../user-guide/features/ACP.md) và [ACP Internals](../developer-guide/ACP-internals.md).
##
`Hermes MCP
`
`bash
Hermes MCP <subcommand>
`
``Quản lý cấu hình máy chủ MCP (Model Context Protocol) và chạy Hermes dưới dạng máy chủ MCP.
| Tiểu ban | Mô tả |
|----------||-------------|
|
`serve [-v\|--verbose]
` | Chạy Hermes dưới dạng máy chủ MCP - hiển thị các cuộc trò chuyện với các đại lý khác. |
|
`add <name> [--url URL] [--command CMD] [--args ...] [--auth OAuth\|header]
` | Thêm máy chủ MCP với tính năng phát hiện công cụ tự động. |
|
`remove <name>
` (bí danh:
`rm
) | Xóa máy chủ MCP khỏi config. |
|
`list
` (bí danh:
`ls
) | Liệt kê các máy chủ MCP được cấu hình. |
|
`test <name>
` | Kiểm tra kết nối với máy chủ MCP. |
|
`configure <name>
` (bí danh:
`config
) | Chuyển đổi lựa chọn công cụ cho máy chủ. |
|
`login <name>
` | Buộc xác thực lại máy chủ MCP dựa trên OAuth. |
Xem [MCP Config Reference](./MCP-config-reference.md), [Use MCP with Hermes](../guides/use-MCP-with-Hermes.md) và [MCP Server Mode](../user-guide/features/MCP.md#running-Hermes-as-an-MCP-server).
##
`Hermes plugins
`
`bash
Hermes plugins [subcommand]
`
``Quản lý plugin thống nhất — plugin chung, nhà cung cấp bộ nhớ và công cụ ngữ cảnh ở một nơi. Chạy
`Hermes plugins
` không có lệnh phụ sẽ mở ra một màn hình tương tác tổng hợp có hai phần:
- **Plugin chung** — hộp kiểm nhiều lựa chọn để bật/tắt các plugin đã cài đặt
- **Plugin nhà cung cấp** — cấu hình một lựa chọn cho Nhà cung cấp bộ nhớ và Công cụ ngữ cảnh. Nhấn ENTER trên một danh mục để mở bộ chọn radio.| Tiểu ban | Mô tả |
|----------||-------------|
| *(không có)* | Giao diện người dùng tương tác tổng hợp - chuyển đổi plugin chung + cấu hình plugin nhà cung cấp. |
|
`install <identifier [--force]
` | Cài đặt plugin từ URL Git hoặc
`owner/repo
. |
|
`update <name
` | Lấy các thay đổi mới nhất cho plugin đã cài đặt. |
|
`remove <name
` (bí danh:
`rm
,
`uninstall
) | Xóa một plugin đã cài đặt. |
|
`enable <name
` | Kích hoạt một plugin bị vô hiệu hóa. |
|
`disable <name
` | Vô hiệu hóa một plugin mà không cần gỡ bỏ nó. |
|
`list
` (bí danh:
`ls
) | Liệt kê các plugin đã cài đặt với trạng thái bật/tắt. |
Các lựa chọn plugin của nhà cung cấp được lưu vào
`config.yaml
:
-
`memory.provider
` — nhà cung cấp bộ nhớ hoạt động (trống = chỉ tích hợp sẵn)
-
`context.engine
- công cụ bối cảnh hoạt động (
"compressor"
` = mặc định tích hợp)
Danh sách chung đã tắt plugin được lưu trữ trong
`config.yaml
` trong
`plugins.disabled
.
Xem [Plugins](../user-guide/features/plugins.md) và [Build a Hermes Plugin](../guides/build-a-Hermes-plugin.md).
##
`Hermes tools
`
``` bash
Hermes tools [--summary]
`
| Tùy chọn | Mô tả |
|--------|-------------|
|
`
--summary
` | In bản tóm tắt và thoát của các công cụ được kích hoạt hiện tại. |
Nếu không có
--summary
, thao tác này sẽ khởi chạy giao diện người dùng cấu hình công cụ tương tác trên mỗi nền tảng.
##
`Hermes computer-use
`
``` bash
Hermes computer-use <subcommand
`
``Lệnh phụ:
| Tiểu ban | Mô tả |
|----------||-------------|
|
`install
` | Chạy trình cài đặt cua-driver ngược dòng (chỉ macOS). |
|
`install --upgrade
` | Chạy lại trình cài đặt ngay cả khi cua-driver đã có trên PATH. Tập lệnh ngược dòng luôn lấy bản phát hành mới nhất, vì vậy tập lệnh này thực hiện nâng cấp tại chỗ. |
|
`status
` | In xem
`cua-driver
` có trên
$PATH
` hay không và phiên bản nào đã được cài đặt. |``Hermes computer-use install
` là điểm vào ổn định để cài đặt
Hệ nhị phân [cua-driver](https://GitHub.com/trycua/cua) được sử dụng bởi
Bộ công cụ
`computer_use
. Nó chạy trình cài đặt ngược dòng tương tự
`Hermes tools
` gọi khi bạn bật Sử dụng máy tính lần đầu tiên, vì vậy nó an toàn
để sử dụng để chạy lại cài đặt nếu chuyển đổi bộ công cụ không kích hoạt
nó (ví dụ: khi thiết lập người dùng quay lại).
Hermes update
` tự động chạy lại trình cài đặt ngược dòng ở cuối
của bản cập nhật nếu cua-driver nằm trên PATH, vì vậy hầu hết người dùng sẽ không cần
gọi
`
--upgrade
` theo cách thủ công. Sử dụng nó khi ngược dòng gửi bản sửa lỗi mà bạn muốn
ngay bây giờ mà không cần đợi bản cập nhật tiếp theo của Hermes.
##
`Hermes sessions
`
``` bash
Hermes sessions <subcommand>
`
``Lệnh phụ:
| Tiểu ban | Mô tả |
|----------||-------------|
|
`list
` | Liệt kê các phiên gần đây. |
|
`browse
` | Bộ chọn phiên tương tác với tìm kiếm và tiếp tục. |
|
`export <output> [--session-id ID]
` | Xuất phiên sang JSONL. |
|
`delete ``<session-id>
` | Xóa một phiên. |
|
`prune
` | Xóa phiên cũ. |
|
`stats
` | Hiển thị số liệu thống kê về phiên lưu trữ. |
|
`rename ``<session-id>`` <title>
` | Đặt hoặc thay đổi tiêu đề phiên. |
##
`Hermes insights
`
`bash
Hermes insights [--days N] [--source platform]
`
| Tùy chọn | Mô tả |
|--------|-------------|
|
`
--days <n
` | Phân tích những ngày
`n
` cuối cùng (mặc định: 30). |
|
--source <platform
` | Lọc theo nguồn như
`CLI
,
`Telegram
` hoặc
`Discord
. |
##
`Hermes claw
`
``` bash
Hermes claw migrate [options]
`
``Di chuyển thiết lập OpenClaw của bạn sang Hermes. Đọc từ
~/.OpenClaw
` (hoặc đường dẫn tùy chỉnh) và ghi vào
~/.Hermes
. Tự động phát hiện tên thư mục cũ (
~/.ClawdBot
,
~/.MoltBot
) và tên tệp cấu hình (
`ClawdBot.JSON
,
`MoltBot.JSON
).| Tùy chọn | Mô tả |
|--------|-------------|
|
`
--dry-run
` | Xem trước những gì sẽ được di chuyển mà không cần viết bất cứ điều gì. |
|
--preset <name>
` | Giá trị đặt trước di chuyển:
`full
` (tất cả cài đặt tương thích) hoặc
`user-data
` (không bao gồm cấu hình cơ sở hạ tầng). Không có cài đặt trước nào nhập bí mật - chuyển
--migrate-secrets
` một cách rõ ràng. |
|
--overwrite
` | Ghi đè các tập tin Hermes hiện có về xung đột (mặc định: từ chối áp dụng khi kế hoạch có xung đột). |
|
--migrate-secrets
` | Bao gồm các khóa API khi di chuyển. Bắt buộc ngay cả trong
--preset full
. |
|
--no-backup
` | Bỏ qua ảnh chụp nhanh zip trước khi di chuyển của
~/.Hermes/
` (theo mặc định, một kho lưu trữ điểm khôi phục duy nhất được ghi vào
~/.Hermes/backups/pre-migration-*.zip
` trước khi áp dụng; có thể khôi phục bằng
`Hermes import
). |
|
--source <path>
` | Thư mục OpenClaw tùy chỉnh (mặc định:
~/.OpenClaw
). |
|
--workspace-target <path>
` | Thư mục đích cho các hướng dẫn về không gian làm việc (AGENTS.md). |
|
--skill-conflict <mode>
` | Xử lý xung đột tên kỹ năng:
`skip
` (mặc định),
`overwrite
` hoặc
`rename
. |
|
--yes
` | Bỏ qua lời nhắc xác nhận. |
### Nội dung nào được di chuyển
Quá trình di chuyển bao gồm hơn 30 danh mục về tính cách, bộ nhớ, kỹ năng, nhà cung cấp mô hình, nền tảng nhắn tin, hành vi của tác nhân, chính sách phiên, máy chủ MCP, TTS, v.v. Các mặt hàng được **nhập trực tiếp** vào các sản phẩm tương đương của Hermes hoặc **được lưu trữ** để xem xét thủ công.
**Nhập trực tiếp:** SOUL.md, MEMORY.md, USER.md, AGENTS.md, kỹ năng (4 thư mục nguồn), mô hình mặc định, nhà cung cấp tùy chỉnh, máy chủ MCP, mã thông báo nền tảng nhắn tin và danh sách cho phép (Telegram, Discord, Slack, WhatsApp, Signal, Matrix, Mattermost), mặc định của tác nhân (nỗ lực lý luận, nén, độ trễ của con người, múi giờ, hộp cát), chính sách đặt lại phiên, quy tắc phê duyệt, cấu hình TTS, cài đặt trình duyệt, cài đặt công cụ, thời gian chờ thực thi, lệnh danh sách cho phép, cấu hình cổng và khóa API từ 3 nguồn.
**Được lưu trữ để xem xét thủ công:** Công việc định kỳ, plugin, hook/webhooks, phụ trợ bộ nhớ (QMD), cấu hình đăng ký kỹ năng, UI/danh tính, ghi nhật ký, thiết lập đa tác nhân, liên kết kênh, IDENTITY.md, TOOLS.md, HEARTBEAT.md, BOOTSTRAP.md.
**Độ phân giải khóa API** kiểm tra ba nguồn theo thứ tự ưu tiên: giá trị cấu hình →
~/.OpenClaw/.env
` →
`auth-profiles.JSON
. Tất cả các trường mã thông báo đều xử lý các chuỗi đơn giản, mẫu env (
$\{VAR}
) và các đối tượng SecretRef.
Để biết ánh xạ khóa cấu hình hoàn chỉnh, chi tiết xử lý SecretRef và danh sách kiểm tra sau di chuyển, hãy xem **[full migration guide](../guides/migrate-from-OpenClaw.md)**.
### Ví dụ
``` bash
# Preview what would be migrated
Hermes claw migrate --dry-run
# Full migration (all compatible settings, no secrets)
Hermes claw migrate --preset full
# Full migration including API keys
Hermes claw migrate --preset full --migrate-secrets
# 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 dashboard
`
``` bash
Hermes dashboard [options]
`
``Khởi chạy trang tổng quan web — giao diện người dùng dựa trên trình duyệt để quản lý cấu hình, khóa API và phiên giám sát. Yêu cầu
`pip install Hermes-agent[web]
` (FastAPI + Uvicorn). Tab Trò chuyện của trình duyệt được nhúng yêu cầu
`
--TUI
` cùng với
`pty
` bổ sung. Xem [Web Dashboard](/docs/user-guide/features/web-dashboard) để biết tài liệu đầy đủ.
| Tùy chọn | Mặc định | Mô tả |
|--------|----------|-------------|
|
--port
` |
`9119
` | Cổng chạy máy chủ web trên |
|
--host
` |
`127.0.0.1
` | Địa chỉ ràng buộc |
|
--no-open
` | — | Đừng tự động mở trình duyệt |
|
--TUI
` | tắt | Bật tab Trò chuyện trong trình duyệt bằng cách chạy
`Hermes --TUI
` phía sau cầu nối PTY/WebSocket. Yêu cầu
`pip install 'Hermes-agent[web,pty]'
` và môi trường POSIX PTY như Linux, macOS hoặc WSL2. |
|
--insecure
` | tắt | Cho phép liên kết với các máy chủ không phải localhost. Hiển thị thông tin đăng nhập bảng điều khiển trên mạng; chỉ sử dụng sau các điều khiển mạng đáng tin cậy. |
|
--stop
` | — | Dừng chạy các tiến trình
`Hermes dashboard
` và thoát. |
|
--status
` | — | Danh sách các tiến trình
`Hermes dashboard
` đang chạy và thoát. |
``` bash
# Default — opens browser to http://127.0.0.1:9119
Hermes dashboard
# Custom port, no browser
Hermes dashboard --port 8080 --no-open
# Enable the browser Chat tab
Hermes dashboard --TUI
`
##
`Hermes profile
`
``` bash
Hermes profile <subcommand>
`
``Quản lý hồ sơ - nhiều phiên bản Hermes riêng biệt, mỗi phiên bản có cấu hình, phiên, kỹ năng và thư mục chính riêng.| Tiểu ban | Mô tả |
|----------||-------------|
|
`list
` | Liệt kê tất cả hồ sơ. |
|
`use <name>
` | Đặt cấu hình mặc định cố định. |
|
`create <name> [--clone] [--clone-all] [--clone-from <source>] [--no-alias]
` | Tạo một hồ sơ mới.
`
--clone
` sao chép cấu hình,
.env
` và
`SOUL.md
` từ cấu hình hoạt động.
--clone-all
` sao chép tất cả trạng thái.
--clone-from
` chỉ định cấu hình nguồn. |
|
`delete <name> [-y]
` | Xóa một hồ sơ. |
|
`show <name>
` | Hiển thị chi tiết hồ sơ (thư mục chính, cấu hình, v.v.). |
|
`alias <name> [--remove] [--name NAME]
` | Quản lý tập lệnh bao bọc để truy cập hồ sơ nhanh chóng. |
|
`rename <old> <new>
` | Đổi tên một hồ sơ. |
|
`export <name> [-o FILE]
` | Xuất cấu hình sang kho lưu trữ
.tar.gz
` (sao lưu cục bộ). |
|
`import <archive> [--name NAME]
` | Nhập cấu hình từ kho lưu trữ
.tar.gz
` (khôi phục cục bộ). |
|
`install <source> [--name N] [--alias] [--force] [-y]
` | Cài đặt bản phân phối hồ sơ từ URL git hoặc thư mục cục bộ. |
|
`update <name> [--force-config] [-y]
` | Kéo lại một bản phân phối; bảo tồn dữ liệu người dùng (bộ nhớ, phiên, xác thực). |
|
`info <name>
` | Hiển thị bảng kê khai phân phối của hồ sơ (phiên bản, yêu cầu, nguồn). |
Ví dụ:
``` bash
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 profile install GitHub.com/user/my-distro --alias
Hermes profile update work
Hermes -p work chat -q "Hello from work profile"
`
##
`Hermes completion
`
`bash
Hermes completion [bash|zsh|fish]
`
``In tập lệnh hoàn thành shell ra thiết bị xuất chuẩn. Lấy nguồn đầu ra trong hồ sơ shell của bạn để hoàn thành tab các lệnh, lệnh phụ và tên hồ sơ Hermes.
Ví dụ:
`bash
# Bash
Hermes completion bash >> ~/.bashrc
# Zsh
Hermes completion zsh >> ~/.zshrc
# Fish
Hermes completion fish > ~/.config/fish/completions/Hermes.fish
`
##
`Hermes update
`
``` bash
Hermes update [--check] [--backup] [--restart-gateway]
`
``Kéo mã
`Hermes-agent
` mới nhất và cài đặt lại các phần phụ thuộc trong venv của bạn, sau đó chạy lại các hook sau cài đặt (máy chủ MCP, đồng bộ hóa kỹ năng, cài đặt hoàn tất). An toàn để chạy trên cài đặt trực tiếp.
**cài đặt pip:**
`Hermes update
` tự động phát hiện các cài đặt dựa trên pip — nó truy vấn PyPI để tìm bản phát hành mới nhất và chạy
`pip install --upgrade Hermes-agent
` thay vì
`git pull
. PyPI phát hành các phiên bản được gắn thẻ theo dõi (bản phát hành chính/nhỏ), không phải mọi cam kết trên
`main
. Sử dụng
`
--check
` để xem có bản phát hành PyPI mới hơn mà không cần cài đặt hay không.
| Tùy chọn | Mô tả |
|--------|-------------|
|
--check
` | In cam kết hiện tại và cam kết
`origin/main
` mới nhất cạnh nhau và thoát 0 nếu đồng bộ hóa hoặc 1 nếu ở phía sau. Không kéo, cài đặt hoặc khởi động lại bất cứ thứ gì. |
|
--backup
` | Tạo ảnh chụp nhanh trước khi cập nhật có gắn nhãn của
`Hermes_HOME
` (cấu hình, xác thực, phiên, kỹ năng, dữ liệu ghép nối) trước khi kéo. Mặc định là **tắt** — tính năng luôn sao lưu trước đó là thêm số phút vào mỗi lần cập nhật trên những ngôi nhà lớn. Bật nó vĩnh viễn qua
`update.backup: true
` trong
`config.yaml
. |
|
--restart-gateway
` | Sau khi cập nhật thành công, hãy khởi động lại dịch vụ cổng đang chạy. Ngụ ý ngữ nghĩa
--all
` nếu nhiều cấu hình được cài đặt. |
Hành vi bổ sung:
- **Ghép nối nhanh dữ liệu.** Ngay cả khi
--backup
` tắt,
`Hermes update
` vẫn chụp nhanh
~/.Hermes/pairing/
` và các quy tắc nhận xét Feishu trước
`git pull
. Bạn có thể khôi phục nó bằng
`Hermes backup restore --state pre-update
` nếu thao tác kéo ghi lại tệp bạn đang chỉnh sửa.
- **Cảnh báo
`Hermes.service
` cũ.** Nếu Hermes phát hiện thiết bị hệ thống
`Hermes.service
` được đổi tên trước (thay vì
`Hermes-gateway.service
` hiện tại), nó sẽ in gợi ý di chuyển một lần để bạn có thể tránh các sự cố vòng lặp.
- **Mã thoát.**
`0
` khi thành công,
`1
` khi xảy ra lỗi kéo/cài đặt/sau cài đặt,
`2
` khi có những thay đổi không mong muốn trên cây làm việc chặn
`git pull
.
## Lệnh bảo trì
| Lệnh | Mô tả |
|----------|-------------|
|
`Hermes version
` | In thông tin phiên bản. |
|
`Hermes update
` | Lấy những thay đổi mới nhất và cài đặt lại các phần phụ thuộc. |
|
`Hermes uninstall [--full] [--yes]
` | Xóa Hermes, tùy ý xóa tất cả config/data. |
## Xem thêm
- [Slash Commands Reference](./slash-commands.md)
- [CLI Interface](../user-guide/CLI.md)
- [Sessions](../user-guide/sessions.md)
- [Skills System](../user-guide/features/skills.md)
- [Skins & Themes](../user-guide/features/skins.md)