常见问题(FAQ)

本页汇总使用 LightVela 过程中的常见问题。建议先使用 Cmd/Ctrl + F 搜索关键词。如未找到答案,可在 快速开始配置总览 或具体配置子页的「常见问题」小节中进一步查找。

如需了解敏感信息、账号凭据、金融信息、健康信息和商业机密等内容的使用边界,请参见 安全使用 LightVela

---

账号与登录

为何仅支持 Google 和 GitHub 登录?

LightVela 主要服务国际用户,Google / GitHub一键登录覆盖面最广,暂未规划手机号登录。

同一用户能否用 Google 和 GitHub 各登录一次?

可以,但会是两个独立账号,Hermes、对话记忆、套餐状态均不互通。建议固定使用一种登录方式。

如何退出登录

点击右上角头像,选择「退出登录」;或进入账号信息页,在「账号基本信息」卡片中点击退出按钮。退出后账号数据保留,下次登录即可继续使用。

---

启航套餐与体验积分

启航套餐包含什么

套餐内容与配额详见 LightVela 是什么 - 关于套餐

「100 体验积分」的含义

启航套餐预置的模型调用额度。无需自行准备 API Key 即可使用——创建 Hermes、接入通道后发起的对话将消耗此额度。

积分耗尽后如何处理

积分耗尽后,消息将无法得到模型响应。需在「模型」卡片配置自有 API Key,详见 配置模型

积分是否支持充值

当前不支持单独充值积分,持续使用需配置自有 API Key。

启航套餐是否永久免费

当前为限时免费,政策调整时将提前通知。

一个账号是否只能创建 1 个 Hermes

启航套餐限制为 1 个,巡游、远航套餐即将上线。

巡游 / 远航何时上线

具体时间以官方动态为准。

---

模型相关

如何获取 API Key

在管理台「模型」卡片选中某个服务商后,下方显示「点击获取 API KEY」外链,点击可直达该服务商官网的注册与 Key 管理页。详见 配置模型

如何选择模型

详见 配置模型 - 选型参考

能否使用 Deepseek / Kimi 等中国模型

可以,通过「自定义模型」接入,需自备可访问的 Deepseek 兼容端点。

消息发送后 Hermes 无响应的排查方式

按以下顺序检查:

  • 管理台「已接入通道」是否有记录
  • 若使用自有模型:「当前模型」是否有记录、服务商余额是否充足
  • 若使用体验积分:积分是否耗尽
  • Key 是否在服务商后台被禁用

切换模型是否会丢失对话记忆

不会。对话记忆为 Hermes 自身数据,模型仅负责生成响应。

能否同时配置多个模型

当前版本不支持。每个 Hermes 仅能生效一个模型。如需对比不同模型表现,需创建多个 Hermes(启航套餐仅支持 1 个)。

---

通道相关

WeChat、Telegram、WhatsApp、Discord 能否同时接入

可以。多个通道指向同一个 Hermes 实例,共享记忆与 Agent 行为。

能否将机器人添加至 WeChat 群

当前不支持。WeChat 通道仅支持 1 对 1 对话。

更换手机或 Google / GitHub 号后的影响

账号基于 Google / GitHub OpenID 识别,更换号即视为新账号,数据不迁移。如需保留数据,请继续使用原账号登录。

如何解除已接入的通道

在管理台「已接入通道」列表中删除对应条目。解除后,该聊天平台中的机器人将失效。

---

对话与记忆

单条消息能否删除

当前不支持单条删除。如需清除记忆,需删除整个 Hermes 实例。

删除 Hermes 后能否恢复

不能。删除为不可逆操作,对话、通道绑定、已安装技能均会一并清除。

---

技能相关

安装技能后是否需要触发词

不需要。使用自然语言描述需求即可,Hermes 自动判断是否调用技能。

如何卸载技能

当前 LightVela 管理台暂不支持面板卸载,可通过对话方式让 Hermes 代为删除。详见 配置技能 - 删除已安装的技能

技能是否额外收费

取决于技能作者。SkillHub 上架的多数技能免费,部分技能可能调用外部付费服务(消耗自有 API 额度),详见技能详情页说明。

能否自行开发技能上架

开发者上架能力规划中,当前仅可使用已上架技能。

---

故障排查

创建 Hermes 长时间停留在过渡页

可能为云端初始化慢或网络波动。建议:

  • 等待 1 分钟
  • 仍无响应则刷新页面
  • 再无响应则重新点击「+ 创建 Hermes」

扫码后管理台无响应

可能为授权未完成或网络延迟。关闭弹窗重新点击「授权接入」生成新二维码。

机器人完全无响应的排查顺序

检查项方法
通道状态「已接入通道」列表是否仍在
体验积分是否耗尽
模型状态(若使用自有模型)「当前模型」是否有记录
Key 状态(若使用自有模型)在服务商后台确认余额与 Key 状态
网络浏览器是否能正常打开 LightVela

回复内容为乱码或无意义

多数情况下为自定义模型的端点不符合 OpenAI 协议。建议先使用其他 OpenAI 兼容客户端验证端点可用性。

提示「模型响应超时」

服务商限流或网络波动。稍后重试,或切换其他服务商。

如何重建 Hermes

删除当前 Hermes 后重新点击「+ 创建 Hermes」,所有数据将清零。

---

迁移与兼容

能否导出数据

当前管理台暂未开放数据导出功能。

能否在多设备登录

可以。同一账号在任意设备登录后均可访问相同数据。

---

其他

本文档未涵盖的问题

建议先使用 Cmd/Ctrl + F 搜索。如仍未找到,可通过官方渠道反馈(具体入口以官网为准)。