Blog

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

Ashley Innocent

Ashley Innocent

30 tháng 3 2026

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ở có khả năng ghi nhớ những gì nó học được và trở nên thông minh hơn theo thời gian. Cài đặt chỉ với một lệnh, cấu hình nhà cung cấp LLM của bạn và bắt đầu trò chuyện qua CLI, Telegram, Discord hoặc IDE của bạn. Hướng dẫn này bao gồm cài đặt, thiết lập, sử dụng hàng ngày, các tính năng nâng cao và cách tận dụng tối đa Hermes.

button

Hermes Agent là gì?

Hermes Agent là một trợ lý AI cá nhân được xây dựng bởi NousResearch, chạy 24/7, ghi nhớ mọi thứ nó học được và trở nên có khả năng hơn theo thời gian. Không giống như ChatGPT hay Claude bắt đầu mới mỗi cuộc trò chuyện, Hermes xây dựng một 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

Các khả năng chính:

Ai nên sử dụng Hermes:

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

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

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

Cách nhanh nhất để cài đặt Hermes:

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

Script này:

  1. Sao chép kho lưu trữ Hermes
  2. Cài đặt uv (trình quản lý gói Python nhanh)
  3. Tạo một môi trường ảo
  4. Cài đặt tất cả các phụ thuộc
  5. Thêm Hermes vào PATH của bạn

Sau khi cài đặt, hãy tải lại shell của bạn:

source ~/.bashrc  # Đối với bash
source ~/.zshrc   # Đối với zsh

Xác minh cài đặt:

hermes --version

Bạn sẽ thấy một cái gì đó tương tự Hermes Agent v0.5.0.

Cài đặt thủ công (Dành cho nhà phát triển)

Nếu bạn muốn kiểm soát nhiều hơn quá trình cài đặt:

# Sao chép kho lưu trữ
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

# Cài đặt uv (nếu chưa cài đặt)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Tạo và kích hoạt môi trường ảo
uv venv venv --python 3.11
source venv/bin/activate  # Linux/macOS
# hoặc
.\venv\Scripts\activate  # Windows

# Cài đặt Hermes với tất cả các tính năng
uv pip install -e ".[all,dev]"

# Chạy thử nghiệm để xác minh cài đặt
python -m pytest tests/ -q

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

Nếu bạn dự định đào tạo các mô hình tùy chỉnh:

# Khởi tạo mô-đun con Atropos
git submodule update --init tinker-atropos

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

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

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

Người dùng lần đầu nên chạy thiết lập tương tác:

hermes setup

Trình hướng dẫn sẽ hướng dẫn bạn qua:

  1. Chọn nhà cung cấp LLM của bạn — OpenRouter, Anthropic, OpenAI, v.v.
  2. Đặt khóa API — Được lưu trữ an toàn trong ~/.hermes/.env
  3. Cấu hình bộ nhớ — Bật/tắt bộ nhớ vĩnh viễn
  4. Backend terminal — Tùy chọn cục bộ, Docker, SSH hoặc đám mây
  5. Thiết lập Gateway — Tích hợp Telegram, Discord, Slack (tùy chọn)

Cấu hình thủ công

Nếu bạn thích thiết lập thủ công, hãy chỉnh sửa tệp cấu hình:

hermes config edit

Hoặc sử dụng các lệnh CLI:

# Đặt mô hình mặc định
hermes config set model anthropic/claude-opus-4

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

# Đặt khóa API (tự động lưu vào ~/.hermes/.env)
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 lưu trữ cấu hình trong ~/.hermes/:

~/.hermes/
├── config.yaml      # Cấu hình chính
├── .env             # Khóa API (không chia sẻ!)
├── memory/          # Lưu trữ bộ nhớ vĩnh viễn
├── skills/          # Kỹ năng đã cài đặt
└── plugins/         # Plugin tùy chỉnh

Xác minh thiết lập của bạn

Chạy kiểm tra tình trạng:

hermes doctor

Thao tác này kiểm tra:

Chọn nhà cung cấp LLM của bạn

Hermes hỗ trợ hơn 200 mô hình thông qua nhiều nhà cung cấp. Đây là cách chọn:

OpenRouter (Khuyên dùng cho người mới bắt đầu)

Tại sao: Một khóa API duy nhất cung cấp quyền truy cập vào hơn 200 mô hình. Có cấp miễn phí.

Thiết lập:

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

Các mô hình phổ biến trên OpenRouter:

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

Tại sao: Mã hóa và suy luận tốt nhất. Truy cập trực tiếp vào các mô hình Claude mới nhất.

Thiết lập:

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

OpenAI Direct

Tại sao: Các mô hình GPT-4o và o1 cho các trường hợp sử dụng cụ thể.

Thiết lập:

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

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

Tại sao: Miễn phí, riêng tư, có khả năng hoạt động ngoại tuyến.

Thiết lập:

# Cài đặt 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 mô hình

Định tuyến thông minh (mô hình đắt tiền cho tác vụ phức tạp, rẻ cho tác vụ đơn giản):

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

Kiểm soát chi phí (đặt giới hạn chi tiêu):

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

Sử dụng cơ bản: Chế độ CLI

Khởi động Hermes

Cách đơn giản nhất để sử dụng Hermes:

hermes

Bạn sẽ thấy một biểu ngữ chào mừng và có thể bắt đầu trò chuyện ngay lập tức.

Các lệnh cơ bản

Trong Hermes, bạn có thể:

Trò chuyện tự nhiên:

> Này, bạn có thể giúp tôi viết một hàm Python để phân tích cú pháp JSON không?

Sử dụng các lệnh gạch chéo:

> /help          # Hiển thị tất cả các lệnh
> /skills        # Duyệt các kỹ năng có sẵn
> /memory        # Xem trạng thái bộ nhớ
> /config        # Xem/chỉnh sửa cấu hình
> /clear         # Xóa cuộc trò chuyện hiện tại
> /history       # Xem các cuộc trò chuyện trước đây

Giao các tác vụ dựa trên 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 các lệnh terminal:

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

Hermes sẽ yêu cầu xác nhận trước khi thực hiện bất kỳ lệnh nào.

Shell vĩnh viễn

Không giống như các công cụ AI khác, Hermes duy trì trạng thái shell trên các lệnh:

> cd /my/project && source venv/bin/activate
> python src/main.py  # Chạy trong cùng phiên shell

Môi trường ảo vẫn hoạt động cho các lệnh tiếp theo.

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

Đọc tệp:

> Hiển thị cho tôi nội dung của config.yaml

Chỉnh sửa tệp:

> Trong main.py, thay đổi cổng cơ sở dữ liệu từ 5432 thành 5433

Tạo tệp mới:

> Tạo một tệp mới có tên utils.py với các hàm trợ giúp để định dạng ngày tháng

Quy trình làm việc nhiều bước

Hermes xuất sắc trong các tác vụ phức tạp, nhiều bước:

> Tôi cần thêm xác thực người dùng vào ứng dụng Flask của mình. Bạn có thể:
> 1. Thiết lập các mô hình cơ sở dữ liệu
> 2. Tạo các điểm cuối đăng nhập/đăng xuất
> 3. Thêm tạo mã thông báo JWT
> 4. Viết các bài kiểm tra cho luồng xác thực

Hermes sẽ thực hiện từng bước, yêu cầu xác nhận trong suốt quá trình.

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

Hermes có thể chạy dưới dạng bot trên nhiều nền tảng nhắn tin, vì vậy bạn có thể tương tác với nó từ điện thoại hoặc trò chuyện nhóm của mình.

Thiết lập Telegram

1. Tạo một bot:

2. Cấu hình Hermes:

hermes config set TELEGRAM_BOT_TOKEN 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

3. Khởi động cổng:

hermes gateway setup telegram
hermes gateway start

4. Bắt đầu trò chuyện:

Thiết lập Discord

1. Tạo một ứng dụng Discord:

2. Mời bot vào máy chủ của bạn:

3. Cấu hình Hermes:

hermes config set DISCORD_BOT_TOKEN MTIzNDU2...
hermes gateway setup discord
hermes gateway start

4. Sử dụng trong Discord:

Thiết lập Slack

1. Tạo một ứng dụng Slack:

2. Cài đặt vào không gian làm việc và sao chép mã thông báo

3. Cấu hình Hermes:

hermes config set SLACK_BOT_TOKEN xoxb-...
hermes gateway setup slack
hermes gateway start

Sử dụng đa nền tảng

Bạn có thể chạy nhiều cổng cùng lúc:

hermes gateway start --all

Hermes đồng bộ hóa trạng thái cuộc trò chuyện trên tất cả các nền tảng.

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

Hermes tích hợp trực tiếp với trình soạn thảo mã của bạn thông qua Giao thức Giao tiếp Tác nhân (ACP).

Tích hợp VS Code

1. Cài đặt tiện ích mở rộng ACP:

2. Cấu hình Hermes làm backend:

hermes acp start

3. Sử dụng trong VS Code:

Tích hợp JetBrains (IntelliJ, PyCharm, v.v.)

1. Cài đặt plugin ACP:

2. Khởi động máy chủ Hermes ACP:

hermes acp start

3. Cấu hình trong JetBrains:

Trình soạn thảo Zed

Zed có hỗ trợ ACP gốc:

1. Cấu hình trong cài đặt Zed:

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

2. Khởi động Hermes:

hermes acp start

Hệ thống bộ nhớ và học tập

Sức mạnh siêu việt của Hermes nằm ở kiến trúc bộ nhớ của nó. Dưới đây là cách sử dụng nó một cách hiệu quả.

Các loại bộ nhớ

Bộ nhớ từng phần (Episodic Memory): Lưu trữ các cuộc trò chuyện và phiên cụ thể. Bạn có thể tìm kiếm và truy xuất các tương tác trước đây.

> /memory search "di chuyển cơ sở dữ liệu"

Bộ nhớ ngữ nghĩa (Semantic Memory): Xây dựng biểu đồ kiến thức về các dự án, sở thích và mẫu của bạn.

> /memory projects

Bộ nhớ thủ tục (Kỹ năng): Tạo các kỹ năng có thể tái sử dụng từ các tác vụ lặp đi lặp lại.

> /skills list

Tìm kiếm phiên

Tìm công việc cũ liên quan bằng tìm kiếm ngữ nghĩa:

> /memory search "Tuần trước chúng ta đã xử lý việc hết hạn JWT như thế nào?"

Hermes tìm kiếm toàn bộ lịch sử của bạn và tóm tắt kết quả.

Nhắc nhở bộ nhớ

Hermes chủ động đưa ra thông tin liên quan:

[Hermes]: Tôi nhận thấy bạn đang làm việc trên hệ thống xác thực. Thứ Ba tuần trước bạn
đã đề cập đến một vấn đề với việc hết hạn JWT. Bạn có muốn xem lại vấn đề đó không?

Nén ngữ cảnh

Hermes tự động nén ngữ cảnh để tránh đạt giới hạn:

Điều này cho phép các cuộc trò chuyện không giới hạn mà không cần quản lý ngữ cảnh thủ công.

Xuất và sao lưu

Xuất bộ nhớ:

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

Nhập bộ nhớ:

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

Kỹ năng và Plugin

Kỹ năng là gì?

Kỹ năng là các quy trình làm việc có thể tái sử dụng mà Hermes có thể thực hiện. Hãy nghĩ về chúng như các macro cho các tác vụ phức tạp.

Các kỹ năng tích hợp sẵn bao gồm:

Duyệt và cài đặt kỹ năng

Xem các kỹ năng có sẵn:

> /skills list

Cài đặt một kỹ năng:

> /skills install code_review

Sử dụng một kỹ năng:

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

Kỹ năng tùy chỉnh

Tạo kỹ năng tùy chỉnh trong ~/.hermes/skills/:

# ~/.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 kỹ năng của bạn ở đây
        return "Kỹ năng được thực thi thành công"

Hệ thống Plugin

Plugin mở rộng Hermes với các công cụ, lệnh và hook tùy chỉnh.

Tạo một 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):
        # Logic công cụ ở đây
        return {"result": "thành công"}

Các loại plugin:

Các tính năng nâng cao

Lập lịch Cron

Lên lịch các tác vụ tự động:

# Yêu cầu Hermes tạo một tác vụ đã lên lịch
> 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 cấu hình thủ công trong 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 tác nhân con

Hermes có thể tạo ra các tác nhân con để làm việc song song:

> Tôi cần bạn xem xét tất cả các PR trong kho của tôi và tóm tắt các thay đổi

Hermes sẽ tạo ra nhiều tác nhân con để làm việc song song, sau đó tổng hợp kết quả.

Chế độ giọng nói

Nhấn để nói trong CLI:

hermes --voice

Ghi chú giọng nói trong Telegram/Discord:

Kênh thoại Discord:

Kiểm soát trình duyệt

Hermes tích hợp với Browser Use CLI 2.0 để tự động hóa web:

> Truy cập github.com và tìm 5 kho lưu trữ Python thịnh hành nhất

Hoặc kết nối với Chrome trực tiếp qua CDP:

hermes browser connect --cdp

Tích hợp MCP

Hermes hỗ trợ các máy chủ Giao thức Ngữ cảnh Mô hình (MCP):

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

Chế độ Worktree

Chạy Hermes trong một worktree git bị cô lập:

hermes -w

Nhiều tác nhân có thể làm việc trên cùng một kho lưu trữ đồng thời mà không xung đột.

Chạy các tác nhân khác bên trong Hermes

Hermes có thể chạy các tác nhân AI khác dưới dạng tác nhân con:

> Sử dụng claude-code để xem xét yêu cầu kéo này

Điều này hữu ích cho việc tận dụng các tác nhân chuyên biệt cho các tác vụ cụ thể.

Khắc phục sự cố

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

"Không tìm thấy khóa API"

# Xác minh khóa API đã được đặt
hermes config get OPENROUTER_API_KEY

# Đặt lại nếu cần
hermes config set OPENROUTER_API_KEY sk-or-...

"Mô hình không khả dụng"

# Liệt kê các mô hình khả dụng
hermes models list

# Thay đổi mô hình
hermes config set model anthropic/claude-opus-4

"Cổng không thể khởi động"

# Kiểm tra trạng thái cổng
hermes gateway status

# Khởi động lại cổng
hermes gateway stop
hermes gateway start

"Phát hiện hỏng bộ nhớ"

# Sao lưu bộ nhớ hiện tại
hermes memory export ~/backup/memory-backup.json

# Đặt lại bộ nhớ
hermes memory reset

# Nhập lại nếu cần
hermes memory import ~/backup/memory-backup.json

Nhận trợ giúp

Trợ giúp tích hợp:

> /help

Xem nhật ký:

hermes logs tail --follow

Chạy chẩn đoán:

hermes doctor

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

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

Bản thân Hermes là miễn phí. Bạn chỉ trả tiền cho việc sử dụng LLM. Chi phí điển hình:

Sử dụng các mô hình cục bộ (Ollama) là miễn phí nhưng yêu cầu phần cứng.

Hermes có thể chạy 24/7 không?

Có. Triển khai Hermes trên một VPS:

# Cài đặt trên VPS
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# Chạy dưới dạng dịch vụ systemd
hermes service install
hermes service start

Hermes có phù hợp cho việc sử dụng trong doanh nghiệp không?

Có. Các tính năng dành cho doanh nghiệp bao gồm:

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

hermes claw migrate --dry-run  # Xem trước
hermes claw migrate            # Di chuyển hoàn chỉnh
hermes doctor                  # Xác minh

Tôi có thể sử dụng Hermes mà không cần internet không?

Có, với các mô hình cục bộ:

# Cài đặt Ollama
curl -fsSL https://ollama.ai/install.sh | sh

# Kéo một mô hình
ollama pull qwen2.5-coder:32b

# Cấu hình Hermes
hermes config set model ollama
hermes config set model.default qwen2.5-coder:32b

Sự khác biệt giữa Hermes và ChatGPT là gì?

Tính năng

Hermes

ChatGPT

Bộ nhớ

Liên tục, có thể tìm kiếm

Chỉ theo phiên

Triển khai

Tự lưu trữ, 24/7

Chỉ đám mây

Lựa chọn mô hình

Hơn 200 mô hình

Chỉ GPT

Khả năng mở rộng

Plugin, kỹ năng

Hạn chế

Chi phí

Chỉ trả cho việc sử dụng

Đăng ký

Quyền riêng tư

Bạn kiểm soát dữ liệu

OpenAI lưu trữ dữ liệu

Làm cách nào để sao lưu dữ liệu Hermes của tôi?

# Xuất tất cả
hermes export --all ~/backup/hermes-full-backup.tar.gz

Hermes có thể truy cập các tệp cục bộ của tôi không?

Hermes chỉ có thể truy cập các tệp bạn tham chiếu rõ ràng hoặc các thư mục bạn đã cấp quyền. Theo mặc định, nó không có quyền truy cập vào hệ thống tệp của bạn.

💡
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.
button

Thực hành thiết kế API trong Apidog

Khám phá cách dễ dàng hơn để xây dựng và sử dụng API

Đăng ký miễn phíTải xuống