LightVela
配置指南

配置模型

本页介绍如何为 Hermes 配置大语言模型，包含三种配置方式的差异、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 自身数据，模型仅负责生成响应。

支持的模型

模型 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 工作正常后再决定模型选型。

常见问题

现象可能原因处理方式
填入 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. 错误选择了模型服务商提供的国内版和国际版。

遇到该问题时，建议再次检查模型配置。

下一步

配置总览

WeChat

本页目录

本页覆盖三种配置方式获取 API Key 的通用流程在管理台配置配置步骤自定义模型的附加字段切换模型切换方式切换对记忆的影响支持的模型模型 Coding Plan（包月）模型 API（按量）自定义模型选型参考常见问题对话报错「HTTP 401:InvalidAuthentication」或类似 401 报错下一步