# oh-my-hermes: điều phối AI agent song song — hướng dẫn cài đặt và dùng

> oh-my-hermes là lớp điều phối mã nguồn mở chạy trên Hermes Agent. Công cụ chia mục tiêu thành các lane hoặc đồ thị nhỏ, chọn model theo loại việc, gọi kỹ năng phù hợp và chỉ đánh dấu đã kiểm chứng khi có test, review hoặc cổng CI đạt. Cài đặt khá gọn bằng một lệnh trên macOS/Linux hoặc PowerShell trên Windows, nhưng bạn vẫn cần cấu hình Hermes và các model tương ứng.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-09-28 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/oh-my-hermes-dieu-phoi-ai-agent-song-song

oh-my-hermes là một lớp điều phối AI agent chạy phía trên Hermes Agent. Nó không thay thế hay sửa Hermes, mà thêm cách chia việc cho nhiều đồng nghiệp AI, mỗi đồng nghiệp có kỹ năng, model và phạm vi chỉnh sửa riêng.

Repo này hợp với lập trình viên, nhóm phát triển phần mềm và người dùng kỹ thuật muốn giao một mục tiêu lớn cho AI nhưng vẫn kiểm soát được từng phần việc. Điểm đáng giá nhất là OMH phân biệt rõ kế hoạch, việc đang chạy, việc agent báo đã xong và việc đã được kiểm chứng.

Bạn có thể xem video ngắn bên dưới để hình dung cách OMH phối hợp nhiều lane. Sau đó, các bước trong bài giúp bạn cài công cụ, kiểm tra trạng thái và thử những workflow thực tế.

```repo
- repo | rlaope/oh-my-hermes
- kind | Agent
- desc | Lớp điều phối cho Hermes Agent, giúp chia việc cho nhiều model và lane AI chạy song song, có kỹ năng, bộ nhớ và kiểm chứng kết quả.
- stars | 5.6k
- lang | Python
- license | MIT
```

```video
- youtube | https://youtube.com/shorts/Bfp5XG7-5QA
- facebook | https://www.facebook.com/reel/1670444064787901
- title | Video giới thiệu oh-my-hermes
```

## oh-my-hermes làm được gì

### Chia một mục tiêu lớn thành nhiều lane

Khi bạn gõ `/dag-ulw`, OMH biến mục tiêu thành một đồ thị gồm nhiều node nhỏ. Các node đã sẵn sàng có thể chạy song song. Mỗi node có phạm vi ghi riêng nên giảm nguy cơ nhiều agent cùng sửa một file.

Điều này hữu ích khi một việc có nhiều nhánh độc lập. Ví dụ, một lane kiểm tra backend, một lane xem giao diện, lane khác viết test. Sau cùng, một node riêng kiểm tra mục tiêu và yêu cầu sửa những phần chưa đạt.

### Chọn model theo loại công việc

Mỗi lane được gắn một nhóm việc như `ultrabrain`, `deep`, `visual-engineering` hoặc `quick`. Nhóm này quyết định chuỗi model và mức độ suy luận cho lane.

Bạn có thể xem hoặc thay đổi chuỗi model bằng `omh model`. Nếu một nhà cung cấp từ chối model, chuỗi sẽ chuyển sang model kế tiếp thay vì âm thầm hạ cấp. Cách này giúp bạn kiểm soát chất lượng và chi phí theo từng loại nhiệm vụ.

### Tải kỹ năng chuyên môn khi cần

OMH có hơn một trăm chuyên gia dạng `omh-*`, bao phủ frontend, backend, Rust, security review và các cổng kiểm chứng. Bạn không cần tự gọi từng kỹ năng. Bộ định tuyến sẽ chọn kỹ năng phù hợp và đưa nó vào run dưới dạng tool call.

Với người mới, lợi ích là không phải ghi một prompt dài để mô tả mọi vai trò. Với nhóm kỹ thuật, các kỹ năng được tổ chức thành catalog có thể cài đặt và định tuyến nhất quán.

### Dùng LSP để hiểu code theo ngữ nghĩa

Khi bật `lsp_tools` trong cài đặt plugin OMH, công cụ có thể lấy định nghĩa, tham chiếu và đổi tên thông qua language server. Nó hiểu alias, re-export và tên bị che khuất tốt hơn cách tìm kiếm văn bản đơn thuần.

Tính năng này phù hợp khi refactor code lớn. Tuy nhiên, README cho biết LSP tắt mặc định, nên bạn cần chủ động bật trong cấu hình plugin nếu muốn dùng.

### Ghi nhớ dài hạn có lý do rõ ràng

OMH không âm thầm ghi mọi thứ vào bộ nhớ. Mỗi thông tin ứng viên được giữ lại, từ chối hoặc hoãn với một lý do bằng văn bản. Phiên sau nhận được một recall pack được xếp hạng theo nhiệm vụ và cắt theo giới hạn token.

Hermes vẫn giữ bộ nhớ riêng của nó. OMH không đọc hoặc chỉnh sửa bộ nhớ Hermes. Đây là điểm quan trọng khi bạn muốn tách dữ liệu điều phối của OMH khỏi agent gốc.

### Có giao diện TUI riêng

Lệnh `omh` mở TUI của OMH trên gateway của Hermes. Trong đó, bạn có thể xem đồ thị của `/dag-ulw`, cây lane trực tiếp, model, mức effort và token.

TUI cũng cho phép điều khiển hoặc ngắt agent từ danh sách agent, chạy một dòng shell bắt đầu bằng `!`, đổi giao diện bằng `/theme` và quay lại bằng `Esc Esc`.

### Hiển thị bằng chứng trước khi báo hoàn tất

OMH gắn trạng thái với giai đoạn và mức chắc chắn. `Plan · not run` nghĩa là mới có prompt hoặc kế hoạch, chưa có gì chạy. `Code · reported done` chỉ có nghĩa executor tự báo xong. Chỉ `Test · verified` mới cho biết một test, review hoặc cổng CI đã thực sự đạt.

Cách hiển thị này giúp tránh nhầm giữa “AI nói đã làm” và “kết quả đã được kiểm tra”.

### Có workflow cho từng giai đoạn

Bộ `ulw-*` gồm các workflow như `ulw-interview`, `ulw-research`, `ulw-plan`, `ulw-work`, `ulw-loop`, `ulw-qa` và `ulw-perf`. Bạn nói trigger trong chat, sau đó Hermes định tuyến phần còn lại.

Một quy trình điển hình là làm rõ yêu cầu bằng `ulw-interview`, lập kế hoạch với `ulw-plan`, triển khai bằng `ulw-work`, rồi dùng `ulw-loop` để tiếp tục cho đến khi một cổng cụ thể đạt.

## Cần chuẩn bị gì

- Hệ điều hành macOS Apple silicon, macOS Intel, Windows hoặc Linux. README có hướng dẫn riêng cho macOS/Linux và Windows.
- Python 3.11 trở lên. File khai báo dự án yêu cầu Python `>=3.11`.
- Nếu cài bằng Bun hoặc npm, cần thêm Node 18 trở lên và Python 3.11 trở lên có trên `PATH`.
- Hermes Agent. OMH là lớp hoạt động phía trên Hermes Agent và dùng gateway của Hermes.
- Cấu hình model hoặc nhà cung cấp model phù hợp với Hermes. README nói OMH có chuỗi model theo lane, nhưng không nêu một API key cụ thể nào bắt buộc trong phần hướng dẫn cài đặt.
- Nếu muốn dùng LSP, cần bật `lsp_tools` trong phần cài đặt plugin OMH. LSP tắt mặc định.

README không nói bạn cần GPU riêng. Vì vậy, tư liệu hiện có chưa đủ để khẳng định yêu cầu GPU hoặc phần cứng cụ thể. Chi phí model cũng phụ thuộc các nhà cung cấp bạn cấu hình; OMH có hiển thị token và số tiền khi định giá được run, còn run không định giá được sẽ hiện `unknown`, không hiện `$0` giả.

## Cài đặt từng bước

```steps
- Chọn cách cài | Dùng installer cho macOS/Linux hoặc PowerShell cho Windows
- Chạy trình cài | Cài lệnh OMH theo hệ điều hành
- Chạy thiết lập | Đăng ký OMH với Hermes bằng omh setup
- Kiểm tra hệ thống | Dùng omh doctor để phát hiện vấn đề
- Chọn model | Mở omh model để xem và cấu hình model theo nhóm việc
```

### Chọn installer theo hệ điều hành

Trên macOS hoặc Linux, mở Terminal. Trên Windows, mở PowerShell. Hãy chạy lệnh ở đúng cửa sổ của hệ điều hành bạn đang dùng.

README cung cấp hai installer chính. Lệnh macOS/Linux tải script cài đặt từ website của dự án. Lệnh Windows dùng PowerShell để tải và thực thi script PowerShell.

### Cài trên macOS hoặc Linux

```bash
curl -fsSL https://omher.app/install | sh
```

`curl` tải nội dung installer. Các cờ `-f`, `-s`, `-S` và `-L` lần lượt giúp báo lỗi HTTP, chạy yên lặng, vẫn hiện lỗi quan trọng và theo chuyển hướng. Phần `| sh` chuyển script cho shell thực thi.

Nếu lệnh báo không tìm thấy `curl`, hãy cài hoặc bật công cụ này theo cách quản trị hệ điều hành của bạn rồi chạy lại. Không nên tự thay đổi nội dung script nếu bạn chưa hiểu nó làm gì.

### Cài trên Windows

Mở PowerShell 5.1 trở lên rồi chạy:

```powershell
irm https://omher.app/install.ps1 | iex
```

`irm` là bí danh PowerShell để lấy nội dung từ địa chỉ cài đặt. `iex` thực thi nội dung vừa lấy. Nếu PowerShell báo phiên bản không đủ, hãy mở phiên bản PowerShell được README yêu cầu trước khi thử lại.

Lệnh này cần Internet và quyền tải script. Nếu máy của bạn có chính sách chặn thực thi script, hãy xử lý theo chính sách quản trị máy; không nên tắt các cơ chế bảo vệ chỉ để chạy cho bằng được.

### Chạy thiết lập OMH

Sau khi installer hoàn tất, chạy:

```bash
omh setup
```

Lệnh này thiết lập OMH với Hermes. README không liệt kê toàn bộ màn hình hỏi đáp của wizard trong phần trích dẫn, nên bạn hãy đọc từng câu hỏi và điền đúng gateway, model hoặc thông tin provider mà môi trường Hermes của bạn yêu cầu.

Nếu bạn đang dùng Bun, npm hoặc Homebrew thay vì installer, README vẫn yêu cầu chạy `omh setup` sau khi cài.

### Cài bằng Homebrew, Bun hoặc npm nếu cần

README có các lựa chọn sau:

```bash
brew install rlaope/tap/omh
```

```bash
bun install -g oh-my-hermes
```

```bash
npm install -g oh-my-hermes
```

Homebrew tự mang theo Python theo README. Bun và npm cần Node 18 trở lên cùng Python 3.11 trở lên trên `PATH`. Sau khi cài bằng một trong ba trình quản lý này, chạy lại:

```bash
omh setup
```

Nếu lệnh `omh` chưa được nhận diện, hãy kiểm tra trình quản lý gói đã đặt thư mục lệnh toàn cục vào `PATH` chưa. README không đưa ra một đường dẫn `PATH` cố định cho mọi máy.

### Thiết lập model và cập nhật

Để mở bộ chọn model theo nhóm công việc, chạy:

```bash
omh model
```

Trong bộ chọn, phím mũi tên dùng để chọn category, phím trái/phải chọn model đầu chuỗi và phím `-`/`+` điều chỉnh effort. Bạn cũng có thể mở bộ chọn tương tự bên trong TUI OMH bằng `/omh-model`.

Khi cần cập nhật OMH, dùng:

```bash
omh update
```

Lệnh này phát hiện OMH được cài bằng cách nào, nâng cấp qua installer sở hữu nó, sau đó làm mới skill được quản lý, plugin bundle và đăng ký Hermes.

## Kiểm tra đã chạy được chưa

Đầu tiên, chạy trình chẩn đoán:

```bash
omh doctor
```

Kết quả mong đợi là OMH kiểm tra được môi trường và báo các vấn đề cần xử lý nếu có. README không đưa ra một màn hình output cố định, vì vậy không nên đối chiếu với một dòng chữ duy nhất.

Tiếp theo, chạy:

```bash
omh
```

Nếu TUI OMH mở trên gateway của Hermes, phần CLI đã có thể khởi động giao diện chính. Trong TUI, bạn có thể dùng `/theme` để đổi giao diện hoặc `/omh-model` để mở bộ chọn model.

Để kiểm tra workflow, tại prompt của Hermes thử một yêu cầu nhỏ với trigger, chẳng hạn:

```text
ulw-plan: analyze this project's circular dependencies and plan the refactor
```

Bạn cần nhìn thấy kế hoạch hoặc trạng thái của run. Đừng coi việc agent tự nói “done” là kiểm chứng. Theo README, trạng thái đáng tin cậy nhất là `Test · verified`, xuất hiện sau khi test, review hoặc CI gate thực sự đạt.

## Dùng vào việc thật

### Chủ shop muốn làm trang bán hàng

Bạn có thể dùng `ulw-interview` khi ý tưởng còn mơ hồ:

```text
ulw-interview: I want a small online shop for handmade products with product pages, cart, and order tracking
```

Workflow sẽ hỏi từng câu một cho đến khi biết rõ bạn muốn gì. Sau đó, bạn dùng `ulw-plan` để so sánh lựa chọn, nêu rủi ro và thống nhất tiêu chí hoàn thành trước khi giao việc xây dựng.

Kết quả phù hợp là một kế hoạch đã được rà soát, thay vì để agent tự đoán yêu cầu kinh doanh ngay từ đầu.

### Nhân viên văn phòng cần tự động hóa một quy trình

Giả sử bạn có một dự án cần đọc dữ liệu, tạo báo cáo và kiểm tra đầu ra. Bạn có thể yêu cầu:

```text
ulw-work: run the accepted plan
```

OMH sẽ chạy các phần độc lập trong những lane song song, với điều kiện các lane không sửa cùng một file. Mỗi lane dùng category và model chain được cấu hình trước.

Kết quả là tiến độ của từng phần được hiển thị riêng. Bạn dễ biết phần nào đang chạy, phần nào chỉ được báo đã xong và phần nào đã qua cổng kiểm chứng.

### Lập trình viên cần refactor dự án lớn

Với thay đổi rủi ro, bắt đầu bằng:

```text
ulw-plan: analyze this project's circular dependencies and plan the refactor
```

Nếu dự án dùng ngôn ngữ có language server phù hợp, bạn có thể bật `lsp_tools` trong plugin settings để OMH sử dụng định nghĩa, tham chiếu và rename theo ngữ nghĩa. Sau khi chấp nhận kế hoạch, chạy:

```text
ulw-work: run the accepted plan
```

Kết quả mong đợi là các lane có phạm vi file riêng, giảm xung đột khi làm song song. Việc hoàn thành vẫn cần dựa trên test, review hoặc CI gate thực tế.

### Nhóm kỹ thuật muốn ép hệ thống sửa đến khi test đạt

Khi đã biết rõ cổng hoàn thành, dùng:

```text
ulw-loop: keep going until npm test passes
```

Workflow sẽ lặp qua plan, build và review cho đến khi điều kiện bạn nêu đạt. Đây không phải lời hứa rằng mọi dự án đều tự sửa được. Bạn vẫn cần xem log, chi phí, thay đổi file và kết quả test.

Một số trigger khác cũng hữu ích: `ulw-research` để tìm trong code và web có lưu nguồn, `ulw-qa` để tấn công build bằng các tình huống khó, và `ulw-perf` để đo nơi chậm rồi xử lý từng điểm nóng.

> Giao việc cho nhiều agent chỉ có giá trị khi bạn biết phần nào đã chạy và phần nào đã được kiểm chứng.
>
> — Ông T

## Lỗi hay gặp và cách xử lý

### Lệnh `omh` không được nhận diện

Nguyên nhân thường là installer hoặc trình quản lý gói chưa đưa thư mục chứa lệnh vào `PATH`, hoặc terminal đang mở chưa nhận cấu hình mới. Hãy mở terminal mới rồi kiểm tra lại lệnh. Nếu dùng Bun hoặc npm, xác nhận Node 18+, Python 3.11+ và thư mục lệnh toàn cục đã có trong `PATH`.

### `omh setup` không kết nối được với Hermes

OMH là lớp trên Hermes Agent, nên Hermes hoặc gateway chưa sẵn sàng sẽ khiến thiết lập không hoàn tất. Kiểm tra Hermes trước, sau đó chạy lại `omh setup`. Không nên tự xóa cấu hình Hermes để thử lại vì README nhấn mạnh OMH không đọc hoặc patch bộ nhớ Hermes.

### Model bị provider từ chối

OMH có cơ chế chuyển sang model tiếp theo trong chain khi provider từ chối một model. Bạn có thể chạy `omh model` để xem category, model đầu chuỗi và effort. Nếu nhiều model đều lỗi, kiểm tra cấu hình provider và quyền truy cập trong môi trường Hermes.

### Agent báo xong nhưng chưa có bằng chứng

`Code · reported done` chỉ là báo cáo của executor, chưa phải kết quả được kiểm tra. Hãy yêu cầu chạy test, review hoặc CI gate. Chỉ coi run đã xác nhận khi thấy trạng thái như `Test · verified`.

### Chạy song song nhưng xảy ra xung đột file

DAG-ULW được thiết kế để các node chạy đồng thời không chia sẻ write scope, nhưng bạn vẫn nên xem phạm vi từng node và kết quả trả về. Nếu mục tiêu tạo ra nhiều thay đổi phụ thuộc lẫn nhau, hãy chia nhỏ lại bằng `ulw-plan` hoặc dùng lane tuần tự cho phần có phụ thuộc.

### Bật LSP nhưng không có kết quả

LSP tắt mặc định. Hãy bật `lsp_tools` trong OMH plugin settings và bảo đảm môi trường dự án có language server phù hợp. README chỉ nói OMH lấy định nghĩa, tham chiếu và rename từ language server; không cung cấp danh sách server hay lệnh cài cho từng ngôn ngữ.

```note
OMH có thể gọi nhiều model và chạy nhiều lane cùng lúc. Hãy kiểm tra provider, token và quyền truy cập trước khi giao việc lớn. Chi phí có thể phát sinh theo các model bạn cấu hình; HUD chỉ hiển thị số tiền khi run định giá được.
```

## Có nên dùng không

oh-my-hermes đáng thử nếu bạn đã dùng hoặc muốn dùng Hermes Agent và cần một lớp điều phối có cấu trúc. Repo có nhiều workflow thực tế, định tuyến model theo loại việc, kỹ năng chuyên môn, TUI riêng, bộ nhớ có kiểm soát và cách báo cáo dựa trên bằng chứng. Giấy phép của dự án là MIT.

Công cụ đặc biệt hợp với các tác vụ kỹ thuật lớn cần chia nhỏ: refactor, kiểm thử, nghiên cứu code, review bảo mật, tối ưu hiệu năng hoặc chạy nhiều nhánh độc lập. Việc có `omh doctor`, `omh model` và các trạng thái rõ ràng cũng giúp người vận hành dễ theo dõi hơn.

Giới hạn là OMH không phải agent độc lập; nó chạy trên Hermes Agent. Bạn cần hiểu gateway, provider và model chain của môi trường Hermes. README cũng không nêu chi tiết một số phần như output cố định của wizard, yêu cầu GPU, danh sách API key cụ thể hay cách cài language server cho từng ngôn ngữ.

Nếu bạn chỉ cần một chatbot trả lời câu hỏi đơn giản, một CLI chạy một nhiệm vụ tuần tự hoặc một công cụ chỉnh sửa nhỏ, OMH có thể là quá nhiều. Nếu bạn cần nhiều agent phối hợp, muốn tách quyền sở hữu file và yêu cầu bằng chứng trước khi kết luận, đây là một lớp điều phối đáng cân nhắc.

## Câu hỏi thường gặp

### oh-my-hermes có miễn phí không?

Repo có giấy phép MIT. Tuy nhiên, README cho biết OMH có thể hiển thị token và chi phí model, nên việc sử dụng các provider model vẫn có thể phát sinh chi phí riêng. Tư liệu không nêu bảng giá cụ thể.

### Có chạy được trên Windows không?

Có. README cung cấp installer PowerShell cho Windows 5.1 trở lên: `irm https://omher.app/install.ps1 | iex`. Sau đó chạy `omh setup` và `omh doctor`.

### Có cần GPU không?

README được cung cấp không nêu yêu cầu GPU. Vì vậy chưa có đủ thông tin để khẳng định OMH cần GPU hay không.

### Có cần cài Hermes Agent trước không?

Có. OMH là operating layer chạy trên Hermes Agent và dùng gateway của Hermes. README không mô tả OMH như một agent độc lập thay thế Hermes.

### Dữ liệu và bộ nhớ có an toàn không?

OMH không âm thầm ghi nhớ mọi thứ; mỗi ứng viên được giữ, từ chối hoặc hoãn kèm lý do. Hermes có bộ nhớ riêng và OMH không đọc hoặc patch bộ nhớ đó. Tuy nhiên, README không đưa ra cam kết bảo mật tuyệt đối cho dữ liệu gửi tới các provider model.

### OMH có tự báo hoàn thành khi agent chưa kiểm tra kết quả không?

Thiết kế của OMH phân biệt `Code · reported done` với `Test · verified`. Một run chỉ được xem là verified khi test, review hoặc CI gate thực sự đạt.

### Có cần bật LSP ngay khi cài không?

Không. LSP tắt mặc định và chỉ cần bật `lsp_tools` trong OMH plugin settings nếu bạn muốn dùng định nghĩa, tham chiếu hoặc rename theo language server. README không nêu các bước cài language server riêng cho từng ngôn ngữ.
