第六章:驗證安裝與常見錯誤 — hermes status、連線測試、Proxy/憑證問題

遇到錯誤訊息先別慌!喝口茶,拍拍胸脯。在工程師的世界裡,沒有什麼是重開機不能解決的;如果不行,那就看這份求生指南!😎

身為一個剛上任的 AI 管家,Hermes 偶爾也會有些水土不服。可能是網路塞車、可能是鑰匙(API Key)拿錯了,甚至是公司內網的防火牆把它擋在門外。別擔心,這一章我們將傳授你幾招「抓蟲術」,讓你從除錯菜鳥晉升為通靈大師。

🩺 第一步:全身健康檢查

在開始盲目亂調設定之前,我們先讓管家自己做個健康檢查。Hermes 內建了非常強大的診斷工具,就像醫生的聽診器一樣,能瞬間找出病因。

當你覺得系統怪怪的,請毫不猶豫地祭出法寶:hermes status。這會列出所有模組目前的狀態。只要看到滿滿的「綠燈 (OK)」,就代表它健康得很;如果看到「紅燈 (Error)」,那就是我們今天要對付的敵人!

🐛 常見的「蟲蟲危機」與解法

根據歷代玩家的血淚經驗,我們整理了最常出現的「踩坑排行榜」:

1. 網路連線超時 (Timeout Error)

症狀:下達指令後,管家像石化了一樣,幾分鐘後吐出一句 “Connection timeout”。 解法:先確認你的網路是不是斷了。如果網路正常,通常是因為模型供應商的伺服器太忙碌。你可以喝口水再試一次,或是去設定檔(config.yaml)裡把 timeout 的時間調長一點。

2. 認證失敗 / API Key 錯誤 (Unauthorized / 401 Error)

症狀:管家委屈地說 “Invalid API Key” 或 “Unauthorized”。 解法:99% 的機率是你把鑰匙複製錯了!請回去你的模型供應商後台,重新複製一次 API Key,並確認你沒有不小心複製到頭尾的空白鍵。這點小細節可是會讓管家吃閉門羹的。

3. 公司網路的逆襲:Proxy 與憑證問題 (SSL / Proxy Error)

症狀:在公司電腦上執行,一直跳出 SSL 憑證錯誤,或是根本連不上外網。 解法:公司 IT 部門的防火牆可是很嚴格的!你需要設定 Proxy 才能讓管家順利翻牆。你可以透過設定環境變數 HTTP_PROXYHTTPS_PROXY 來解決。如果遇到憑證錯誤,可以在環境變數加入 NODE_TLS_REJECT_UNAUTHORIZED=0 來暫時忽略(但請注意安全風險喔!)。


🛠️ 指令教學:成為除錯大師

遇到問題不再只能雙手抱頭!我們來練習 3 個能幫你快速釐清狀況的實用指令。

介紹指令:hermes status 與網路除錯技巧

💡 應用練習例子

練習 1:叫管家出來量體溫 無論遇到什麼怪事,先跑這行指令就對了:

hermes status

幽默小提示:仔細看輸出的結果。如果發現是 Providers 亮紅燈,恭喜你,直接去檢查你的 API Key 吧!

練習 2:進行網路連線測試(Ping 測試) 懷疑是網路或模型供應商當機?你可以單獨對 Providers 進行連線測試:

hermes status --check-providers

這就像是撥電話給 OpenAI 或 Anthropic 的總機小姐,確認他們的電話線是不是被老鼠咬斷了。如果電話有通,就代表網路沒問題!

練習 3:加上 Proxy 變數執行 如果你在公司內網,可以練習加上 Proxy 環境變數來啟動對話(請將網址換成貴公司的實際設定):

HTTP_PROXY="http://proxy.yourcompany.com:8080" HTTPS_PROXY="http://proxy.yourcompany.com:8080" hermes chat

看!這就像是給了管家一張「公司通行證」,讓他可以順利穿過公司的防火牆去外網幫你辦事!


🎉 第一部份完結撒花! 克服了安裝與除錯的難關,你現在已經為 Hermes Agent 打下了最堅實的基礎!這就像是蓋房子打好了地基。接下來的【第二部份:核心操作】,我們將開始教你如何指揮管家使用各種酷炫的工具(例如控制瀏覽器、操作終端機),真正釋放它的強大潛力。準備好迎接震撼教育了嗎?我們第七章見!🚀