常见问题(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 搜索。如仍未找到,可通过官方渠道反馈(具体入口以官网为准)。