Hermes Agent
Bộ tài liệu này giúp bạn dùng, tích hợp và
triển khai Hermes Agent —
agent tự cải thiện của Nous Research. Nội dung được biên soạn từ chính mã nguồn và tài liệu
gốc nằm trong www/hermes-agent/website/docs/ (447 file) cộng với tài liệu
công khai trên website.
Đây là gì?
Một agent terminal-native: vòng lặp tool calling, bộ nhớ bền, skill tự tạo, gateway nhắn tin đa nền tảng, cron, subagent và 7 backend terminal. Chạy trên $5 VPS tới cụm GPU.
Khác soigia-harness?
soigia-harness là lõi tham chiếu tối giản (stdlib). Hermes là hệ hoàn
chỉnh: 70+ tool, 28 toolset, gateway, MCP, plugin, desktop. Đọc Tài liệu 01 để so sánh.
Cách đọc
Người mới: 01 → 04. Dùng hằng ngày: 05 → 10. Cắm vào hệ của bạn: 13 → 15. Lên production: 16 → 17.
Bảy nhóm tài liệu
-
Bắt đầu (NHÓM A · 4 TRANG) — Hermes là gì, kiến trúc, cài đặt mọi nền tảng, và con đường nhanh nhất tới một cuộc trò chuyện chạy được. Xem →
-
Sử dụng hằng ngày (NHÓM B · 6 TRANG) — CLI & TUI, slash commands, provider/model, tools & toolsets, skills tự học, bộ nhớ & session. Xem →
-
Kết nối & tự động hoá (NHÓM C · 3 TRANG) — Gateway 21+ nền tảng nhắn tin, cron & script tự động, MCP để cắm tool ngoài. Xem →
-
Tích hợp & mở rộng (NHÓM D · 2 TRANG) — Dùng như Python library, API, delegation/subagent; viết plugin, tool, provider, platform adapter. Xem →
-
Triển khai & vận hành (NHÓM E · 2 TRANG) — Docker, remote backend, serverless; bảo mật, backup, cập nhật, xử lý sự cố, FAQ. Xem →
-
Playbook triển khai (NHÓM F · 7 TRANG) — Best practices mạnh nhất + 6 playbook nhiệm vụ thật: PR review agent, daily briefing, trợ lý nhóm, giám sát & cảnh báo, nghiên cứu song song, triển khai production (Docker/SSH, BOOT.md, worktree). Xem →
-
Tích hợp harness (NHÓM G · 3 TRANG) — Sáu mô hình đưa
soigia-harnessvào Hermes; case study thật (oh-my-hermes, hermes-lcm, portable plugins, skill ecosystem); playbook code: skill, plugin tool, MCP server, cầu model. Xem →
Mục lục đầy đủ
| # | Trang | Nội dung chính |
|---|---|---|
| 01 | Tổng quan | Khái niệm, tính năng, so sánh với soigia-harness |
| 02 | Kiến trúc | Entry point, AIAgent, state, tool backend, 3 API mode |
| 03 | Cài đặt | Desktop bundle, script, Windows, Termux, Docker, Nix |
| 04 | Bắt đầu nhanh | Setup wizard, provider, chat đầu tiên, xác minh |
| 05 | CLI, TUI & profiles | Global options, command families, profile |
| 06 | Slash commands | Session, model, workflow, goal/loop/heartbeat |
| 07 | Provider & model | Nous, OpenAI, Anthropic, OpenRouter, local, fallback |
| 08 | Tools & toolsets | 70+ tool, 28 toolset, preset, approval & permission |
| 09 | Skills | Chuẩn agentskills.io, cấu trúc, tạo skill, catalog |
| 10 | Memory & session | SQLite+FTS5, search, compaction, checkpoint/rollback |
| 11 | Gateway & messaging | 21+ nền tảng, setup Telegram/Slack/Discord, bot mode |
| 12 | Cron & tự động hoá | Cron job, script-only, hermes send, blueprint |
| 13 | MCP | Mô hình tư duy, cấu hình, lọc tool, an toàn |
| 14 | Tích hợp | Python library, API server, delegation/subagent, kanban |
| 15 | Plugin & mở rộng | Plugin SDK, thêm tool/provider/platform, webhook |
| 16 | Triển khai | Docker, SSH/Modal/Daytona, VPS, serverless |
| 17 | Bảo mật & vận hành | Secret redaction, backup, update, troubleshooting, FAQ |
| 18 | Best practices cốt lõi | Checklist production, bảo mật, prompt cache, memory/skills, quick ref |
| 19 | Playbook: PR review agent | Skill review, memory quy ước, cron/webhook, deliver github_comment |
| 20 | Playbook: Daily briefing | Prompt tự chứa, delegation, persona, [SILENT] |
| 21 | Playbook: Trợ lý nhóm | Telegram bot, allowlist, pairing, phân quyền admin/user |
| 22 | Playbook: Giám sát | Watchdog script+agent, zero-token, uptime, alert triage |
| 23 | Playbook: Nghiên cứu | Delegation song song, execute_code, repo scout |
| 24 | Playbook: Triển khai | Docker, SSH backend, hardening, BOOT.md, worktree |
| 25 | Tích hợp harness (bản đồ) | Sáu mô hình tích hợp, tiêu chí chọn, best practice, pitfall |
| 26 | Case study thật | oh-my-hermes, hermes-lcm, portable plugins, skill ecosystem |
| 27 | Playbook: Tích hợp (code) | Skill, plugin tool, MCP server, cầu model — code đầy đủ |
Nguồn. Mã nguồn:
www/hermes-agent/(submodule, ghim tạid0288be5). Tài liệu gốc:www/hermes-agent/website/docs/. Bản công khai: hermes-agent.nousresearch.com/docs.