Đặc vụ Hermes ☤

Đại lý Hermes | Máy tính để bàn Hermes

Tác nhân AI tự cải tiến được xây dựng bởi Nghiên cứu Nous. Đó là tác nhân duy nhất có vòng lặp học tập tích hợp — nó tạo ra các kỹ năng từ kinh nghiệm, cải thiện chúng trong quá trình sử dụng, thúc đẩy bản thân duy trì kiến thức, tìm kiếm các cuộc hội thoại trong quá khứ của chính nó và xây dựng mô hình chuyên sâu hơn về con người bạn qua các phiên. Chạy nó trên VPS giá $5, cụm GPU hoặc cơ sở hạ tầng không có máy chủ mà gần như không tốn phí khi không sử dụng. Nó không bị ràng buộc với máy tính xách tay của bạn — hãy nói chuyện với nó từ Telegram trong khi nó hoạt động trên máy ảo đám mây.

Sử dụng bất kỳ mô hình nào bạn muốn - Cổng thông tin Nous, OpenRouter, OpenAI, điểm cuối của riêng bạn và nhiều người khác. Chuyển đổi với hermes model - không thay đổi mã, không khóa.

Một giao diện thiết bị đầu cuối thực sự	TUI đầy đủ với khả năng chỉnh sửa nhiều dòng, tự động hoàn thành lệnh gạch chéo, lịch sử hội thoại, ngắt và chuyển hướng cũng như đầu ra công cụ truyền phát.
Sống ở nơi bạn làm	Telegram, Discord, Slack, WhatsApp, Signal và CLI — tất cả đều từ một quy trình cổng duy nhất. Phiên âm ghi nhớ giọng nói, liên tục hội thoại đa nền tảng.
Một vòng học tập khép kín	Bộ nhớ được quản lý bởi tác nhân với các chuyển động định kỳ. Tạo kỹ năng tự động sau các nhiệm vụ phức tạp. Kỹ năng tự nâng cao trong quá trình sử dụng. Tìm kiếm phiên FTS5 với tóm tắt LLM để thu hồi giữa các phiên. Honcho mô hình người dùng biện chứng. Tương thích với Agentskills.io chuẩn mở.
Tự động hóa theo lịch trình	Bộ lập lịch cron tích hợp sẵn có thể phân phối đến mọi nền tảng. Báo cáo hàng ngày, sao lưu hàng đêm, kiểm tra hàng tuần — tất cả đều bằng ngôn ngữ tự nhiên, chạy không cần giám sát.
Đại biểu và song song	Tạo ra các tác nhân phụ bị cô lập cho các luồng công việc song song. Viết các tập lệnh Python gọi các công cụ thông qua RPC, thu gọn quy trình nhiều bước thành các lượt không tốn chi phí ngữ cảnh.
Chạy mọi nơi, không chỉ máy tính xách tay của bạn	Bảy chương trình phụ trợ thiết bị đầu cuối — local, Docker, SSH, Singularity, Modal, Daytona và Vercel Sandbox. Daytona và Modal mang đến khả năng hoạt động ổn định không cần máy chủ — môi trường của đại lý của bạn ngủ đông khi không hoạt động và hoạt động theo yêu cầu, hầu như không tốn chi phí nào giữa các phiên. Chạy nó trên VPS $5 hoặc cụm GPU.
Sẵn sàng nghiên cứu	Tạo quỹ đạo hàng loạt, nén quỹ đạo để huấn luyện thế hệ mô hình gọi công cụ tiếp theo.

---

Cài đặt nhanh

Linux, macOS, WSL2, Termux

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Windows (bản địa, PowerShell)

Lưu ý: Windows gốc chạy Hermes không có WSL — CLI, cổng, TUI và các công cụ đều hoạt động nguyên bản. Nếu bạn muốn sử dụng WSL2 hơn thì phần mềm Linux/macOS ở trên cũng hoạt động ở đó. Tìm thấy một lỗi? làm ơn vấn đề về tập tin.

Chạy cái này trong PowerShell:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Trình cài đặt xử lý mọi thứ: uv, Python 3.11, Node.js, ripgrep, ffmpeg, và một Git Bash di động (MinGit, đã giải nén thành %LOCALAPPDATA%\hermes\git - không cần quản trị viên, tách biệt hoàn toàn với mọi cài đặt Git hệ thống). Hermes sử dụng Git Bash đi kèm này để chạy các lệnh shell.

Nếu bạn đã cài đặt Git, trình cài đặt sẽ phát hiện nó và sử dụng nó thay thế. Nếu không, bạn chỉ cần tải xuống MinGit ~45 MB - nó sẽ không chạm hoặc can thiệp vào bất kỳ hệ thống Git nào.

Android/Termux: Đường dẫn thủ công đã được kiểm tra được ghi lại trong hướng dẫn termux. Trên Termux, Hermes cài đặt một hệ thống giám tuyển .[termux] thêm vì đầy đủ .[all] extra hiện kéo theo các phần phụ thuộc giọng nói không tương thích với Android.

Windows: Windows gốc được hỗ trợ đầy đủ - lớp lót PowerShell ở trên sẽ cài đặt mọi thứ. Nếu bạn muốn sử dụng WSL2 hơn thì lệnh Linux cũng hoạt động ở đó. Cài đặt Windows gốc tồn tại dưới %LOCALAPPDATA%\hermes; WSL2 cài đặt trong ~/.hermes như trên Linux.

Sau khi cài đặt:

source ~/.bashrc    # reload shell (or: source ~/.zshrc)
hermes              # start chatting!

Khắc phục sự cố

Cờ Windows Defender hoặc phần mềm chống vi-rút uv.exe như phần mềm độc hại

Nếu phần mềm chống vi-rút của bạn (Bitdefender, Windows Defender, v.v.) bị cách ly uv.exe từ Hermes bin thư mục (%LOCALAPPDATA%\hermes\bin\uv.exe), đây là một dương tính giả. Tệp này là của Astral uv — trình quản lý gói Rust Python mà Hermes đóng gói để quản lý môi trường Python của nó. Các công cụ chống vi-rút dựa trên ML thường gắn cờ các tệp nhị phân Rust không dấu tải xuống và cài đặt gói.

Để xác minh bản sao của bạn là xác thực:

# Install GitHub CLI if needed
winget install --id GitHub.cli

# Login to GitHub
gh auth login

# Run verification
$uv = "$env:LOCALAPPDATA\hermes\bin\uv.exe"
$ver = (& $uv --version).Split(' ')[1]
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
$zip = "$env:TEMP\uv.zip"
Invoke-WebRequest "https://github.com/astral-sh/uv/releases/download/$ver/uv-x86_64-pc-windows-msvc.zip" -OutFile $zip -UseBasicParsing
gh attestation verify $zip --repo astral-sh/uv
Expand-Archive $zip "$env:TEMP\uv_x" -Force
(Get-FileHash "$env:TEMP\uv_x\uv.exe").Hash -eq (Get-FileHash $uv).Hash

Nếu chứng thực cho biết "Xác minh thành công" và dòng cuối cùng được in True, bạn ổn.

Để đưa Hermes vào danh sách trắng:

• Bộ bảo vệ Windows: Chạy PowerShell với tư cách quản trị viên → Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\hermes\bin"
• Bitdefender: Thêm một ngoại lệ trong bảng điều khiển Bitdefender (Bảo vệ > Chống vi-rút > Cài đặt > Quản lý ngoại lệ)
• Danh sách trắng thư mục, không phải hàm băm tệp — bản cập nhật của Hermes uv và hàm băm thay đổi mọi phiên bản

Để biết thêm bối cảnh, hãy xem các báo cáo ngược dòng của Astral: thiên văn-sh/uv#13553, thiên văn-sh/uv#15011, thiên văn-sh/uv#10079.

---

Bắt đầu

hermes              # Interactive CLI — start a conversation
hermes model        # Choose your LLM provider and model
hermes tools        # Configure which tools are enabled
hermes config set   # Set individual config values
hermes config get   # Print individual config values
hermes gateway      # Start the messaging gateway (Telegram, Discord, etc.)
hermes setup        # Run the full setup wizard (configures everything at once)
hermes claw migrate # Migrate from OpenClaw (if coming from OpenClaw)
hermes update       # Update to the latest version
hermes doctor       # Diagnose any issues

📖 Tài liệu đầy đủ →

---

Bỏ qua bộ sưu tập khóa API — Nous Portal

Hermes hợp tác với bất kỳ nhà cung cấp nào bạn muốn — điều đó không thay đổi. Nhưng nếu bạn không muốn thu thập năm khóa API riêng biệt cho mô hình, tìm kiếm trên web, tạo hình ảnh, TTS và trình duyệt đám mây, Cổng thông tin Nous bao gồm tất cả chúng trong một đăng ký:

• Hơn 300 mẫu - chọn bất kỳ trong số họ với /model <name>
• Cổng công cụ — tìm kiếm trên web (Firecrawl), tạo hình ảnh (FAL), chuyển văn bản thành giọng nói (OpenAI), trình duyệt đám mây (Sử dụng trình duyệt), tất cả đều được chuyển qua phụ của bạn. Không có tài khoản bổ sung.

Một lệnh từ bản cài đặt mới:

hermes setup --portal

Thao tác đó sẽ đăng nhập bạn qua OAuth, đặt Nous làm nhà cung cấp của bạn và bật Cổng công cụ. Kiểm tra những gì được kết nối bất cứ lúc nào với hermes portal info. Chi tiết đầy đủ về Trang tài liệu Cổng công cụ.

Bạn vẫn có thể mang theo khóa của riêng mình cho mỗi công cụ bất cứ khi nào bạn muốn — cổng là cho mỗi chương trình phụ trợ, không phải tất cả hoặc không có gì.

---

CLI và Tham khảo nhanh về nhắn tin

Hermes có hai điểm vào: khởi động giao diện người dùng đầu cuối với hermeshoặc chạy cổng và nói chuyện với nó từ Telegram, Discord, Slack, WhatsApp, Signal hoặc Email. Khi bạn đang trò chuyện, nhiều lệnh gạch chéo sẽ được chia sẻ trên cả hai giao diện.

hành động	CLI	Nền tảng nhắn tin
Bắt đầu trò chuyện	hermes	Chạy hermes gateway setup + hermes gateway start, sau đó gửi tin nhắn cho bot
Bắt đầu cuộc trò chuyện mới	/new hoặc /reset	/new hoặc /reset
Thay đổi mô hình	/model [provider:model]	/model [provider:model]
Đặt tính cách	/personality [name]	/personality [name]
Thử lại hoặc hoàn tác lượt cuối cùng	/retry, /undo	/retry, /undo
Nén ngữ cảnh/kiểm tra mức sử dụng	/compress, /usage, /insights [--days N]	/compress, /usage, /insights [days]
Duyệt kỹ năng	/skills hoặc /<skill-name>	/<skill-name>
Làm gián đoạn công việc hiện tại	Ctrl+C hoặc gửi tin nhắn mới	/stop hoặc gửi tin nhắn mới
Trạng thái dành riêng cho nền tảng	/platforms	/status, /sethome

Để biết danh sách lệnh đầy đủ, hãy xem hướng dẫn CLI và Hướng dẫn về Cổng Nhắn tin.

---

Tài liệu

Tất cả tài liệu tồn tại tại hermes-agent.nousresearch.com/docs:

Phần	Những gì được bảo hiểm
Bắt đầu nhanh	Cài đặt → thiết lập → cuộc trò chuyện đầu tiên sau 2 phút
CLI Cách sử dụng	Lệnh, tổ hợp phím, tính cách, phiên
Cấu hình	Tệp cấu hình, nhà cung cấp, mô hình, tất cả các tùy chọn
Cổng nhắn tin	Telegram, Discord, Slack, WhatsApp, Signal, Trợ lý tại nhà
Bảo mật	Phê duyệt lệnh, ghép nối DM, cách ly vùng chứa
Công cụ & Bộ công cụ	Hơn 40 công cụ, hệ thống bộ công cụ, phụ trợ thiết bị đầu cuối
Hệ thống kỹ năng	Bộ nhớ thủ tục, Trung tâm kỹ năng, tạo kỹ năng
Bộ nhớ	Bộ nhớ liên tục, hồ sơ người dùng, phương pháp hay nhất
Tích hợp MCP	Kết nối bất kỳ máy chủ MCP nào để có khả năng mở rộng
Lập lịch Cron	Nhiệm vụ theo lịch trình với phân phối nền tảng
Tệp ngữ cảnh	Bối cảnh dự án định hình mọi cuộc trò chuyện
Kiến trúc	Cấu trúc dự án, vòng lặp tác nhân, các lớp khóa
Đóng góp	Thiết lập phát triển, quy trình PR, kiểu mã
CLI Tham khảo	Tất cả các lệnh và cờ
Biến môi trường	Hoàn thành tham chiếu var env

---

Di chuyển từ OpenClaw

Nếu bạn đến từ OpenClaw, Hermes có thể tự động nhập cài đặt, ký ức, kỹ năng và khóa API của bạn.

Trong lần thiết lập đầu tiên: Trình hướng dẫn thiết lập (hermes setup) tự động phát hiện ~/.openclaw và đề nghị di chuyển trước khi bắt đầu cấu hình.

Bất cứ lúc nào sau khi cài đặt:

hermes claw migrate              # Interactive migration (full preset)
hermes claw migrate --dry-run    # Preview what would be migrated
hermes claw migrate --preset user-data   # Migrate without secrets
hermes claw migrate --overwrite  # Overwrite existing conflicts

Những gì được nhập:

• SOUL.md - tập tin cá nhân
• Ký ức — Các mục nhập MEMORY.md và USER.md
• Kỹ năng — kỹ năng do người dùng tạo → ~/.hermes/skills/openclaw-imports/
• Danh sách cho phép lệnh - mẫu phê duyệt
• Cài đặt nhắn tin — cấu hình nền tảng, người dùng được phép, thư mục làm việc
• Phím API — bí mật được liệt kê cho phép (Telegram, OpenRouter, OpenAI, Anthropic, ElevenLabs)
• tài sản TTS - tập tin âm thanh không gian làm việc
• Hướng dẫn về không gian làm việc — ĐẠI LÝ.md (với --workspace-target)

Xem hermes claw migrate --help cho tất cả các tùy chọn hoặc sử dụng openclaw-migration kỹ năng di chuyển có sự hướng dẫn của tác nhân tương tác với các bản xem trước chạy thử.

---

Đóng góp

Chúng tôi hoan nghênh những đóng góp! Xem Hướng dẫn đóng góp để thiết lập phát triển, kiểu mã và quy trình PR.

Bắt đầu nhanh dành cho người đóng góp — sử dụng trình cài đặt tiêu chuẩn, sau đó làm việc từ quy trình kiểm tra git đầy đủ mà nó tạo tại $HERMES_HOME/hermes-agent (thường ~/.hermes/hermes-agent). Điều này phù hợp với bố cục được sử dụng bởi hermes update, venv được quản lý, các phần phụ thuộc lười biếng, cổng và công cụ tài liệu.

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
cd "${HERMES_HOME:-$HOME/.hermes}/hermes-agent"
uv pip install -e ".[all,dev]"
scripts/run_tests.sh

Dự phòng bản sao thủ công (đối với các bản sao/CI dùng một lần mà bạn cố tình không muốn bố cục cài đặt được quản lý):

Tạo venv bên ngoài cây nguồn nhân bản — một venv bên trong thư mục mà tác nhân vận hành từ đó có thể bị xóa bằng lệnh đường dẫn tương đối mà tác nhân chạy dựa trên quá trình kiểm tra của chính nó, phá hủy thời gian chạy đang chạy giữa phiên.

curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv ~/.hermes/venvs/hermes-dev --python 3.11
source ~/.hermes/venvs/hermes-dev/bin/activate
uv pip install -e ".[all,dev]"
scripts/run_tests.sh

---

cộng đồng

• 💬 Bất hòa
• 📚 Trung tâm kỹ năng
• 🐛 vấn đề
• 🔌 máy tính-sử dụng-linux — Máy chủ MCP điều khiển máy tính để bàn Linux dành cho Hermes và các máy chủ MCP khác, với cây khả năng truy cập AT-SPI, đầu vào Wayland/X11, ảnh chụp màn hình và nhắm mục tiêu cửa sổ bộ tổng hợp.
• 🔌 HermesClaw — Cầu WeChat cộng đồng: Chạy Hermes Agent và OpenClaw trên cùng một tài khoản WeChat.

---

Giấy phép

MIT - xem GIẤY PHÉP.

Được xây dựng bởi Nghiên cứu Nous.