常见问题 FAQ
LightVela 常见问题。
常见问题（FAQ）
本页汇总使用 LightVela 过程中的常见问题。建议先使用 Cmd/Ctrl + F 搜索关键词。如未找到答案，可在 快速开始、配置总览 或具体配置子页的「常见问题」小节中进一步查找。
账号与登录
为何仅支持 QQ 和微信登录？
LightVela 主要服务国内用户，QQ / 微信一键登录覆盖面最广，暂未规划手机号登录。
同一用户能否用 QQ 和微信各登录一次？
可以，但会是两个独立账号，Hermes、对话记忆、套餐状态均不互通。建议固定使用一种登录方式。
如何退出登录
点击右上角头像，选择「退出登录」；或进入账号信息页，在「账号基本信息」卡片中点击退出按钮。退出后账号数据保留，下次登录即可继续使用。
实名认证
为什么要实名认证
实名认证用于符合国内 SaaS 服务的合规要求。首次开通任意套餐前必须完成实名。
实名认证何时触发
登录后浏览首页、阅读文档不需要实名。首次点击「立即开通」领取套餐时，若账号未认证，页面顶部会出现提示条，引导前往账号信息页完成认证。
实名信息如何保管
姓名和身份证号加密传输并存储，平台仅保留脱敏信息用于展示，认证信息不会用于其他用途。
支持哪些证件类型
当前仅支持中国大陆居民身份证，其他证件类型暂未开放。
实名是否需要每次开通套餐都做一次
不需要。认证为一次性操作，完成后开通任意套餐、购买 LightVela 其他产品均无需重复认证。
实名后能否修改实名信息
可以。进入账号页，在实名认证一行点击「修改」重新提交真实姓名和身份证号。新信息通过核验后会覆盖当前实名信息，后台保留变更记录。
实名后能否修改账号显示名或 Hermes 名字
可以。实名认证绑定的是真实姓名和身份证号，与账号显示名、Hermes 实例名称无关，后两者可在对应页面随时修改。
认证失败如何处理
| 现象 | 可能原因 | 处理方式 |
|---|---|---|
| 提示姓名与身份证号不匹配 | 填写错误 | 核对后重新提交 |
| 提交后长时间无响应 | 网络波动或后台繁忙 | 稍后重试 |
启航套餐与体验积分
启航套餐包含什么
套餐内容与配额详见 LightVela 是什么 - 关于套餐。
「100 体验积分」的含义
启航套餐预置的模型调用额度。无需自行准备 API Key 即可使用——创建 Hermes、接入通道后发起的对话将消耗此额度。
积分耗尽后如何处理
积分耗尽后，消息将无法得到模型响应。需在「模型」卡片配置自有 API Key，详见 配置模型。
积分是否支持充值
当前不支持单独充值积分，持续使用需配置自有 API Key。
启航套餐是否永久免费
当前为限时免费，政策调整时将提前通知。
一个账号是否只能创建 1 个 Hermes
启航套餐限制为 1 个，巡游、远航套餐即将上线。
巡游 / 远航何时上线
具体时间以官方动态为准。
模型相关
如何获取 API Key
在管理台「模型」卡片选中某个服务商后，下方显示「点击获取 API KEY」外链，点击可直达该服务商官网的注册与 Key 管理页。详见 配置模型。
如何选择模型
详见 配置模型 - 选型参考。
能否使用 Claude / GPT / Gemini
可以，通过「自定义模型」接入，需自备可访问的 OpenAI 兼容端点。
消息发送后 Hermes 无响应的排查方式
按以下顺序检查：
-
管理台「已接入通道」是否有记录
-
若使用自有模型：「当前模型」是否有记录、服务商余额是否充足
-
若使用体验积分：积分是否耗尽
-
Key 是否在服务商后台被禁用
切换模型是否会丢失对话记忆
不会。对话记忆为 Hermes 自身数据，模型仅负责生成响应。
能否同时配置多个模型
当前版本不支持。每个 Hermes 仅能生效一个模型。如需对比不同模型表现，需创建多个 Hermes（启航套餐仅支持 1 个）。
通道相关
微信、飞书、QQ 能否同时接入
可以。多个通道指向同一个 Hermes 实例，共享记忆与 Agent 行为。
是否支持企业微信
当前仅支持个人微信，企业微信暂未规划。
能否将机器人添加至微信群
当前不支持。微信通道仅支持 1 对 1 对话。
更换手机或 QQ / 微信号后的影响
账号基于 QQ / 微信 OpenID 识别，更换号即视为新账号，数据不迁移。如需保留数据，请继续使用原账号登录。
如何解除已接入的通道
在管理台「已接入通道」列表中删除对应条目。解除后，该聊天平台中的机器人将失效。
QQ 机器人是否需要自行注册
是的。需在 QQ 开放平台 创建机器人，获取 AppID 与 AppSecret 后填回 LightVela。详见 配置通道 - QQ。
对话与记忆
单条消息能否删除
当前不支持单条删除。如需清除记忆，需删除整个 Hermes 实例。
删除 Hermes 后能否恢复
不能。删除为不可逆操作，对话、通道绑定、已安装技能均会一并清除。
技能相关
安装技能后是否需要触发词
不需要。使用自然语言描述需求即可，Hermes 自动判断是否调用技能。
如何卸载技能
当前 LightVela 管理台暂不支持面板卸载，可通过对话方式让 Hermes 代为删除。详见 配置技能 - 删除已安装的技能。
技能是否额外收费
取决于技能作者。SkillHub 上架的多数技能免费，部分技能可能调用外部付费服务（消耗自有 API 额度），详见技能详情页说明。
能否自行开发技能上架
开发者上架能力规划中，当前仅可使用已上架技能。
故障排查
创建 Hermes 长时间停留在过渡页
可能为云端初始化慢或网络波动。建议：
-
等待 1 分钟
-
仍无响应则刷新页面
-
再无响应则重新点击「+ 创建 Hermes」
扫码后管理台无响应
可能为授权未完成或网络延迟。关闭弹窗重新点击「授权接入」生成新二维码。
机器人完全无响应的排查顺序
| 检查项 | 方法 |
|---|---|
| 通道状态 | 「已接入通道」列表是否仍在 |
| 体验积分 | 是否耗尽 |
| 模型状态（若使用自有模型） | 「当前模型」是否有记录 |
| Key 状态（若使用自有模型） | 在服务商后台确认余额与 Key 状态 |
| 网络 | 浏览器是否能正常打开 LightVela |
回复内容为乱码或无意义
多数情况下为自定义模型的端点不符合 OpenAI 协议。建议先使用其他 OpenAI 兼容客户端验证端点可用性。
提示「模型响应超时」
服务商限流或网络波动。稍后重试，或切换其他服务商。
如何重建 Hermes
删除当前 Hermes 后重新点击「+ 创建 Hermes」，所有数据将清零。
迁移与兼容
能否导出数据
当前管理台暂未开放数据导出功能。
能否在多设备登录
可以。同一账号在任意设备登录后均可访问相同数据。
其他
本文档未涵盖的问题
建议先使用 Cmd/Ctrl + F 搜索。如仍未找到，可通过官方渠道反馈（具体入口以官网为准）。