DEV Community

Cover image for Hướng Dẫn Sử Dụng Hermes Agent
Sebastian Petrus
Sebastian Petrus

Posted on • Originally published at apidog.com

Hướng Dẫn Sử Dụng Hermes Agent

Tóm tắt: Hermes Agent là một trợ lý AI mã nguồn mở, ghi nhớ kiến thức trong quá trình sử dụng và ngày càng thông minh hơn. Chỉ cần một lệnh để cài đặt, thiết lập nhà cung cấp LLM và bắt đầu trò chuyện qua CLI, Telegram, Discord hoặc IDE. Bài viết này hướng dẫn chi tiết từng bước cài đặt, cấu hình, sử dụng hàng ngày, khai thác các tính năng nâng cao và tối ưu hóa hiệu quả của Hermes.

Dùng thử Apidog ngay hôm nay

Hermes Agent là gì?

Hermes Agent là trợ lý AI cá nhân do NousResearch phát triển, chạy liên tục 24/7, ghi nhớ mọi thông tin đã học và ngày càng trở nên hữu ích hơn. Khác với ChatGPT/Claude (mỗi phiên tách biệt), Hermes xây dựng mô hình bền vững về công việc, dự án và sở thích của bạn.

Hình ảnh minh họa giao diện của Hermes Agent

Khả năng nổi bật:

  • Ghi nhớ — Lưu trữ toàn bộ cuộc trò chuyện, quyết định, đoạn code
  • Học hỏi — Tạo kỹ năng tái sử dụng từ các thao tác lặp lại
  • Đa nền tảng — Chat qua CLI, Telegram, Discord, Slack, WhatsApp hoặc IDE
  • Tự lưu trữ — Chạy tại local, VPS giá rẻ hoặc cloud
  • Linh hoạt mô hình — Hỗ trợ trên 200 model qua OpenRouter hoặc nhà cung cấp trực tiếp
  • Mở rộng dễ dàng — Hệ plugin cho tool/lệnh tùy chỉnh

Ai nên dùng Hermes?

  • Developer cần AI cặp đôi am hiểu codebase
  • Nhóm cần AI trợ lý đa user
  • Người dùng nâng cao muốn tự động hóa 24/7 qua cron
  • Researcher đào tạo mô hình AI tùy biến với dữ liệu quỹ đạo

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

Điều kiện tiên quyết

  • Hệ điều hành: macOS, Linux, hoặc Windows (WSL khuyến nghị)
  • Python: 3.10 trở lên
  • Git: Để clone repo
  • API Key LLM: OpenRouter, Anthropic, OpenAI hoặc nhà cung cấp khác

Cài đặt nhanh (Khuyến nghị)

Chạy lệnh dưới đây để cài đặt Hermes chỉ với một bước:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Script tự động:

  1. Clone repo Hermes
  2. Cài uv (quản lý gói Python siêu nhanh)
  3. Tạo môi trường ảo
  4. Cài dependencies
  5. Thêm Hermes vào PATH

Tải lại shell sau khi cài xong:

source ~/.bashrc  # bash
source ~/.zshrc   # zsh

Xác minh cài đặt:

hermes --version

Kết quả sẽ hiện kiểu Hermes Agent v0.x.x.

Cài đặt thủ công (Cho developer)

# Clone repo
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

# Cài uv nếu chưa có
curl -LsSf https://astral.sh/uv/install.sh | sh

# Tạo & kích hoạt venv
uv venv venv --python 3.11
source venv/bin/activate  # Linux/macOS
# hoặc
.\venv\Scripts\activate  # Windows

# Cài đầy đủ chức năng
uv pip install -e ".[all,dev]"

# Kiểm thử cài đặt
python -m pytest tests/ -q

Cài đặt hỗ trợ đào tạo RL

# Khởi tạo submodule Atropos
git submodule update --init tinker-atropos

# Cài phụ thuộc đào tạo
uv pip install -e "./tinker-atropos"

Thiết lập & Cấu hình ban đầu

Chạy trình hướng dẫn thiết lập

Dành cho lần đầu:

hermes setup

Quy trình sẽ hướng dẫn:

  1. Chọn nhà cung cấp LLM
  2. Nhập API key (lưu ở ~/.hermes/.env)
  3. Bật/tắt bộ nhớ vĩnh viễn
  4. Chọn backend terminal (local/Docker/SSH/cloud)
  5. Thiết lập Gateway (Telegram/Discord/Slack - tùy chọn)

Cấu hình thủ công

hermes config edit

Hoặc qua CLI:

# Đặt default model
hermes config set model anthropic/claude-opus-4

# Đặt backend terminal
hermes config set terminal.backend local

# Đặt API key
hermes config set OPENROUTER_API_KEY sk-or-...
hermes config set ANTHROPIC_API_KEY sk-ant-...

Vị trí tệp cấu hình

~/.hermes/
├── config.yaml      # Cấu hình chính
├── .env             # Khóa API
├── memory/          # Bộ nhớ
├── skills/          # Kỹ năng
└── plugins/         # Plugin

Xác minh thiết lập

hermes doctor
  • Kiểm tra config
  • Kết nối API key
  • Trạng thái bộ nhớ
  • Trạng thái Gateway
  • Kết nối backend terminal

Chọn nhà cung cấp LLM

OpenRouter (Khuyên dùng cho người mới)

Lý do: Một API key - truy cập hơn 200 model (có gói free).

hermes config set model openrouter
hermes config set OPENROUTER_API_KEY sk-or-...

Một số model phổ biến:

Mô hình

Trường hợp sử dụng

Chi phí

anthropic/claude-opus-4

Mã hóa phức tạp, suy luận

$$$

anthropic/claude-sonnet-4

Hiệu suất cân bằng

$$

openai/gpt-4o

Mục đích chung

$$

google/gemini-pro-1.5

Cửa sổ ngữ cảnh dài

$

meta/llama-3-70b

Mã nguồn mở, nhanh

$

Anthropic Direct

hermes config set model anthropic
hermes config set ANTHROPIC_API_KEY sk-ant-...
hermes config set model.default claude-opus-4

OpenAI Direct

hermes config set model openai
hermes config set OPENAI_API_KEY sk-...

Mô hình cục bộ (Ollama)

# Cài Ollama trước: https://ollama.ai
hermes config set model ollama
hermes config set model.default qwen2.5-coder:32b

Ví dụ cấu hình model nâng cao

Routing thông minh:

model:
  provider: openrouter
  default: anthropic/claude-opus-4
  fallback:
    - anthropic/claude-haiku-4-5
    - openai/gpt-4o-mini

Giới hạn chi phí:

model:
  budget:
    daily_limit: 5.00  # USD
    monthly_limit: 100.00

Sử dụng cơ bản: CLI mode

Khởi động Hermes

hermes

Bạn sẽ thấy banner chào mừng và có thể bắt đầu chat ngay.

Một số lệnh CLI hữu dụng

> /help          # Xem toàn bộ lệnh
> /skills        # Duyệt kỹ năng
> /memory        # Trạng thái bộ nhớ
> /config        # Xem/chỉnh config
> /clear         # Xóa lịch sử chat
> /history       # Xem lại chat trước

Xử lý tệp:

> Xem tệp ./src/main.py và tái cấu trúc kết nối cơ sở dữ liệu

Chạy lệnh terminal:

> Chạy: npm install && npm run build

Hermes luôn yêu cầu xác nhận trước khi thực thi lệnh hệ thống.

Shell vĩnh viễn

> cd /my/project && source venv/bin/activate
> python src/main.py

Mọi lệnh đều giữ nguyên ngữ cảnh shell cho đến khi kết thúc phiên.

Làm việc với tệp

> Hiển thị cho tôi nội dung của config.yaml
> Trong main.py, đổi port DB từ 5432 sang 5433
> Tạo utils.py với hàm định dạng ngày tháng

Workflow nhiều bước

> Thêm xác thực người dùng vào Flask app:
1. Thiết lập model DB
2. Tạo endpoint đăng nhập/đăng xuất
3. Thêm JWT
4. Viết test cho luồng xác thực

Hermes sẽ tự động chia nhỏ và xác nhận từng bước.

Cổng nhắn tin: Telegram, Discord, Slack

Hermes hỗ trợ chạy bot trên các nền tảng chat phổ biến.

Thiết lập Telegram

  1. Tạo bot với @botfather, lấy token
  2. Cấu hình Hermes: 
    hermes config set TELEGRAM_BOT_TOKEN 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
  3. Khởi động gateway: 
    hermes gateway setup telegram
hermes gateway start
  4. Tìm và chat với bot trên Telegram

Thiết lập Discord

  1. Tạo app và bot trên Discord Developer Portal
  2. Mời bot vào server qua OAuth2
  3. Cấu hình Hermes: 
    hermes config set DISCORD_BOT_TOKEN MTIzNDU2...
hermes gateway setup discord
hermes gateway start
  4. Đề cập bot hoặc chat DM trên Discord

Thiết lập Slack

  1. Tạo ứng dụng mới trên Slack Apps
  2. Thêm quyền bot, cài vào workspace và lấy token
  3. Cấu hình Hermes: 
    hermes config set SLACK_BOT_TOKEN xoxb-...
hermes gateway setup slack
hermes gateway start

Chạy đa nền tảng cùng lúc

hermes gateway start --all

Mọi trạng thái chat được đồng bộ trên các nền tảng.

Tích hợp IDE: VS Code, JetBrains

VS Code

  1. Cài extension "Agent Communication Protocol"
  2. Chạy backend: 
    hermes acp start
  3. Chọn Hermes làm agent, chat và chạy lệnh ngay trong sidebar ACP

JetBrains (IntelliJ, PyCharm,...)

  1. Cài plugin ACP trong Settings → Plugins
  2. Chạy server: 
    hermes acp start
  3. Khai báo Hermes backend trong Settings → Tools → AI Agents

Zed Editor

{
  "agent": {
    "provider": "acp",
    "endpoint": "hermes"
  }
}
hermes acp start

Bộ nhớ & học tập

Các loại bộ nhớ

  • Bộ nhớ từng phần: Lưu toàn bộ phiên chat, search lại dễ dàng 
    > /memory search "di chuyển cơ sở dữ liệu"
  • Bộ nhớ ngữ nghĩa: Biểu đồ kiến thức về project, thói quen, sở thích 
    > /memory projects
  • Bộ nhớ thủ tục (Skills): Tạo skill tái sử dụng 
    > /skills list

Tìm kiếm phiên cũ

> /memory search "Tuần trước xử lý JWT thế nào?"

Nhắc nhở bộ nhớ

[Hermes]: Bạn đang làm việc với xác thực, tuần trước có note về JWT hết hạn. Xem lại chứ?

Context Compression

  • Nén khi dùng 85% context
  • Nén cấp agent ở 50% (cấu hình được)

Xuất & nhập bộ nhớ

hermes memory export ~/backup/hermes-memory.json
hermes memory import ~/backup/hermes-memory.json

Kỹ năng & Plugin

Kỹ năng là gì?

Kỹ năng (Skill) là workflow tái sử dụng, như macro cho các tác vụ phức tạp.

  • code_review — Review code, phát hiện bug/style
  • debug_session — Gỡ lỗi có hệ thống
  • api_tester — Test REST/GraphQL API
  • git_workflow — Git theo best practice
  • documentation — Sinh tài liệu code

Quản lý kỹ năng

> /skills list
> /skills install code_review
> /skills run code_review ./src/auth.py

Tạo skill tùy chỉnh

# ~/.hermes/skills/my_skill.py
from hermes.skills import Skill

class MyCustomSkill(Skill):
    name = "my_custom_skill"
    description = "Làm điều gì đó hữu ích"

    def execute(self, context):
        # Logic
        return "Kỹ năng được thực thi thành công"

Plugin

# ~/.hermes/plugins/my_tool.py
from hermes.tools import Tool

class MyCustomTool(Tool):
    name = "my_tool"
    description = "Một công cụ tùy chỉnh cho các tác vụ cụ thể"

    def run(self, **kwargs):
        return {"result": "thành công"}
  • Tool: Tính năng mới cho agent
  • Lệnh: Slash command mới
  • Hook: Xử lý sự kiện trước/sau lượt

Tính năng nâng cao

Lên lịch cron

> Thiết lập bản tóm tắt hàng ngày về thông báo GitHub của tôi vào 9 giờ sáng

Hoặc chỉnh config.yaml:

cron:
  - name: "Tóm tắt hàng ngày"
    schedule: "0 9 * * *"
    command: "/skills run github_digest"
    model: "anthropic/claude-haiku-4-5"

Ủy quyền agent con

> Xem xét toàn bộ PR, tóm tắt thay đổi giúp tôi

Hermes tự tạo nhiều agent con xử lý song song.

Chế độ giọng nói

hermes --voice
  • Gửi voice message qua Telegram/Discord, Hermes tự chuyển thành text/trả lời
  • Hermes có thể tham gia kênh voice Discord, giao tiếp real-time

Tự động hóa trình duyệt

> Truy cập github.com và tìm 5 repo Python trending
hermes browser connect --cdp

Tích hợp MCP

mcp:
  servers:
    filesystem:
      command: "npx"
      args: ["-y", "@modelcontextprotocol/server-filesystem", "~/projects"]
    git:
      command: "npx"
      args: ["-y", "@modelcontextprotocol/server-git"]

Chế độ Worktree

hermes -w

Nhiều agent làm việc trên cùng repo mà không xung đột.

Chạy agent khác trong Hermes

> Sử dụng claude-code review pull request này

Tận dụng agent chuyên biệt cho từng tác vụ.

Khắc phục sự cố

Các vấn đề thường gặp

  • Không tìm thấy API key 
    hermes config get OPENROUTER_API_KEY
hermes config set OPENROUTER_API_KEY sk-or-...
  • Mô hình không khả dụng 
    hermes models list
hermes config set model anthropic/claude-opus-4
  • Cổng không thể khởi động 
    hermes gateway status
hermes gateway stop
hermes gateway start
  • Phát hiện hỏng bộ nhớ 
    hermes memory export ~/backup/memory-backup.json
hermes memory reset
hermes memory import ~/backup/memory-backup.json

Nhận trợ giúp

> /help
hermes logs tail --follow
hermes doctor

FAQ

Hermes tốn bao nhiêu chi phí để chạy?

  • Sử dụng nhẹ: 5-15$/tháng với OpenRouter
  • Sử dụng vừa: 20-50$/tháng
  • Tự động hóa 24/7: 50-200$/tháng
  • Dùng model local (Ollama): miễn phí, yêu cầu phần cứng phù hợp

Hermes có chạy 24/7 được không?

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
hermes service install
hermes service start

Hermes có phù hợp cho doanh nghiệp?

  • Cổng đa user, cách ly phiên
  • Ẩn PII (compliance)
  • Chuỗi cung ứng bảo mật
  • Tự lưu trữ
  • Audit log

Làm cách nào để di chuyển từ OpenClaw?

hermes claw migrate --dry-run
hermes claw migrate
hermes doctor

Dùng Hermes offline?

curl -fsSL https://ollama.ai/install.sh | sh
ollama pull qwen2.5-coder:32b
hermes config set model ollama
hermes config set model.default qwen2.5-coder:32b

So sánh Hermes & ChatGPT

Tính năng Hermes ChatGPT
Bộ nhớ Liên tục, tìm kiếm được Chỉ theo phiên
Triển khai Tự lưu trữ, 24/7 Chỉ cloud
Lựa chọn model 200+ model Chỉ GPT
Khả năng mở rộng Plugin, kỹ năng Giới hạn
Chi phí Trả theo mức dùng Đăng ký
Quyền riêng tư Bạn kiểm soát dữ liệu OpenAI lưu trữ

Backup dữ liệu Hermes

hermes export --all ~/backup/hermes-full-backup.tar.gz

Hermes có truy cập tệp local không?

Chỉ khi bạn chỉ định rõ tệp/thư mục hoặc cấp quyền. Mặc định không có quyền truy cập hệ thống file.

💡Bạn muốn kiểm thử API như một phần của quy trình làm việc phát triển được hỗ trợ bởi AI? Hãy xem Apidog, nền tảng phát triển API tất cả trong một để thiết kế, kiểm thử và tạo tài liệu API.

Top comments (0)