LightVela

配置模型

接入和管理 Hermes 使用的大語言模型。

本頁介紹如何為 Hermes Agent 配置大語言模型，包含三種配置方式的差異、API Key 的獲取方式、管理台配置步驟、支持的模型列表以及選型建議。

本頁覆蓋

  • 三種配置方式的差異（Coding Plan / API / 自定義模型）

  • API Key 的獲取方式

  • 管理台配置步驟

  • 模型切換

  • 支持的模型

  • 模型選型建議

三種配置方式

管理台「模型」卡片第一級下拉提供三個選項：

方式計費模式API Key 來源適用場景
模型 Coding Plan包月/包年服務商高頻使用
模型 API按量服務商低頻或試用
自定義模型取決於端點用户自備接入國外模型或 OpenAI 兼容端點

獲取 API Key 的通用流程

各服務商的界面不同，但流程一致：

  1. 訪問服務商官網：在管理台模型卡片選中某個模型後，下方顯示「點擊獲取 API KEY」外鏈，點擊可直達該服務商官網

  2. 註冊或登錄賬號：多數國內平台支持微信或手機號登錄

  3. 完成實名認證：國內模型服務商普遍要求實名認證後方可調用 API

  4. 進入 API Key 管理頁：通常位於"控制台 → API 管理 / 密鑰管理 / 訪問憑證"

  5. 創建新 Key：為 Key 命名（如 LightVela），創建後立即複製。多數平台只在創建時顯示一次

  6. 回到 LightVela 粘貼 Key

在管理台配置

進入管理台，打開「模型」按鍵。

配置步驟

  1. 選擇來源（第一級下拉）：模型 API / 模型 Coding Plan / 自定義模型

  2. 選擇具體模型（第二級下拉）：根據上一步的來源顯示可用列表

  3. 填入 API Key：粘貼已獲取的 Key。右側眼睛圖標可切換顯示狀態

  4. 點擊「添加為默認」

  5. 下方「當前模型」列表出現對應記錄即表示配置成功

自定義模型的附加字段

選擇「自定義模型」時，除 API Key 外通常還需填寫：

  • Base URL：模型服務的 API 地址，例如 https://api.openai.com/v1

  • Model Name：模型標識，例如 gpt-4o、claude-3-5-sonnet-20241022

具體字段以管理台界面為準。

切換模型

切換方式

重新執行配置步驟，新的「添加為默認」將覆蓋原有配置。

切換對記憶的影響

切換模型不會影響對話記憶。記憶為 Hermes Agent 自身數據，模型僅負責生成響應。

支持的模型

模型 Coding Plan（包月）

名稱服務商
智譜 AI（GLM 國際–Coding Plan）智譜 AI
Kimi Coding PlanMoonshot AI
小米 Token Plan小米
百鍊 Coding Plan阿里雲百鍊
火山引擎方舟 Coding Plan火山引擎（字節）

模型 API（按量）

名稱服務商
OpenAIOpenAI
AnthropicAnthropic
Google GeminiGoogle
OpenRouterOpenRouter
深度求索（DeepSeek）深度求索
百鍊（千問）阿里
MiniMax（國際）MiniMax
Moonshot AI（Kimi 國際）Moonshot
智譜 AI（GLM 國際）智譜
火山引擎（豆包）字節
小米 MiMo小米

自定義模型

任何兼容 OpenAI Chat Completions 協議的端點均可接入，包括：

  • 自建模型：vLLM、Ollama、LM Studio 等暴露 OpenAI 兼容端點的服務

  • 聚合平台：OpenRouter 等

選型參考

不同關注點對應的選型方向：

關注點參考方向
免費額度多數服務商新賬號提供免費額度，可先行試用
長文本處理選擇上下文長度大的模型（如 Moonshot AI）
響應速度不同服務商差異較大，以實際體驗為準
中文理解中國模型對中文支持普遍更好
高頻使用選擇對應服務商的 Coding Plan 包月套餐

建議：先通過啓航套餐的體驗積分進行若干輪對話，確認 Hermes Agent 工作正常後再決定模型選型。

常見問題

現象可能原因處理方式
填入 Key 後「當前模型」仍為空Key 格式錯誤或含空格重新複製粘貼，確認首尾無空格
消息發送後長時間無響應服務商餘額不足或 Key 被禁用在服務商控制台檢查餘額與 Key 狀態
響應內容為亂碼或無意義自定義模型端點不符合 OpenAI 協議先用其他 OpenAI 兼容客户端驗證端點可用性
提示"模型響應超時"服務商限流或網絡波動稍後重試，或切換其他服務商
不確定自定義模型的 Base URL—查閲對應服務的 API 文檔，通常為 https://xxx.com/v1

對話報錯「HTTP 401:InvalidAuthentication」或類似 401 報錯

在與 OpenClaw 對話過程中，如果出現 HTTP 401:InvalidAuthentication 或其他 401 xxx 報錯提示，通常由以下原因導致：

  1. 模型的 API Key 配置錯誤；

  2. 錯誤混淆了 Coding Plan 和普通模型的 API Key；

  3. 錯誤選擇了模型服務商提供的國內版和國際版。

遇到該問題時，建議再次檢查模型配置。

下一步

配置總覽

LightVela 管理台配置流程。

Telegram

通過 Telegram 與 Hermes Agent 對話。

本頁目錄

本頁覆蓋三種配置方式獲取 API Key 的通用流程在管理台配置配置步驟自定義模型的附加字段切換模型切換方式切換對記憶的影響支持的模型模型 Coding Plan（包月）模型 API（按量）自定義模型選型參考常見問題對話報錯「HTTP 401:InvalidAuthentication」或類似 401 報錯下一步