# Hermes Agent Docker 安裝指南

### 按照本指南前置條件：
- Docker
- 有 [openroute](https://openrouter.ai/) api key（有先儲值 credits）
- 有 Discord 帳號

官方文件：https://hermes-agent.nousresearch.com/docs/user-guide/docker

## 開啟終端機，執行以下步驟：
1. 建立資料夾 `mkdir -p ~/.hermes`
2. 拉取官方 image，跑安裝及設定 `docker run -it --rm \
-v ~/.hermes:/opt/data \
nousresearch/hermes-agent setup`
- 安裝完畢後，選擇 Quick setup
- 選擇 AI Provider，我使用的是 [OpenRouter](https://openrouter.ai/)，可自由選擇自己有的 Provider：
- 複製貼上 Key 後 Enter
- 選擇模型，可以看價目表選擇自己喜歡的，我是選擇 `qwen/qwen3.6-35b-a3b`
- 選 `Keep current（local）`
- 設定 message 平台，選 `Set up messaging now`
- 輸入你想串接的代號並 Enter，我自己是用 Discord，Enter 後它會勾起來，再繼續 Enter
- 接下來要申請 Discord bot，到這個地方登入自己的 Discord 帳號：https://discord.com/developers/home ，並建立一台自己的 Hermes Agent Bot
- 左側導覽列選擇「機器人」，右側捲動至如圖處，將三個開關都打開
- 往上捲動到「權杖」，點擊「重設權杖」，進行驗證後會得到 token，複製貼上到終端機
- 到 Discord 中可以建立一個自己的私人伺服器，在右側列表對自己按右鍵，點擊複製使用者 ID，然後貼到終端機
- 回到 Discord 開發者平台，左側選單選擇「OAuth2」，如圖勾選 bot，再往下捲動勾選如圖權限（如果之後有特殊要求也可以回來這裡勾選你要的權限，再重新讓 Bot 加入伺服器）
- 往下捲動至 URL 處，點擊右側複製，另開新分頁貼上，讓機器人加入你的伺服器
- 在伺服器找到 Bot，私訊他（現在他還不會理你）
- 在左側列表對他按右鍵，點擊複製頻道 ID，貼到終端機
- 現在已經設定好了，輸入 n 退出
- 接下來輸入這個指令讓他開啟 gateway 模式 `docker run -d \
--name hermes \
--restart unless-stopped \
--memory=4g --cpus=2 \
--shm-size=1g \
-v ~/.hermes:/opt/data \
-p 8642:8642 \
nousresearch/hermes-agent gateway run`
- 輸入這個指令看有沒有成功運作 `docker logs hermes --tail 20`
- 到 Discord 上面私訊他，有成功的話他會對你的訊息按 :eyes: ，然後回應你之後 :white_check_mark:
- 接著參考這個 [workaround](https://github.com/NousResearch/hermes-agent/issues/15697#issuecomment-4362644216)（感謝強者我朋友 clode 大神） 讓 hermes 可以在 docker 內部使用瀏覽器
~~- 接下來用這個指令拿 playwright 安裝 chromium `docker exec hermes /opt/hermes/node_modules/.bin/playwright install chromium`~~
~~- 安裝後 `docker restart hermes`~~
~~- 給他你想要讓他看的網頁，跟他說你有用 `docker exec hermes /opt/hermes/node_modules/.bin/playwright install chromium` 這個指令安裝 chromium，叫他用瀏覽器看而不是用 curl 呼叫，不過這裡可能需要看點運氣...觀察他是不是真的用瀏覽器開，如果不是打斷他~~
- 接下來就自由運用吧！！

### 額外 mermer
~~有跟朋友研究一晚上，官方 [docker file](https://github.com/NousResearch/hermes-agent/blob/af981227937f54ccd621673f1e86ee196134a005/Dockerfile#L53) 有使用`npx playwright install --with-deps chromium --only-shell` 這個指令安裝 chromium，但是實際啟動的時候叫 hermes 用瀏覽器開他會說環境沒有瀏覽器，所以才使用 `docker exec hermes /opt/hermes/node_modules/.bin/playwright install chromium` 這個指令裝，至於 hermes 找不到瀏覽器是目前已知的 bug ，社群上有人在嘗試修復這個問題，但總而言之我是使用上面的指令裝完才能用...有興趣的人可以自己看看~~