什麼是開放之手？
OpenHands 是一個開源軟體開發代理，可與儲存庫、終端機、瀏覽器和可配置語言模型一起使用。
此 OpenHands 設定透過進階 LLM 設定保存 TokenHub 支援的 LLM 設定檔。使用 OpenAI 前綴的 LiteLLM 模型名稱，並在允許變更之前在新對話中驗證只讀任務。 OpenHands 透過 LiteLLM 路由自訂模型，這就是為什麼自訂模型值包含 OpenAI 提供者前綴以及確切的 TokenHub 模型 ID。儲存的 LLM 設定可能不會取代現有對話的設定文件，因此在允許終端或檔案變更之前建立新會話並驗證儲存庫讀取。
OpenHands透過LiteLLM解析自訂模型。重要的一步不僅僅是選擇“OpenAI”，而是在官方 Advanced LLM Settings 中輸入具有提供者資格的 Custom Model。對於 TokenHub，請使用 openai/YOUR_TOKENHUB_MODEL_ID。
開啟高級 LLM 設定
- 在OpenHands中開啟LLM Settings。
- 開啟Advanced。官方的 Custom Model、Base URL 和 API Key 欄位僅出現在進階設定中。
- 在Custom Model中輸入
openai/YOUR_TOKENHUB_MODEL_ID。 - 在Base URL中輸入
https://us-api.tokenhub.com/v1。 - 在 API Key 中輸入您的 TokenHub API 金鑰。
- 按一下“Save Changes”。
openai/ 前綴告訴 LiteLLM 使用其 OpenAI-compatible 路由。發送到TokenHub的型號ID仍然是斜線後的值。裸 ID 無法可靠地告訴 OpenHands 使用哪個 LiteLLM 提供者。
儲存後開始新對話
OpenHands 記錄 LLM 設定預設應用於 new conversations。如果必須使用新模型，請重新啟動現有對話。對於首次連接測試，請建立一個新對話，以便舊的 LLM 設定檔不會影響結果。
按以下順序測試新對話：
- 要求 OpenHands 讀取並解釋一個檔案而不修改它。
- 檢查TokenHub日誌中的型號ID、狀態碼和
/v1/chat/completions路徑。 - 然後要求它執行一項明確的、可逆的檔案編輯或終端命令。
OpenHands 也警告說，它需要一個有能力的模型。如果普通聊天成功，但代理在工具步驟停滯，則模型可能缺乏可靠的工具呼叫；這並不一定意味著 Base URL 丟失了。
逐一欄位排除故障
Model not found或 LiteLLM 路由錯誤：確認 Custom Model 是openai/EXACT_MODEL_ID。- 401：再次儲存API Key，且不包含
Bearer前綴。 - 404：Base URL 應該以
/v1結尾，而不是/chat/completions。 - 請求仍然使用舊模型：重新啟動對話或建立新對話。
- 文本有效，但工具无效：选择具有记录的本机函数调用的 TokenHub 模型。
官方參考
如何選擇推薦模型？
OpenHands 客製化 LLM 常見問題解答
如何在 OpenHands 中配置自訂 LLM？
開啟設定 → LLM → 高級，將自訂模型設定為 openai/<TokenHub 模型 ID>，然後輸入 TokenHub /v1 基本 URL 和 API 金鑰。
為什麼 OpenHands 模型需要 openai/ 前綴？
OpenHands 使用 LiteLLM 路由。該前綴告訴 LiteLLM 透過 OpenAI 相容傳輸發送確切的後續模型 ID。
為什麼現有的 OpenHands 對話保留舊模型？
儲存的 LLM 設定可能不會取代現有的對話設定檔。開始或重新啟動對話並檢查活動的 LLM 個人資料。
哪些型號適合 OpenHands？
使用具有可靠的本機工具呼叫和足夠的任務上下文的編碼模型。僅聊天的模型無法可靠地操作終端、瀏覽器和文件工具。
我應該如何安全地測試 OpenHands？
使用測試儲存庫並從唯讀解釋或搜尋開始。檢查 TokenHub 日誌，然後逐漸允許檔案變更和命令。
參考資料
本頁設定依據 TokenHub 教學與官方資料，最後驗證日期為 2026-09-08。