Chuyển tới nội dung chính

Câu hỏi thường gặp & Khắc phục sự cố

Câu trả lời nhanh và cách khắc phục cho các câu hỏi và vấn đề phổ biến nhất.

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

Nhà cung cấp LLM nào hợp tác với Hermes?​

Hermes Agent hoạt động với mọi API tương thích với OpenAI. Các nhà cung cấp được hỗ trợ bao gồm:

  • OpenRouter — truy cập hàng trăm mô hình thông qua một khóa API (được khuyến nghị để linh hoạt)
  • Nous Portal — Điểm cuối suy luận riêng của Nous Research
  • OpenAI — GPT-4o, o1, o3, v.v.
  • Anthropic — Mô hình Claude (thông qua OpenRouter hoặc proxy tương thích)
  • Google — Mô hình Gemini (thông qua OpenRouter hoặc proxy tương thích)
  • z.ai / ZhipuAI — Các mẫu GLM
  • Kimi / Moonshot AI — Người mẫu Kimi
  • MiniMax — điểm cuối toàn cầu và Trung Quốc
  • Mô hình cục bộ — qua Ollama, vLLM, llama.cpp, SGLang] hoặc bất kỳ máy chủ nào tương thích với OpenAI

Đặt nhà cung cấp của bạn bằng hermes model hoặc bằng cách chỉnh sửa ~/.hermes/.env . Xem tài liệu tham khảo Biến môi trường để biết tất cả các khóa của nhà cung cấp.

Nó có hoạt động trên Windows không?​

Không phải nguyên bản. Hermes Agent yêu cầu môi trường giống Unix. Trên Windows, cài đặt WSL2 và chạy Hermes từ bên trong nó. Lệnh cài đặt tiêu chuẩn hoạt động hoàn hảo trong WSL2:

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

Dữ liệu của tôi có được gửi đi đâu không?​

Lệnh gọi API chỉ được gửi đến nhà cung cấp LLM mà bạn định cấu hình (ví dụ: OpenRouter, phiên bản Ollama cục bộ của bạn). Hermes Agent không thu thập dữ liệu đo từ xa, dữ liệu sử dụng hoặc phân tích. Cuộc trò chuyện, trí nhớ và kỹ năng của bạn được lưu trữ cục bộ trong ~/.hermes/ .

Tôi có thể sử dụng ngoại tuyến / với các mẫu máy cục bộ không?​

Đúng. Chạy hermes model , chọn Custom Endpoint và nhập URL máy chủ của bạn:

hermes model
# Select: Custom endpoint (enter URL manually)
# API base URL: http://localhost:11434/v1
# API key: ollama
# Model name: qwen3.5:27b
# Context length: 32768   ← set this to match your server's actual context window

Hoặc định cấu hình trực tiếp trong config.yaml :

model:
  default: qwen3.5:27b
  provider: custom
  base_url: http://localhost:11434/v1

Hermes duy trì điểm cuối, nhà cung cấp và URL cơ sở trong config.yaml để nó vẫn tồn tại sau khi khởi động lại. Nếu máy chủ cục bộ của bạn đã tải chính xác một mô hình, /model custom sẽ tự động phát hiện mô hình đó. Bạn cũng có thể đặt provider: custom trong config.yaml — đây là nhà cung cấp hạng nhất, không phải bí danh cho bất kỳ nhà cung cấp nào khác.

Tính năng này hoạt động với Ollama, vLLM, máy chủ llama.cpp, SGLang, LocalAI và các máy chủ khác. Xem Hướng dẫn cấu hình để biết chi tiết.

Người dùng Ollama

Nếu bạn đặt num_ctx tùy chỉnh trong Ollama (ví dụ: ollama run --num_ctx 16384 ), hãy đảm bảo đặt độ dài ngữ cảnh phù hợp trong Hermes — /api/show của Ollama báo cáo ngữ cảnh tối đa của mô hình, chứ không phải num_ctx hiệu quả mà bạn đã định cấu hình.

Nó có giá bao nhiêu?​

Bản thân Hermes Agent miễn phí và là nguồn mở (giấy phép MIT). Bạn chỉ trả tiền cho việc sử dụng API LLM từ nhà cung cấp bạn đã chọn. Các mô hình địa phương hoàn toàn miễn phí để chạy.

Nhiều người có thể sử dụng một phiên bản không?​

Đúng. Cổng nhắn tin cho phép nhiều người dùng tương tác với cùng một phiên bản Hermes Agent thông qua Telegram, Discord, Slack, WhatsApp hoặc Home Assistant. Quyền truy cập được kiểm soát thông qua danh sách cho phép (ID người dùng cụ thể) và ghép nối DM (người dùng đầu tiên gửi tin nhắn yêu cầu quyền truy cập).

Sự khác biệt giữa trí nhớ và kỹ năng là gì?- Bộ nhớ lưu trữ sự kiện — những điều mà nhân viên biết về bạn, dự án và sở thích của bạn. Ký ức được truy xuất tự động dựa trên mức độ liên quan.​

  • Kỹ năng lưu trữ thủ tục — hướng dẫn từng bước về cách thực hiện mọi việc. Các kỹ năng được thu hồi khi đặc vụ gặp một nhiệm vụ tương tự.

Cả hai đều tồn tại qua các phiên. Xem Bộ nhớ và Kỹ năng để biết chi tiết.

Tôi có thể sử dụng nó trong dự án Python của riêng mình không?​

Đúng. Nhập lớp AIAgent và sử dụng Hermes theo chương trình:

from run_agent import AIAgent

agent = AIAgent(model="openrouter/nous/hermes-3-llama-3.1-70b")
response = agent.chat("Explain quantum computing briefly")

Xem Hướng dẫn Thư viện Python để biết cách sử dụng API đầy đủ.

Khắc phục sự cố

Sự cố cài đặt​

hermes: command not found sau khi cài đặt​

Lý do: Shell của bạn chưa tải lại PATH đã cập nhật.

Giải pháp:

# Reload your shell profile
source ~/.bashrc    

# bash
source ~/.zshrc     

# zsh

# Or start a new terminal session

Nếu nó vẫn không hoạt động, hãy xác minh vị trí cài đặt:

which hermes
ls ~/.local/bin/hermes

mẹo

Trình cài đặt thêm ~/.local/bin vào PATH của bạn. Nếu bạn sử dụng cấu hình shell không chuẩn, hãy thêm export PATH="$HOME/.local/bin:$PATH" theo cách thủ công.

Phiên bản Python quá cũ​

Lý do: Hermes yêu cầu Python 3.11 trở lên.

Giải pháp:

python3 --version   

# Check current version

# Install a newer Python
sudo apt install python3.12   

# Ubuntu/Debian
brew install python@3.12      

# macOS

Trình cài đặt tự động xử lý việc này — nếu bạn thấy lỗi này trong quá trình cài đặt thủ công, trước tiên hãy nâng cấp Python.

uv: command not found​

Lý do: Trình quản lý gói uv chưa được cài đặt hoặc không có trong PATH.

Giải pháp:

curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.bashrc

Lỗi từ chối quyền trong quá trình cài đặt​

Lý do: Không đủ quyền để ghi vào thư mục cài đặt.

Giải pháp:

# Don't use sudo with the installer — it installs to ~/.local/bin
# If you previously installed with sudo, clean up:
sudo rm /usr/local/bin/hermes
# Then re-run the standard installer
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Vấn đề về nhà cung cấp và mô hình​

Khóa API không hoạt động​

Lý do: Key bị thiếu, hết hạn, đặt sai hoặc sai nhà cung cấp.

Giải pháp:

# Check your configuration
hermes config show

# Re-configure your provider
hermes model

# Or set directly
hermes config set OPENROUTER_API_KEY sk-or-v1-xxxxxxxxxxxx

cảnh báo

Đảm bảo khóa khớp với nhà cung cấp. Khóa OpenAI sẽ không hoạt động với OpenRouter và ngược lại. Kiểm tra ~/.hermes/.env để biết các mục nhập xung đột.

Không có mẫu máy/không tìm thấy mẫu máy​

Lý do: Mã định danh mẫu máy không chính xác hoặc không có sẵn trên nhà cung cấp của bạn.

Giải pháp:

# List available models for your provider
hermes model

# Set a valid model
hermes config set HERMES_MODEL openrouter/nous/hermes-3-llama-3.1-70b

# Or specify per-session
hermes chat --model openrouter/meta-llama/llama-3.1-70b-instruct

Giới hạn tỷ lệ (429 lỗi)​

Lý do: Bạn đã vượt quá giới hạn tốc độ của nhà cung cấp.

Giải pháp: Đợi một lát và thử lại. Để sử dụng lâu dài, hãy cân nhắc:

  • Nâng cấp gói nhà cung cấp của bạn
  • Chuyển sang model hoặc nhà cung cấp khác
  • Sử dụng hermes chat --provider <alternative> để định tuyến đến một chương trình phụ trợ khác

Đã vượt quá độ dài ngữ cảnh​

Lý do: Cuộc trò chuyện đã quá dài so với cửa sổ ngữ cảnh của mô hình hoặc Hermes đã phát hiện thấy độ dài ngữ cảnh không chính xác cho mô hình của bạn.

Giải pháp:

# Compress the current session
/compress

# Or start a fresh session
hermes chat

# Use a model with a larger context window
hermes chat --model openrouter/google/gemini-3-flash-preview

Nếu điều này xảy ra trong cuộc trò chuyện dài đầu tiên, Hermes có thể đã hiểu sai độ dài ngữ cảnh cho mô hình của bạn. Kiểm tra những gì nó phát hiện:

Nhìn vào dòng khởi động CLI - nó hiển thị độ dài ngữ cảnh được phát hiện (ví dụ: 📊 Context limit: 128000 tokens ). Bạn cũng có thể kiểm tra bằng /usage trong phiên.

Để sửa lỗi phát hiện ngữ cảnh, hãy đặt nó một cách rõ ràng:

# In ~/.hermes/config.yaml
model:
  default: your-model-name
  context_length: 131072  

# your model's actual context window

Hoặc đối với các điểm cuối tùy chỉnh, hãy thêm nó vào mỗi mô hình:

custom_providers:
  - name: "My Server"
    base_url: "http://localhost:11434/v1"
    models:
      qwen3.5:27b:
        context_length: 32768

Xem Phát hiện độ dài ngữ cảnh để biết cách hoạt động của tính năng tự động phát hiện và tất cả các tùy chọn ghi đè.

Sự cố terminal​

Lệnh bị chặn vì nguy hiểmLý do: Hermes đã phát hiện thấy một lệnh có khả năng phá hoại (ví dụ: rm -rf , DROP TABLE ). Đây là một tính năng an toàn.​

Giải pháp: Khi được nhắc, hãy xem lại lệnh và nhập y để phê duyệt. Bạn cũng có thể:

  • Yêu cầu đại lý sử dụng giải pháp thay thế an toàn hơn
  • Xem danh sách đầy đủ các mẫu nguy hiểm trong Tài liệu bảo mật
mẹo

Điều này đang hoạt động như dự định - Hermes không bao giờ âm thầm thực hiện các lệnh phá hoại. Lời nhắc phê duyệt hiển thị cho bạn chính xác những gì sẽ thực thi.

sudo không hoạt động qua cổng nhắn tin​

Lý do: Cổng nhắn tin chạy mà không có terminal tương tác nên sudo không thể nhắc nhập mật khẩu.

Giải pháp:

  • Tránh sudo trong tin nhắn — yêu cầu đại lý tìm giải pháp thay thế
  • Nếu bạn phải sử dụng sudo , hãy định cấu hình sudo không mật khẩu cho các lệnh cụ thể trong /etc/sudoers
  • Hoặc chuyển sang giao diện terminal cho các tác vụ quản trị: hermes chat

Chương trình phụ trợ Docker không kết nối​

Lý do: Docker daemon không chạy hoặc người dùng thiếu quyền.

Giải pháp:

# Check Docker is running
docker info

# Add your user to the docker group
sudo usermod -aG docker $USER
newgrp docker

# Verify
docker run hello-world

Sự cố nhắn tin​

Bot không trả lời tin nhắn​

Lý do: Bot hiện không chạy, không được cấp phép hoặc người dùng của bạn không có trong danh sách cho phép.

Giải pháp:

# Check if the gateway is running
hermes gateway status

# Start the gateway
hermes gateway start

# Check logs for errors
cat ~/.hermes/logs/gateway.log | tail -50

Tin nhắn không gửi được​

Lý do: Sự cố mạng, mã thông báo bot đã hết hạn hoặc cấu hình webhook nền tảng sai.

Giải pháp:

  • Xác minh mã thông báo bot của bạn hợp lệ với hermes gateway setup
  • Kiểm tra nhật ký cổng: cat ~/.hermes/logs/gateway.log | tail -50
  • Đối với các nền tảng dựa trên webhook (Slack, WhatsApp), hãy đảm bảo máy chủ của bạn có thể truy cập công khai

Nhầm lẫn về danh sách cho phép — ai có thể nói chuyện với bot?​

Lý do: Chế độ ủy quyền xác định ai có quyền truy cập.

Giải pháp:

Chế độNó hoạt động như thế nào
Danh sách cho phépChỉ ID người dùng được liệt kê trong cấu hình mới có thể tương tác
Ghép nối DMNgười dùng đầu tiên nhắn tin trong DM yêu cầu quyền truy cập độc quyền
MởBất cứ ai cũng có thể tương tác (không được khuyến khích sản xuất)

Định cấu hình trong ~/.hermes/config.yaml trong cài đặt cổng của bạn. Xem Tài liệu nhắn tin.

Cổng không khởi động​

Lý do: Thiếu phần phụ thuộc, xung đột cổng hoặc mã thông báo bị định cấu hình sai.

Giải pháp:

# Install messaging dependencies
pip install "hermes-agent[telegram]"   

# or [discord], [slack], [whatsapp]

# Check for port conflicts
lsof -i :8080

# Verify configuration
hermes config show

macOS: Node.js/ffmpeg/các công cụ khác không được cổng kết nối tìm thấy​

Lý do: các dịch vụ launchd kế thừa một PATH tối thiểu ( /usr/bin:/bin:/usr/sbin:/sbin ) không bao gồm Homebrew, nvm, Cargo hoặc các thư mục công cụ do người dùng cài đặt khác. Điều này thường phá vỡ cầu nối WhatsApp ( node not found ) hoặc phiên âm giọng nói ( ffmpeg not found ).

Giải pháp: Cổng ghi lại shell PATH của bạn khi bạn chạy hermes gateway install . Nếu bạn đã cài đặt các công cụ sau khi thiết lập cổng, hãy chạy lại quá trình cài đặt để ghi lại PATH đã cập nhật:

hermes gateway install    

# Re-snapshots your current PATH
hermes gateway start      

# Detects the updated plist and reloads

Bạn có thể xác minh số nguyên có PATH chính xác:

/usr/libexec/PlistBuddy -c "Print :EnvironmentVariables:PATH" \
  ~/Library/LaunchAgents/ai.hermes.gateway.plist

Vấn đề về hiệu suất​

Phản hồi chậm​

Lý do: Model lớn, máy chủ API ở xa hoặc lời nhắc hệ thống nặng với nhiều công cụ.Giải pháp:

  • Thử mô hình nhanh hơn/nhỏ hơn: hermes chat --model openrouter/meta-llama/llama-3.1-8b-instruct
  • Giảm bộ công cụ đang hoạt động: hermes chat -t "terminal"
  • Kiểm tra độ trễ mạng của bạn với nhà cung cấp
  • Đối với các model cục bộ, đảm bảo bạn có đủ GPU VRAM

Mức sử dụng token cao​

Lý do: Cuộc trò chuyện dài, lời nhắc hệ thống dài dòng hoặc nhiều lệnh gọi công cụ tích lũy ngữ cảnh.

Giải pháp:

# Compress the conversation to reduce tokens
/compress

# Check session token usage
/usage

mẹo

Sử dụng /compress thường xuyên trong thời gian dài. Nó tóm tắt lịch sử hội thoại và giảm đáng kể việc sử dụng mã thông báo trong khi vẫn giữ nguyên ngữ cảnh.

Phiên quá dài​

Lý do: Các cuộc hội thoại kéo dài sẽ tích lũy thông báo và kết quả đầu ra của công cụ, tiến đến giới hạn ngữ cảnh.

Giải pháp:

# Compress current session (preserves key context)
/compress

# Start a new session with a reference to the old one
hermes chat

# Resume a specific session later if needed
hermes chat --continue

Vấn đề về MCP​

Máy chủ MCP không kết nối​

Lý do: Không tìm thấy tệp nhị phân của máy chủ, đường dẫn lệnh sai hoặc thiếu thời gian chạy.

Giải pháp:

# Ensure MCP dependencies are installed (already included in standard install)
cd ~/.hermes/hermes-agent && uv pip install -e ".[mcp]"

# For npm-based servers, ensure Node.js is available
node --version
npx --version

# Test the server manually
npx -y @modelcontextprotocol/server-filesystem /tmp

Xác minh cấu hình ~/.hermes/config.yaml MCP của bạn:

mcp_servers:
  filesystem:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/docs"]

Công cụ không hiển thị từ máy chủ MCP​

Lý do: Máy chủ đã khởi động nhưng việc khám phá công cụ không thành công, các công cụ bị lọc ra theo cấu hình hoặc máy chủ không hỗ trợ khả năng MCP mà bạn mong đợi.

Giải pháp:

  • Kiểm tra nhật ký cổng/đại lý để tìm lỗi kết nối MCP
  • Đảm bảo máy chủ phản hồi phương thức tools/list RPC
  • Xem lại mọi cài đặt tools.include , tools.exclude , tools.resources , tools.prompts hoặc enabled trong máy chủ đó
  • Hãy nhớ rằng các công cụ tiện ích tài nguyên/nhắc nhở chỉ được đăng ký khi phiên thực sự hỗ trợ các khả năng đó
  • Sử dụng /reload-mcp sau khi thay đổi cấu hình
# Verify MCP servers are configured
hermes config show | grep -A 12 mcp_servers

# Restart Hermes or reload MCP after config changes
hermes chat

Xem thêm:

lỗi hết thời gian MCP​

Lý do: Máy chủ MCP mất quá nhiều thời gian để phản hồi hoặc bị lỗi trong quá trình thực thi.

Giải pháp:

  • Tăng thời gian chờ trong cấu hình máy chủ MCP của bạn nếu được hỗ trợ
  • Kiểm tra xem tiến trình máy chủ MCP có còn chạy không
  • Đối với máy chủ HTTP MCP từ xa, hãy kiểm tra kết nối mạng
cảnh báo

Nếu máy chủ MCP gặp sự cố khi đang yêu cầu, Hermes sẽ báo cáo thời gian chờ. Kiểm tra nhật ký của chính máy chủ (không chỉ nhật ký của Hermes) để chẩn đoán nguyên nhân gốc rễ.

Hồ sơ

Cấu hình khác với việc chỉ cài đặt HERMES_HOME như thế nào?​

Hồ sơ là một lớp được quản lý bên trên HERMES_HOME . Bạn có thể đặt HERMES_HOME=/some/path theo cách thủ công trước mỗi lệnh, nhưng hồ sơ sẽ xử lý tất cả hệ thống ống nước cho bạn: tạo cấu trúc thư mục, tạo bí danh shell ( hermes-work ), theo dõi hồ sơ hoạt động trong ~/.hermes/active_profile và tự động đồng bộ hóa các cập nhật kỹ năng trên tất cả các hồ sơ. Chúng cũng tích hợp tính năng hoàn thành tab để bạn không cần phải nhớ đường dẫn.

Hai hồ sơ có thể chia sẻ cùng một mã thông báo bot không?​

Không. Mỗi nền tảng nhắn tin (Telegram, Discord, v.v.) yêu cầu quyền truy cập độc quyền vào mã thông báo bot. Nếu hai cấu hình cố gắng sử dụng cùng một mã thông báo, cổng thứ hai sẽ không kết nối được. Tạo một bot riêng cho mỗi hồ sơ — đối với Telegram, hãy nói chuyện với @BotFather để tạo thêm bot.

Hồ sơ có chia sẻ bộ nhớ hoặc phiên không?Không. Mỗi hồ sơ có kho bộ nhớ, cơ sở dữ liệu phiên và thư mục kỹ năng riêng. Họ hoàn toàn bị cô lập. Nếu bạn muốn bắt đầu một hồ sơ mới với các kỷ niệm và phiên hiện có, hãy sử dụng hermes profile create newname --clone-all để sao chép mọi thứ từ hồ sơ hiện tại.​

Điều gì xảy ra khi tôi chạy hermes update ?​

hermes update lấy mã mới nhất và cài đặt lại các phần phụ thuộc một lần (không phải trên mỗi hồ sơ). Sau đó, nó sẽ tự động đồng bộ hóa các kỹ năng được cập nhật cho tất cả các hồ sơ. Bạn chỉ cần chạy hermes update một lần — nó bao gồm mọi cấu hình trên máy.

Tôi có thể di chuyển hồ sơ sang máy khác không?​

Đúng. Xuất cấu hình sang kho lưu trữ di động và nhập nó vào máy khác:

# On the source machine
hermes profile export work ./work-backup.tar.gz

# Copy the file to the target machine, then:
hermes profile import ./work-backup.tar.gz work

Hồ sơ đã nhập sẽ có tất cả cấu hình, ký ức, phiên và kỹ năng từ khi xuất. Bạn có thể cần cập nhật đường dẫn hoặc xác thực lại với nhà cung cấp nếu máy mới có thiết lập khác.

Tôi có thể chạy bao nhiêu hồ sơ?​

Không có giới hạn cứng. Mỗi hồ sơ chỉ là một thư mục trong ~/.hermes/profiles/ . Giới hạn thực tế tùy thuộc vào dung lượng ổ đĩa của bạn và số lượng cổng đồng thời mà hệ thống của bạn có thể xử lý (mỗi cổng là một quy trình Python nhẹ). Chạy hàng tá hồ sơ là được; mỗi hồ sơ nhàn rỗi không sử dụng tài nguyên.

Quy trình làm việc & Mẫu

Sử dụng các mô hình khác nhau cho các tác vụ khác nhau (quy trình làm việc đa mô hình)​

Kịch bản: Bạn sử dụng GPT-5.4 làm trình điều khiển hàng ngày nhưng Gemini hoặc Grok viết nội dung mạng xã hội tốt hơn. Việc chuyển đổi mô hình theo cách thủ công mỗi lần thật tẻ nhạt.

Giải pháp: Cấu hình ủy quyền. Hermes có thể tự động định tuyến các đại lý phụ đến một mô hình khác. Đặt cái này trong ~/.hermes/config.yaml :

delegation:
  model: "google/gemini-3-flash-preview"   

# subagents use this model
  provider: "openrouter"                    

# provider for subagents

Bây giờ, khi bạn nói với Hermes "viết cho tôi một chủ đề Twitter về X" và nó sinh ra một tác nhân phụ delegate_task, tác nhân phụ đó sẽ chạy trên Gemini thay vì mô hình chính của bạn. Cuộc trò chuyện chính của bạn vẫn ở trên GPT-5.4.

Bạn cũng có thể nêu rõ lời nhắc của mình: "Giao nhiệm vụ viết bài đăng trên mạng xã hội về việc ra mắt sản phẩm của chúng tôi. Sử dụng tác nhân phụ của bạn để viết thực tế." Nhân viên hỗ trợ sẽ sử dụng delegate_task , tự động chọn cấu hình ủy quyền.

Đối với chuyển đổi mô hình một lần mà không cần ủy quyền, hãy sử dụng /model trong CLI:

/model google/gemini-3-flash-preview    

# switch for this session
# ... write your content ...
/model openai/gpt-5.4                   

# switch back

Xem Ủy nhiệm đại lý phụ để biết thêm về cách ủy quyền hoạt động.

Chạy nhiều tổng đài viên trên một số WhatsApp (ràng buộc mỗi cuộc trò chuyện)​

Kịch bản: Trong OpenClaw, bạn có nhiều nhân viên độc lập được liên kết với các cuộc trò chuyện WhatsApp cụ thể — một nhân viên dành cho nhóm danh sách mua sắm gia đình, một nhân viên khác dành cho cuộc trò chuyện riêng tư của bạn. Hermes có thể làm được điều này không?

Giới hạn hiện tại: Mỗi hồ sơ Hermes yêu cầu số/phiên WhatsApp riêng. Bạn không thể liên kết nhiều hồ sơ với các cuộc trò chuyện khác nhau trên cùng một số WhatsApp — cầu nối WhatsApp (Baileys) sử dụng một phiên xác thực cho mỗi số.

Cách giải quyết:

  1. Sử dụng một hồ sơ duy nhất có tính năng chuyển đổi tính cách. Tạo các tệp ngữ cảnh AGENTS.md khác nhau hoặc sử dụng lệnh /personality để thay đổi hành vi trên mỗi cuộc trò chuyện. Nhân viên hỗ trợ sẽ xem cuộc trò chuyện nào đang diễn ra và có thể điều chỉnh.2. Sử dụng công việc định kỳ cho các tác vụ chuyên biệt. Để theo dõi danh sách mua sắm, hãy thiết lập công việc định kỳ để giám sát một cuộc trò chuyện cụ thể và quản lý danh sách — không cần tác nhân riêng biệt.

  2. Sử dụng các số riêng biệt. Nếu bạn cần các đại lý thực sự độc lập, hãy ghép từng hồ sơ với số WhatsApp riêng. Các số ảo từ các dịch vụ như Google Voice có tác dụng cho việc này.

  3. Thay vào đó, hãy sử dụng Telegram hoặc Discord. Các nền tảng này hỗ trợ liên kết mỗi cuộc trò chuyện một cách tự nhiên hơn — mỗi nhóm Telegram hoặc kênh Discord có phiên riêng và bạn có thể chạy nhiều mã thông báo bot (một mã thông báo cho mỗi hồ sơ) trên cùng một tài khoản.

Xem Hồ sơ và WhatsApp setup để biết thêm chi tiết.

Kiểm soát những gì hiển thị trong Telegram (ẩn nhật ký và lý do)​

Tình huống: Bạn thấy nhật ký thực thi cổng, lý luận của Hermes và chi tiết lệnh gọi công cụ trong Telegram thay vì chỉ đầu ra cuối cùng.

Giải pháp: Cài đặt display.tool_progress trong config.yaml kiểm soát mức độ hoạt động của công cụ được hiển thị:

display:
  tool_progress: "off"   

# options: off, new, all, verbose

  • ** off ** — Chỉ phản hồi cuối cùng. Không có cuộc gọi công cụ, không có lý do, không có nhật ký.
  • ** new ** — Hiển thị các lệnh gọi công cụ mới khi chúng diễn ra (một đoạn ngắn gọn).
  • ** all ** — Hiển thị tất cả hoạt động của công cụ bao gồm cả kết quả.
  • ** verbose ** — Chi tiết đầy đủ bao gồm các đối số và đầu ra của công cụ.

Đối với nền tảng nhắn tin, off hoặc new thường là những gì bạn muốn. Sau khi chỉnh sửa config.yaml , hãy khởi động lại cổng để các thay đổi có hiệu lực.

Bạn cũng có thể chuyển đổi mỗi phiên này bằng lệnh /verbose (nếu được bật):

display:
  tool_progress_command: true   

# enables /verbose in the gateway

Quản lý kỹ năng trên Telegram (giới hạn lệnh gạch chéo)​

Kịch bản: Telegram có giới hạn lệnh gạch chéo là 100 và kỹ năng của bạn đang vượt qua giới hạn đó. Bạn muốn tắt các kỹ năng bạn không cần trên Telegram nhưng cài đặt hermes skills config dường như không có hiệu lực.

Giải pháp: Sử dụng hermes skills config để tắt các kỹ năng trên mỗi nền tảng. Điều này ghi vào config.yaml :

skills:
  disabled: []                    

# globally disabled skills
  platform_disabled:
    telegram: [skill-a, skill-b]  

# disabled only on telegram

Sau khi thay đổi điều này, khởi động lại cổng ( hermes gateway restart hoặc tắt và khởi chạy lại). Menu lệnh bot Telegram được xây dựng lại khi khởi động.

mẹo

Các kỹ năng có mô tả rất dài sẽ bị cắt ngắn xuống còn 40 ký tự trong menu Telegram để duy trì giới hạn kích thước tải trọng. Nếu các kỹ năng không xuất hiện, đó có thể là vấn đề về tổng kích thước tải trọng chứ không phải do giới hạn số lượng lệnh 100 — việc tắt các kỹ năng không sử dụng sẽ giúp ích cho cả hai.

Phiên chủ đề được chia sẻ (nhiều người dùng, một cuộc trò chuyện)​

Tình huống: Bạn có một chuỗi Telegram hoặc Discord trong đó có nhiều người đề cập đến bot. Bạn muốn tất cả các lượt đề cập trong chuỗi đó là một phần của một cuộc trò chuyện được chia sẻ chứ không phải các phiên riêng biệt của mỗi người dùng.

Hành vi hiện tại: Hermes tạo các phiên được khóa bằng ID người dùng trên hầu hết các nền tảng để mỗi người có được bối cảnh trò chuyện của riêng mình. Đây là do thiết kế để bảo mật và cách ly bối cảnh.

Cách giải quyết:

  1. Sử dụng Slack. Phiên Slack được khóa theo chuỗi chứ không phải theo người dùng. Nhiều người dùng trong cùng một chuỗi chia sẻ một cuộc trò chuyện — chính xác là hành vi mà bạn đang mô tả. Đây là sự phù hợp tự nhiên nhất.2. Sử dụng cuộc trò chuyện nhóm với một người dùng duy nhất. Nếu một người là "người điều hành" được chỉ định để chuyển tiếp câu hỏi thì phiên vẫn duy trì sự thống nhất. Những người khác có thể đọc theo.

  2. Sử dụng kênh Discord. Các phiên Discord được khóa theo kênh, vì vậy tất cả người dùng trong cùng một kênh sẽ chia sẻ bối cảnh. Sử dụng một kênh dành riêng cho cuộc trò chuyện được chia sẻ.

Xuất Hermes sang máy khác​

Tình huống: Bạn đã xây dựng các kỹ năng, công việc định kỳ và ký ức trên một máy và muốn chuyển mọi thứ sang một hộp Linux chuyên dụng mới.

Giải pháp:

  1. Cài đặt Hermes Agent trên máy mới:
   curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

  1. Sao chép toàn bộ thư mục ~/.hermes/ của bạn ngoại trừ thư mục con hermes-agent (đó là kho mã - bản cài đặt mới có thư mục riêng):
   

# On the source machine
   rsync -av --exclude='hermes-agent' ~/.hermes/ newmachine:~/.hermes/

Hoặc sử dụng xuất/nhập hồ sơ:

   

# On source machine
   hermes profile export default ./hermes-backup.tar.gz

   

# On target machine
   hermes profile import ./hermes-backup.tar.gz default

  1. Trên máy mới, hãy chạy hermes setup để xác minh khóa API và cấu hình nhà cung cấp đang hoạt động. Xác thực lại mọi nền tảng nhắn tin (đặc biệt là WhatsApp sử dụng tính năng ghép nối QR).

Thư mục ~/.hermes/ chứa mọi thứ: config.yaml , .env , SOUL.md , memories/ , skills/ , state.db (phiên), cron/ và mọi plugin tùy chỉnh. Bản thân mã nằm trong ~/.hermes/hermes-agent/ và được cài đặt mới.

Quyền bị từ chối khi tải lại shell sau khi cài đặt​

Tình huống: Sau khi chạy trình cài đặt Hermes, source ~/.zshrc đưa ra lỗi từ chối cấp phép.

Lý do: Điều này thường xảy ra khi ~/.zshrc (hoặc ~/.bashrc ) có quyền truy cập tệp không chính xác hoặc khi trình cài đặt không thể ghi vào đó một cách rõ ràng. Đây không phải là vấn đề cụ thể của Hermes - đó là vấn đề về quyền cấu hình shell.

Giải pháp:

# Check permissions
ls -la ~/.zshrc

# Fix if needed (should be -rw-r--r-- or 644)
chmod 644 ~/.zshrc

# Then reload
source ~/.zshrc

# Or just open a new terminal window — it picks up PATH changes automatically

Nếu trình cài đặt đã thêm dòng PATH nhưng quyền không đúng, bạn có thể thêm nó theo cách thủ công:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc

Lỗi 400 trong lần chạy tác nhân đầu tiên​

Tình huống: Quá trình thiết lập hoàn tất tốt đẹp nhưng lần thử trò chuyện đầu tiên không thành công với HTTP 400.

Lý do: Thông thường, tên mô hình không khớp — mô hình được định cấu hình không tồn tại trên nhà cung cấp của bạn hoặc khóa API không có quyền truy cập vào mô hình đó.

Giải pháp:

# Check what model and provider are configured
hermes config show | head -20

# Re-run model selection
hermes model

# Or test with a known-good model
hermes chat -q "hello" --model anthropic/claude-sonnet-4.6

Nếu sử dụng OpenRouter, hãy đảm bảo khóa API của bạn có tín dụng. 400 từ OpenRouter thường có nghĩa là mô hình yêu cầu gói trả phí hoặc ID mô hình có lỗi đánh máy.

Vẫn bị kẹt?

Nếu vấn đề của bạn không được đề cập ở đây:

  1. Tìm kiếm các vấn đề hiện có: Vấn đề GitHub
  2. Hỏi cộng đồng: Nous Research Discord
  3. Gửi báo cáo lỗi: Bao gồm hệ điều hành của bạn, phiên bản Python ( python3 --version ), phiên bản Hermes ( hermes --version ) và thông báo lỗi đầy đủ