TL;DR

Sau khi Hermes Agent đã chạy được trên terminal, bước tiếp theo là hiểu các thành phần cốt lõi và bật chúng từng cái một. Phần 2 này đi qua: cấu hình Tools để Hermes có thể thao tác file và tìm kiếm web, thêm Skills để agent tự học workflow của bạn, setup Telegram để nhắn tin từ điện thoại, và xử lý các lỗi hay gặp nhất.

Hiểu 5 thành phần cốt lõi của Hermes

Trước khi bật mọi thứ, cần hiểu Hermes gồm những phần nào:

  • Models: Bộ não AI. Ví dụ Claude, GPT-4o, Gemini, Grok, DeepSeek, model local qua Ollama. Đổi bằng lệnh hermes model hoặc /model trong chat, không cần sửa code.
  • Tools: Những gì Hermes có thể làm. Không có tools, Hermes chỉ chat. Có tools, Hermes có thể đọc file, chạy lệnh terminal, tìm kiếm web, tự động hóa browser, tạo ảnh, gửi tin nhắn. Hermes có 70+ built-in tools.
  • Skills: Playbook được lưu lại. Skills cho Hermes biết cách làm một loại công việc cụ thể một cách tốt nhất - ví dụ review GitHub PR, debug Python, viết content. Hermes tự tạo skills mới sau khi hoàn thành tác vụ phức tạp và cải thiện chúng qua thời gian.
  • Memory: Trí nhớ persistent qua các phiên. Hermes dùng file MEMORY.md và USER.md kết hợp SQLite FTS5 để nhớ context từ hàng tuần trước. Không lưu password, API key hay seed phrase vào memory.
  • Gateway: Cầu nối đến Telegram, Discord, Slack, WhatsApp, Signal và 15+ nền tảng khác. Gateway cho phép bạn nhắn tin cho Hermes từ điện thoại trong khi nó làm việc trên server.

Bước 6: Bật Tools

Mở tool configuration UI:

hermes tools

Giao diện cho phép bật hoặc tắt từng toolset theo nền tảng. Với người mới bắt đầu, chỉ bật những gì thực sự cần:

  • File tools: đọc, ghi, tìm kiếm file
  • Terminal tools: chạy lệnh shell
  • Web search: tìm kiếm internet (cần API key từ Firecrawl hoặc tương tự)
  • Browser: nếu cần tương tác với website

Đừng bật mọi tool chỉ vì nó tồn tại. Nhiều tools hơn đồng nghĩa với nhiều cách gây lỗi hơn. Sau khi thay đổi tools, bắt đầu session mới:

/reset

Điều này giúp Hermes nhận diện đúng cấu hình tools mới.

Bước 7: Thêm Skills

Xem skills hiện có:

hermes skills list

Duyệt skills có thể cài:

hermes skills browse

Xem trước một skill trước khi cài:

hermes skills inspect <skill-id>

Cài skill:

hermes skills install <skill-id>

Đừng cài skills ngẫu nhiên mà không đọc nó làm gì. Một skill tốt trông giống như một checklist rõ ràng hoặc operating manual. Skills được lưu tại ~/.hermes/skills/ và tương thích chuẩn agentskills.io - có thể chia sẻ hoặc lấy từ Skills Hub của cộng đồng.

Điều đặc biệt: Hermes tự tạo skills mới sau khi hoàn thành tác vụ phức tạp. Theo thời gian, agent trở nên tốt hơn cho đúng công việc bạn thường làm.

Bước 8: Kết nối Telegram

Đây là phần làm Hermes thực sự trở thành "operator" chứ không chỉ là terminal tool.

Luồng setup Telegram: BotFather tạo bot token, kết nối với hermes gateway
Luồng setup Telegram bot với Hermes Agent

Tạo Telegram bot:

  1. Mở Telegram, tìm @BotFather
  2. Gửi /newbot, đặt tên và username cho bot
  3. Copy bot token (dạng 123456789:AAH...) - giữ bí mật
  4. Tìm @userinfobot trên Telegram để lấy numeric user ID của bạn

Cấu hình gateway:

hermes setup gateway

Chọn Telegram khi được hỏi, nhập bot token và user ID. Hoặc tự thêm vào ~/.hermes/.env:

TELEGRAM_BOT_TOKEN=your_token_here
TELEGRAM_ALLOWED_USERS=your_numeric_id

Test gateway:

hermes gateway run

Lệnh này chạy gateway trực tiếp trên terminal để bạn thấy lỗi nếu có. Mở Telegram, nhắn tin cho bot. Nếu bot trả lời - thành công. Nhấn Ctrl+C để dừng.

Chạy ngầm (production):

hermes gateway install
hermes gateway start
hermes gateway status

Lệnh này cài gateway như một service hệ thống (systemd trên Linux, launchd trên macOS) - tự khởi động lại sau khi reboot.

Bước 9: Xử lý lỗi Telegram thường gặp

Nếu bot không trả lời, kiểm tra theo thứ tự này:

  • Gateway có đang chạy không? hermes gateway status
  • Bạn có nhắn đúng bot không?
  • Bot token có đúng không? Kiểm tra trong ~/.hermes/.env
  • Bạn có restart gateway sau khi đổi settings chưa?
  • Bot có hoạt động trong direct message không? Test riêng trước khi thêm vào group
  • Nếu trong group: Telegram privacy mode có block không? Cần set bot là admin hoặc tắt privacy mode

Để xem lỗi chi tiết:

hermes gateway run

Nhiều vấn đề Telegram chỉ là do config cũ vẫn đang chạy. Restart gateway thường fix được.

Tiếp theo: Cron Jobs và Triết lý Build in Layers

Bây giờ Hermes đang hoạt động trên terminal và nhận tin từ Telegram - đó là layer 4 và 5 hoàn thành.

Trong Phần 3, chúng ta đi vào phần nâng cao: lên lịch tác vụ tự động (cron jobs) để Hermes gửi daily briefing mỗi sáng, dùng Profiles khi setup của bạn phát triển phức tạp hơn, và quản lý Memory sao cho agent ngày càng thông minh hơn chứ không bị nhiễu. Phần 3 cũng đúc kết triết lý quan trọng nhất: build in layers, đừng cố tạo "AI operating system hoàn hảo" trong một đêm.

via Hermes Agent Docs