快速入門

安裝遇到困難？

點擊加入中文社區微信群，提問並獲取群內專家幫助。
如果您已經安裝了龍蝦 OpenClaw，或者國內常見的龍蝦版本，例如 QClaw、WorkBuddy、ArkClaw、AutoClaw，可以讓它讀文檔協助您配置，您自己不用懂任何技術細節。有兩種方式：
- 方式一（最簡單）：把中文社區網址 https://hermesagent.org.cn 發給它，讓它自己訪問並閱讀文檔。
- 方式二（更精準，推薦）：直接把下面這段話複製發給您的 Agent，它會自己完成配置：
```
請把這個 MCP server 加到你的配置裡：https://mcp.hermesagent.org.cn/v1 （Streamable HTTP，無需 API Key、無需登錄）。加完後用它幫我查 Hermes Agent 中文文檔來指導我完成安裝。
```
- 方式二配好後，Agent 就能按關鍵詞直接檢索並讀取 113 篇中文文檔的全文。
安裝過程中遇到問題時，也可以先詢問豆包、DeepSeek 等 AI 助手。

本指南將引導你完成安裝 Hermes Agent、配置大模型提供商，並與 Hermes Agent進行首次對話。

1. 安裝 Hermes Agent

類 Linux / macOS / WSL2

curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash

Windows 原生 PowerShell

irm https://res1.hermesagent.org.cn/install.ps1 | iex

什麼是 PowerShell？怎麼打開？

PowerShell 是 Windows 自帶的命令行程序，可以理解成“Windows 裡的終端”。
打開方式：按一下鍵盤左下角 Windows 鍵，輸入 PowerShell，然後點擊 Windows PowerShell 或 PowerShell。
如果你看到的是 Windows Terminal 也沒關係，只要裡面開的標籤頁是 PowerShell 即可。
不要把上面的命令粘貼到瀏覽器地址欄、資源管理器地址欄，或“運行”對話框裡。

Windows 用戶

最推薦：先安裝 WSL2，再在 WSL2 終端裡運行上面的 install.sh。
想直接在 PowerShell 裡安裝：運行上面的 install.ps1。
WSL2 是什麼？ 可以把它理解成“Windows 裡的 Linux 終端環境”。裝好以後，你可以在 Windows 電腦上直接打開 Ubuntu 終端，按 Linux 的方式安裝和運行 Hermes Agent。
詳細說明請看 Windows 安裝指南。

中國大陸網絡環境提示

當前頁的一鍵安裝命令已經由 Hermes Agent 中文社區 提供 國內鏡像加速，默認優先走國內可直連鏈路。

為了提高中國大陸用戶的安裝體驗，鏡像版安裝器默認精簡了部分國人不常用、或體積較大且經常受外網影響的可選功能，例如瀏覽器自動化、Chromium 下載、WhatsApp 橋接等。建議先完成核心安裝，確認 Hermes Agent 可以正常運行；之後可讓 Hermes Agent 自身補全這些能力。

如果你需要繼續處理 WSL 網絡、終端代理或手動鏡像配置，可參考：

WSL 安裝（中文）：Windows 10/11 安裝 WSL2 指南
WSL 網絡 / autoProxy（官方）：Microsoft Learn - Accessing network applications with WSL
Python / pip 鏡像說明：清華 TUNA - PyPI 鏡像幫助
Node.js / npm 鏡像說明：清華 TUNA - NodeJS Release 鏡像幫助 / npmmirror

安裝完成後：

類 Unix / WSL2

source ~/.bashrc   # 或：source ~/.zshrc

Windows PowerShell

# 關閉並重新打開 PowerShell 即可

如果你是第一次接觸 Windows 命令行，建議直接繼續看 Windows 安裝指南，裡面把：

什麼是 PowerShell
怎麼打開 PowerShell
什麼時候需要管理員 PowerShell
PowerShell 直裝的完整步驟

都拆開寫了。

2. 配置大模型提供商

安裝程序會自動為你配置 LLM 提供商。如需後續更改，可使用以下任一命令：

hermes model       # 選擇大語言模型提供商和模型
hermes tools       # 配置啟用哪些工具
hermes setup       # 或一次性完成全部配置

hermes model 會引導你選擇推理提供者：

提供者	是什麼	如何配置
Nous Portal	基於訂閱、零配置	通過 `hermes model` 進行 OAuth 登錄
OpenAI Codex	ChatGPT OAuth，使用 Codex 模型	通過 `hermes model` 進行設備碼認證
Anthropic	直接使用 Claude 模型（Pro/Max 或 API 密鑰）	使用 `hermes model` 進行 Claude Code 認證，或提供 Anthropic API 密鑰
OpenRouter	跨多種模型的多提供者路由	輸入你的 API 密鑰
Z.AI	GLM / Zhipu 託管模型	設置 `GLM_API_KEY` / `ZAI_API_KEY`
Kimi / Moonshot	Moonshot 託管的代碼與聊天模型	設置 `KIMI_API_KEY`
MiniMax	國際 MiniMax 接口	設置 `MINIMAX_API_KEY`
MiniMax 中國區	中國區域 MiniMax 接口	設置 `MINIMAX_CN_API_KEY`
阿里雲	通過 DashScope 使用 Qwen 模型	設置 `DASHSCOPE_API_KEY`
Hugging Face	通過統一路由使用 20+ 開源模型（Qwen、DeepSeek、Kimi 等）	設置 `HF_TOKEN`
Kilo Code	KiloCode 託管模型	設置 `KILOCODE_API_KEY`
OpenCode Zen	按使用量付費訪問精選模型	設置 `OPENCODE_ZEN_API_KEY`
OpenCode Go	每月 $10 訂閱，訪問開源模型	設置 `OPENCODE_GO_API_KEY`
DeepSeek	直接訪問 DeepSeek API	設置 `DEEPSEEK_API_KEY`
GitHub Copilot	GitHub Copilot 訂閱（GPT-5.x、Claude、Gemini 等）	通過 `hermes model` 進行 OAuth，或設置 `COPILOT_GITHUB_TOKEN` / `GH_TOKEN`
GitHub Copilot ACP	Copilot ACP Agent 後端（啟動本地 `copilot` CLI）	使用 `hermes model`（需安裝 `copilot` CLI 並執行 `copilot login`）
Vercel AI Gateway	Vercel AI Gateway 路由	設置 `AI_GATEWAY_API_KEY`
自定義端點	VLLM、SGLang、Ollama 或任何 OpenAI 兼容 API	設置基礎 URL + API 密鑰

提示

你可以隨時通過 hermes model 切換提供者——無需修改代碼，無鎖定風險。配置自定義端點時，Hermes 會提示你輸入上下文窗口大小，並在可能的情況下自動檢測。詳情請參見上下文長度檢測。

3. 開始對話

hermes

完成！你將看到包含模型信息、可用工具和技能的歡迎橫幅。輸入消息並按 Enter 鍵。

❯ 你現在能幫我做什麼？

該 Agent 已具備訪問網絡搜索、文件操作、終端命令等工具的能力——開箱即用。

4. 嘗試核心功能

讓它使用終端

❯ 幫我看看磁盤空間佔用情況，並列出最大的 5 個目錄。

Agent 將代表你執行終端命令，並顯示結果。

使用斜槓命令

輸入 / 可查看所有命令的自動補全下拉菜單：

命令	功能
`/help`	顯示所有可用命令
`/tools`	列出可用工具
`/model`	交互式切換模型
`/personality pirate`	嘗試有趣的個性模式
`/save`	保存對話

多行輸入

按 Alt+Enter 或 Ctrl+J 可換行。非常適合粘貼代碼或撰寫詳細提示。

中斷 Agent

如果 Agent 運行時間過長，只需輸入新消息並按 Enter——它將中斷當前任務並切換到你的新指令。Ctrl+C 也有效。

恢復會話

退出時，hermes 會打印出恢復命令：

hermes --continue    # 恢復最近一次會話
hermes -c            # 簡寫形式

5. 進一步探索

以下是一些你可以嘗試的進階操作：

設置沙箱終端

為確保安全，建議在 Docker 容器或遠程服務器上運行 Agent：

hermes config set terminal.backend docker    # 使用 Docker 隔離終端
hermes config set terminal.backend ssh       # 把終端切到遠程服務器

連接消息平臺

通過微信、飛書、電報、Discord、WhatsApp、Signal、電子郵件或 Home Assistant 從手機或其他設備與 Hermes 對話：

hermes gateway setup    # 交互式配置消息平臺

添加語音模式

希望在 CLI 中使用麥克風輸入，或在消息中獲得語音回覆？

pip install "hermes-agent[voice]"

# 可選，但推薦：啟用免費的本地語音轉文字
pip install faster-whisper

然後啟動 Hermes 並在 CLI 中啟用語音模式：

/voice on

按 Ctrl+B 開始錄音，或使用 /voice tts 讓 Hermes 朗讀其回覆。完整設置請參見語音模式，涵蓋 CLI、Telegram、Discord 及 Discord 語音頻道。

安排自動化任務

❯ 每天早上 9 點檢查 Hacker News 上的 AI 新聞，並通過電報給我發一份摘要。

Agent 將通過網關自動設置一個 cron 任務，定時運行。

瀏覽並安裝技能

hermes skills search kubernetes
hermes skills search react --source skills-sh
hermes skills search https://mintlify.com/docs --source well-known
hermes skills install openai/skills/k8s
hermes skills install official/security/1password
hermes skills install skills-sh/vercel-labs/json-render/json-render-react --force

提示：

使用 --source skills-sh 搜索公共的 skills.sh 目錄。
使用 --source well-known 並配合文檔/網站 URL，從 /.well-known/skills/index.json 發現技能。
僅在審查第三方技能後使用 --force。它可覆蓋非危險策略塊，但無法覆蓋 dangerous 掃描結論。

也可在聊天中使用 /skills 斜槓命令。

通過 ACP 在編輯器中使用 Hermes

Hermes 還可作為 ACP 服務器運行，兼容 VS Code、Zed 和 JetBrains 等 ACP 編輯器：

pip install -e '.[acp]'
hermes acp

有關設置詳情，請參閱 ACP 編輯器集成。

嘗試 MCP 服務器

通過模型上下文協議（Model Context Protocol）連接外部工具：

# 添加到 ~/.hermes/config.yaml
mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"

快速參考

命令	描述
`hermes`	開始聊天
`hermes model`	選擇你的大語言模型（LLM）提供商和模型
`hermes tools`	配置各平臺啟用的工具
`hermes setup`	完整設置嚮導（一次性配置所有內容）
`hermes doctor`	診斷問題
`hermes update`	更新至最新版本
`hermes gateway`	啟動消息網關
`hermes --continue`	恢復上次會話

下一步

CLI 指南 — 掌握終端界面
配置 — 自定義你的設置
消息網關 — 連接微信、飛書、電報、Discord、WhatsApp、Signal、電子郵件或 Home Assistant
工具與工具集 — 探索可用功能

1. 安裝 Hermes Agent​

類 Linux / macOS / WSL2​

Windows 原生 PowerShell​

類 Unix / WSL2​

Windows PowerShell​

2. 配置大模型提供商​

3. 開始對話​

4. 嘗試核心功能​

讓它使用終端​

使用斜槓命令​

多行輸入​

中斷 Agent​

恢復會話​

5. 進一步探索​

設置沙箱終端​

連接消息平臺​

添加語音模式​

安排自動化任務​

瀏覽並安裝技能​

通過 ACP 在編輯器中使用 Hermes​

嘗試 MCP 服務器​

快速參考​

下一步​