Hướng dẫn sử dụng chi tiết
11 tình huống thực tế trên máy anh

🕐 Verify 12/07/2026 · v0.18.0 Mọi lệnh đã đối chiếu CLI thật — mục nào chưa verify em ghi rõ
01Khởi động & kiểm tra sức khoẻ 02Chat hàng ngày — model, reasoning, nhân cách 03Session — resume qua lại app ↔ CLI 04Skills — dùng, cài, ghim, kiểm soát tự học 05Cron blueprint — đặt lịch không cần cú pháp 06Duyệt lệnh & YOLO đúng cách 07Checkpoints — lưới an toàn + /rollback 08Subagents — tách việc chạy song song 09Profiles — khi nào cần agent thứ hai 10Messaging gateway — bot luôn online 11Bảo trì — update, backup, audit Bảng lệnh tra cứu nhanh

01 · Khởi động & kiểm tra sức khoẻ

App desktop tự quản backend — mở app là đủ, không cần chạy lệnh gì trước. Khi có gì lạ, 3 lệnh chẩn đoán theo thứ tự:

hermes status        # tổng quan: model, key nào PRESENT/MISSING, gateway, cron, session
hermes doctor        # khám sâu config + dependencies
hermes logs gui -f   # theo dõi log app desktop trực tiếp (file ~/.hermes/logs/desktop.log)
⚠️ Đừng chạy hermes serve --stop khi app desktop đang mở — lệnh này quét process table và giết luôn backend mà app đang dùng, app sẽ mất kết nối.

02 · Chat hàng ngày — model, reasoning, nhân cách

Ba cửa vào cùng một agent

Đổi model — hiểu đúng 2 tầng để không tốn tiền oan

💰 Quy tắc tiền cache: đổi model GIỮA một chat dài → tin nhắn kế phải đọc lại toàn bộ hội thoại giá input đầy đủ (cache gắn theo model). Chat dài mà muốn model khác → mở chat mới rẻ hơn nhảy qua lại.

Nhân cách agent

Sửa ~/.hermes/SOUL.md (máy anh đang để bản stock của Nous). Config anh cũng có sẵn 13 personality preset (agent.personalities: concise, technical, teacher, pirate…) — SOUL.md là nơi chỉnh nghiêm túc, per-profile.

echo "Bạn là trợ lý riêng của Eroca Thanh. Trả lời tiếng Việt, gọn, ưu tiên hành động." > ~/.hermes/SOUL.md

03 · Session — resume qua lại app ↔ CLI

App desktop sidebar sessions state.db chung ~/.hermes/state.db 1 nguồn session duy nhất CLI / TUI --resume / --continue
Bắt đầu chat trong app → mở tiếp ở CLI được và ngược lại — vì cả hai đọc cùng state.db.
hermes --continue            # mở lại session gần nhất
hermes --continue ten-phien  # mở lại theo tên
hermes --resume <session-id> # mở đúng 1 session cụ thể
hermes sessions              # liệt kê session
Session tự reset theo config máy anh: session_reset: at_hour: 4, idle_minutes: 1440, mode: both — chat để qua 4h sáng hoặc bỏ idle 24h sẽ tự sang phiên mới. Gõ /new để tự tay mở phiên mới bất kỳ lúc nào (⚠️ /new giết luôn subagent đang chạy nền).

04 · Skills — dùng, cài, ghim, kiểm soát tự học

1
Dùng: không cần gọi tên — agent tự chọn skill khớp việc. Xem kho: pane Skills trong app (chỉ bật/tắt) hoặc hermes skills list.
2
Cài thêm từ hub: app desktop KHÔNG có nút install — dùng CLI:
hermes skills search youtube
hermes skills install <identifier>
Nguồn trusted: repo skills của openai / anthropics / huggingface / NVIDIA, skills.sh, ClawHub… Skill community có cảnh báo "caution/dangerous" bị chặn trừ khi force. Hermes tương thích chuẩn SKILL.md mở — cùng chuẩn với skill Claude Code của anh.
3
Kiểm soát tự học: máy anh đang để Hermes TỰ GHI skill không cần duyệt (đã tự tạo 2 cái: eroca-salepage-sepay-crm, research-real-ai-agent-multichannel-use-cases). Muốn mọi skill write qua anh duyệt — thêm vào config.yaml:
skills:
  creation_nudge_interval: 15
  write_approval: true
4
Curator (người dọn kho skill): chưa từng chạy trên máy anh. Chạy thử không rủi ro + ghim 2 skill đã có để không bị archive:
hermes curator run --dry-run
hermes curator pin eroca-salepage-sepay-crm
hermes curator pin research-real-ai-agent-multichannel-use-cases
hermes curator rollback --list   # curator tự snapshot toàn kho trước mỗi lần chạy thật
Merge skill trùng lặp mặc định OFF — chỉ chạy khi anh gọi hermes curator run --consolidate.

05 · Cron blueprint — đặt lịch không cần cú pháp

Máy anh 0 job. Cách nhanh nhất — trong bất kỳ chat Hermes nào:

1
/blueprint → hiện catalog 14 mẫu: morning-brief, important-mail, weekly-review, news-digest, habit-checkin, custom-reminder, bill-renewal-watch…
2
/blueprint morning-brief → agent hỏi từng slot (giờ nào, ngày nào…) bằng ngôn ngữ thường. Hoặc one-shot: /blueprint morning-brief time=07:30.
3
Job rơi vào ~/.hermes/cron/jobs.json. Quản lý: hermes cron list, hoặc pane Cron trong app.
✅ An toàn sẵn: cron_mode: deny đang hiệu lực — job cron gặp lệnh nguy hiểm sẽ bị chặn thẳng, không tự duyệt. Giữ nguyên thế.

06 · Duyệt lệnh & YOLO đúng cách

Muốn gìLàm thế nàoPhạm vi
Buông tay 1 phiênClick nút ⚡ trên status bar app · gõ /yolo trong chat · Shift+Tab trong TUIChỉ phiên đó, tự hết
Buông tay 1 lần chạy CLIhermes --yolo ...Cả process, không tắt giữa chừng được (chống prompt-injection)
Cho phép vĩnh viễn 1 lệnh cụ thểKhi được hỏi duyệt → chọn "always"; hoặc tự thêm glob vào command_allowlist trong configChỉ lệnh đơn khớp mẫu (lệnh có ; && | không được shortcut)
Giảm mỏi tay duyệt toàn cụcapprovals: mode: smart trong configLLM guard tự duyệt an toàn / tự chặn nguy hiểm / phân vân hỏi anh
🪤 Tuyệt đối tránh: Shift+click nút ⚡ trong app — nó ghi approvals.mode: off VĨNH VIỄN vào config.yaml, tắt duyệt cho MỌI phiên/CLI/cron, sống qua restart. Nếu một ngày thấy mode: off trong config mà không nhớ đặt — đó là thủ phạm. Và nhớ: hardline floor (rm -rf /, mkfs…) không gì tắt được, nhưng git reset --hard, curl|sh thì YOLO CÓ cho qua.

07 · Checkpoints — lưới an toàn + /rollback

Hiện OFF trên máy anh — chưa từng snapshot. Bật:

# cách 1 — vĩnh viễn, thêm vào config.yaml:
checkpoints:
  enabled: true
# cách 2 — chỉ 1 phiên: hermes chat --checkpoints

08 · Subagents — tách việc chạy song song

Không có lệnh riêng — cứ nói với Hermes trong chat: "tách việc này thành 3 phần chạy song song rồi tổng hợp" → nó tự gọi tool delegate_task. Điều cần biết trước khi dùng:

09 · Profiles — khi nào cần agent thứ hai

Cần khi anh muốn 1 con Hermes chuyên trách (bot cá nhân / agent nghiên cứu) có memory, skill, cron, model riêng biệt hẳn — giống cách anh tách claude-<scope> bên Claude Code. Máy anh chưa có profile nào.

hermes profile create bot --clone   # --clone = mang theo config + key + skills hiện tại (create trơn = profile RỖNG)
bot chat                            # alias tự có tại ~/.local/bin/bot — PATH sẵn, dùng ngay
hermes -p bot cron list             # nhắm profile cho lệnh bất kỳ
hermes profile use bot              # ⚠️ sticky TOÀN CỤC — mọi lệnh hermes trần đi vào bot cho tới khi use default

10 · Messaging gateway — bot luôn online

Gateway = tiến trình nền RIÊNG (launchd quản), hiện stopped, 0 platform. Nó cho Hermes trực Telegram/Discord/Slack/WhatsApp/Signal/Email/iMessage… từ một chỗ.

1
Cấu hình platform: chạy hermes setup (wizard) — hoặc lệnh chuyên: hermes whatsapp, hermes slack. Token bot đặt trong ~/.hermes/.env.
2
Quản lý tiến trình: hermes gateway (start/stop/status — service launchd chạy cả khi không mở app).
3
Ghép người gửi lạ với quyền: hermes pairing (DM pairing code).
⚠️ Lưu ý cho hệ của anh: danh sách platform KHÔNG có Zalo — khán giả VN của anh vẫn phải đi qua bridge Zalo tự chế bên Claude Code. Em chưa verify chi tiết flow setup từng platform trong source (mới verify danh sách + kiến trúc process) — khi anh chọn platform cụ thể, em audit sâu bước đó trước khi làm.

11 · Bảo trì — update, backup, audit

hermes update              # config anh: giữ 5 backup, local changes tự stash
hermes backup              # đóng zip toàn bộ ~/.hermes (backup trước khi nghịch lớn)
hermes security            # audit chuỗi cung ứng OSV.dev: venv + plugins + MCP servers
hermes dump                # tóm tắt setup để debug/support (kiểm tra backend mismatch)
Nhớ: sau hermes update, tài liệu 3 trang này phải chấm lại bằng hệ thật — nó grounded cho v0.18.0. Dọn rác đang chờ anh gật: kill 86360 91968 (2 watcher tail mồ côi) và xoá ~/.hermes/sandboxes/singularity/ (rỗng).

⚡ Bảng lệnh tra cứu nhanh

LệnhLàm gì
hermes status / doctorTổng quan trạng thái / khám sâu config + dependencies
hermes chat · --tui · --continue · --resume <id>Chat CLI · TUI · mở lại phiên gần nhất · mở đúng phiên
hermes modelĐổi model/provider default + thêm provider mới (OAuth/API key)
hermes skills list/search/installKho skill — cài từ hub (app không có nút install)
hermes curator run --dry-run / pin <skill>Xem trước dọn kho skill / ghim skill khỏi bị archive
/blueprint (trong chat) · hermes cron listĐặt lịch bằng hội thoại · liệt kê job
/yolo · /rollback · /new (trong chat)Buông tay phiên này · khôi phục snapshot · phiên mới
hermes profile create <n> --clone / use / installAgent riêng biệt — tạo kèm setup / đặt mặc định / cài từ git
hermes gateway · hermes pairingBot messaging nền · ghép quyền người nhắn
hermes backup · update · securityZip toàn bộ home · nâng cấp · audit OSV
hermes logs gui -fLog app desktop realtime