免費解鎖 Claude 同款三欄工作區：Hermes WebUI 自託管指南（2026）

簡介

Claude 網頁版把許多進階使用者離不開的版面做對了：左側歷史紀錄、中間對話、右側 Artifacts／檔案。問題在於每月 20 美元訂閱與工作階段速率限制——日常聊天夠用，對 agent、工具迴圈與每日研究卻很吃力。

Hermes WebUI（截至 2026 年 GitHub 星標 1 萬+）是 Hermes Agent（Nous Research 自進化 agent 執行環境）的社群網頁前端。你不必改寫 agent 程式碼，只要執行一條 Docker 指令（或 docker compose up），就能取得深色三欄介面、即時工具呼叫卡片，以及比純終端機更接近 Claude 產品體驗的 Workspace 檔案瀏覽器。

本指南是實戰型 Hermes WebUI 教學，適合想要自託管 AI 聊天介面與Claude 同款開源 UI、又不想按席位付費 SaaS 的讀者。內容涵蓋架構、安裝、安全與六個常見避坑。

若你已在其他地方執行 agent，可對照我們的 OpenClaw 多代理路由指南——Hermes 甚至內建 hermes claw migrate 協助 OpenClaw 使用者遷移。

Hermes WebUI 是什麼（以及不是什麼）

Hermes WebUI 不是託管的 Claude API 複製品。你透過 hermes model 自備模型金鑰（Anthropic、OpenRouter、Nous Portal、本機端點等），彈性與 CLI 相同，文件見 hermes-agent.nousresearch.com/docs。

符合「Claude 工作區」心智模型的介面功能

三欄版面

深色模式與工具透明度

不像單純聊天气泡，Hermes WebUI 會即時展開工具呼叫——Shell 指令、檔案編輯、搜尋——以卡片呈現，無需翻日誌。這也是 Claude 進階使用者偏好網頁版而非純 API 腳本的原因。

Workspace 檔案瀏覽器

右欄對應你掛載的 /workspace 目錄（主機路徑可設定）。agent 寫入圖表、程式或報告時，瀏覽器立即顯示——比 ChatGPT 單一對話串更接近 Claude Artifacts 加專案檔案。

官方示範與截圖：Hermes WebUI GitHub 與 社群示範站。

Claude／ChatGPT 網頁版 vs Hermes WebUI（決策矩陣）

建議路徑：

• 若只需偶爾聊天且重視零維運 → 繼續使用 Claude／ChatGPT。
• 若常觸及限制、需要大量檔案型 agent 工作，或希望Telegram + 網頁共用同一 agent → 選 Hermes Agent + WebUI。
• 若從 OpenClaw 遷移 → 執行 hermes claw migrate 後掛上 WebUI（見 Hermes 文件）。

前置需求

在 Apple Silicon Mac 上，bind mount 應使用真實 UID（id -u——常為 501，而非 1000）。下方 Docker 範例已明確設定 WANTED_UID／WANTED_GID。

逐步教學：Docker 安裝（快速路徑）

步驟 1 — 安裝 Hermes Agent 設定（僅首次）

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash source ~/.bashrc # 或 ~/.zshrc hermes setup # 精靈：模型供應商 + API 金鑰

若僅使用 all-in-one WebUI 映像且已有 ~/.hermes，可略過。

步驟 2 — 拉取 WebUI 映像

docker pull ghcr.io/nesquena/hermes-webui:latest

步驟 3 — 執行單一容器（官方一行指令）

docker run -d \ -e WANTED_UID=$(id -u) -e WANTED_GID=$(id -g) \ -v ~/.hermes:/home/hermeswebui/.hermes \ -e HERMES_WEBUI_STATE_DIR=/home/hermeswebui/.hermes/webui \ -v ~/workspace:/workspace \ -p 127.0.0.1:8787:8787 \ ghcr.io/nesquena/hermes-webui:latest

開啟 http://localhost:8787。

步驟 4 — 在 UI 或 CLI 設定模型

hermes model # 例如 anthropic:claude-sonnet-4-6 或 openrouter 路由

WebUI 會讀取掛載 volume 中的 ~/.hermes/config.yaml。

步驟 5 — 安全的遠端存取（選用）

預設僅綁定本機（127.0.0.1:8787）。若使用 VPS：

# 伺服器端：在 compose/.env 設定 HERMES_WEBUI_PASSWORD，僅在反向代理後綁定 0.0.0.0 ssh -N -L 8787:127.0.0.1:8787 user@your-server

然後在本機瀏覽 http://localhost:8787。無頭 Mac／Linux 主機的 SSH 基礎，請參考我們的 Mac mini M4 SSH 遠端連線指南。

步驟 6 — Docker Compose（正式環境）

git clone https://github.com/nesquena/hermes-webui cd hermes-webui cp .env.docker.example .env # macOS 上視需要修正 UID/GID docker compose up -d

雙容器（agent + UI）與升級說明見 repo 內 docs/docker.md。

步驟 7 — Agent 與 UI 冒煙測試

在中欄輸入：「列出 workspace 中的檔案並建立 hello.md。」 確認右欄更新，且 Shell／檔案工具出現工具卡片。

架構：WebUI 如何與 agent 通訊

瀏覽器 (:8787)
    │
    ▼
Hermes WebUI (Node/React)
    │  WebSocket / HTTP API
    ▼
Hermes Agent 程序（工具、LLM、記憶）
    │
    ├── ~/.hermes/          （設定、工作階段、技能）
    └── ~/workspace/        （專案檔案 → 右欄）

你可對同一 ~/.hermes 狀態執行 CLI（hermes）、Gateway（hermes gateway） 與 WebUI——依裝置選擇介面。詳情：架構文件。

疑難排解

docker run 後 UI 空白或「無法連線」

現象：瀏覽器在 :8787 一直載入。

解法：查看容器日誌（docker logs <id>），確認埠對應，並確保 8787 未被佔用。Linux 可試 curl -s http://127.0.0.1:8787。

~/.hermes 掛載權限遭拒

現象：agent 啟動但設定遺失；模型列表為空。

解法：傳入與主機 id -u／id -g 相符的 WANTED_UID／WANTED_GID。macOS 使用者請編輯 compose 的 .env——預設常假設 UID 1000。

WebUI 顯示 workspace 但 agent 無回應

現象：聊天卡住、無串流。

解法：檢查 ~/.hermes/config.yaml 的 API 金鑰，在主機執行 hermes doctor，並確認供應商配額。先在終端機用 hermes 測試 CLI。

對外暴露埠卻未設密碼

現象：為區域網路存取而將綁定改為 0.0.0.0:8787。

解法：設定 HERMES_WEBUI_PASSWORD，並在前方加上 nginx／Caddy 與 TLS。切勿將裸 :8787 直接暴露於公網。

常見問題

Hermes WebUI 是進階 agent 使用者最接近免費、自託管的 Claude 同款三欄工作區：歷史、聊天與檔案同屏，加上透明工具卡片，Docker 可在數分鐘內於埠 8787啟動。

先執行官方 docker run，掛載 ~/.hermes 與 ~/workspace，用 hermes setup 設定模型，再以真實寫檔任務壓力測試。官方 repo：nesquena/hermes-webui · NousResearch/hermes-agent。