常见问题 FAQ
摘要
本页汇总 LightVela 使用过程中的常见问题,覆盖账号与登录、套餐与计费、模型配置、通道接入、技能、记忆与运行排查。国内站支持微信、QQ 或手机号验证码登录,首次开通套餐前需完成实名认证;微信、QQ、企业微信、飞书、钉钉可作为 Hermes Agent 的聊天通道。套餐附带模型积分,价格、优惠和额度以套餐管理及订阅页实时展示为准。技能可在管理台安装和卸载;长期记忆可通过对话请求增删,无需为清除一条记忆而删除整个 Agent。
本页汇总使用 LightVela 过程中的常见问题。建议先使用 Cmd/Ctrl + F 搜索关键词。如未找到答案,可在 快速开始、配置总览 或具体配置子页的「常见问题」小节中进一步查找。
账号与登录
支持哪些登录方式?
LightVela 主要服务国内用户,目前支持微信、QQ 和手机号验证码登录;可在登录弹窗的「其他登录方式」中切换。
同一用户能否用 QQ 和微信各登录一次?
可以,但会是两个独立账号,Hermes Agent、对话记忆、套餐状态均不互通。建议固定使用一种登录方式。
如何退出登录
在 Bot 管理台点击左下角账号菜单,选择「退出登录」;或进入账号信息页,在「账号基本信息」卡片中点击退出按钮。退出后账号数据保留,下次登录即可继续使用。
实名认证
为什么要实名认证
实名认证用于符合国内 SaaS 服务的合规要求。首次开通任意套餐前必须完成实名。
实名认证何时触发
登录后浏览首页、阅读文档不需要实名。首次点击「立即开通」领取套餐时,若账号未认证,页面顶部会出现提示条,引导前往账号信息页完成认证。
实名信息如何保管
姓名和身份证号加密传输并存储,平台仅保留脱敏信息用于展示,认证信息不会用于其他用途。
支持哪些证件类型
当前仅支持中国大陆居民身份证,其他证件类型暂未开放。
实名是否需要每次开通套餐都做一次
不需要。认证为一次性操作,完成后开通任意套餐、购买 LightVela 其他产品均无需重复认证。
实名后能否修改实名信息
可以。进入账号页,在实名认证一行点击「修改」重新提交真实姓名和身份证号。新信息通过核验后会覆盖当前实名信息,后台保留变更记录。
实名后能否修改账号显示名或 Hermes Agent 名字
可以。实名认证绑定的是真实姓名和身份证号,与账号显示名、Hermes Agent 实例名称无关,后两者可在对应页面随时修改。
认证失败如何处理
| 现象 | 可能原因 | 处理方式 |
|---|---|---|
| 提示姓名与身份证号不匹配 | 填写错误 | 核对后重新提交 |
| 提交后长时间无响应 | 网络波动或后台繁忙 | 稍后重试 |
套餐与体验积分
当前有哪些套餐
当前订阅页展示启航 Launch 与巡游 Cruise 两个系列,各可选择低积分或高积分档位。套餐权益、实时价格、续费和退款规则详见套餐管理。
「100 体验积分」的含义
100 积分是启航系列当前可选的低积分档位,每月随该档套餐提供,用于模型调用。启航也可选择更高的 4500 积分档位;巡游可选 200 或 10000 积分。具体以订阅页选中的档位为准。
积分耗尽后如何处理
可用积分耗尽后,依赖模型调用的对话与智能任务会受限。已有有效套餐时可在订阅页购买额外积分包,也可等待下一周期套餐积分,或在「模型」中配置自有 API Key,详见AI 积分说明。
积分是否支持充值
支持已有有效套餐的用户另购模型积分包。积分包自到账起有效 1 个月,不属于套餐每月自动发放的积分;具体可选额度、价格与购买入口见AI 积分说明。
启航套餐是否永久免费
不是永久免费。符合条件的首购用户可能看到启航系列首单免费活动;活动名额、免费期限、到期和后续续费规则以订阅页与订单实时展示为准。
一个套餐是否只能创建 1 个 Bot
不是。当前订阅页展示启航系列最多 5 个、巡游系列最多 10 个 Bot;当前账号能否新建及剩余额度,以管理台显示和功能开放状态为准。详见管理与切换 Bot。
模型相关
如何获取 API Key
在「探索 → 管理 → 模型」选择配置方式和服务商后,若页面提供「点此获取 API Key」,点击可前往对应服务商后台创建密钥,再回到 LightVela 填写并确认配置。详见 配置模型。
如何选择模型
详见 配置模型 - 选型参考。
能否使用 Claude / GPT / Gemini
可通过「自定义模型」接入服务商提供的兼容端点。当前支持 OpenAI Chat Completions、Anthropic Messages 和 OpenAI Responses;请按服务商实际支持的协议、模型 ID、权限与额度配置,不能只按模型品牌判断兼容性。
消息发送后 Hermes Agent 无响应的排查方式
按以下顺序检查:
-
当前 Bot 是否在线;若从聊天软件发消息,再检查该 Bot 的通道是否已连接。网页对话不依赖外部通道
-
若使用自有模型:主模型是否已配置、状态检测是否通过、服务商余额是否充足
-
若使用体验积分:积分是否耗尽
-
Key 是否在服务商后台被禁用
切换模型是否会丢失对话记忆
不会。对话记忆为 Hermes Agent 自身数据,模型仅负责生成响应。
能否同时配置多个模型
可以配置多个可用模型,再从已配置模型中选择当前生效的一个。每个 Bot 可分别设置主模型与备用模型,网页对话还可单独选择当前会话模型;切换时无需新建 Agent。操作见配置模型和模型切换。
通道相关
微信、QQ、企业微信、飞书、钉钉能否同时接入
可以。多个通道可连接到同一个 Bot,使用该 Bot 的记忆和设置;不同 Bot 的连接分别管理。
是否支持企业微信
支持。可在管理台连接企业微信,与机器人私聊,也可将机器人添加到企业微信内部群,通过 @ 机器人发起对话。接入和群聊验证步骤见配置通道 - 企业微信。
能否将机器人添加至个人微信群
当前不支持。个人微信通道仅支持一对一对话;企业微信是另一种通道,企业认证客户可在内部群聊中 @ 机器人,两者不能混用。
加入企业微信群后,能否自动读取全部群历史
不能将入群理解为自动获得全部群历史。机器人根据通过通道实际收到的消息处理任务;入群前的历史记录,以及未 @ 机器人的消息是否被推送,不能仅凭入群成功判断。需要整理过去的讨论时,请把相关文本或文件提供给机器人。
更换手机或 QQ / 微信号后的影响
账号基于 QQ / 微信 OpenID 识别,更换号即视为新账号,数据不迁移。如需保留数据,请继续使用原账号登录。
如何解除已接入的通道
选择目标 Bot,在「日常 → 通道」找到对应卡片,点击 断开 并按提示确认。之后核对连接状态;这不会删除整个 Bot。
QQ 机器人是否需要自行注册
选择扫码授权时,按管理台提示操作即可;选择手动绑定时,需要在 QQ 开放平台 创建机器人,取得 AppID 与 AppSecret 后填回 LightVela。详见 配置通道 - QQ。
如何测试已接入的通道
在管理台找到显示为“已连接”的通道,点击 测试。页面提示“测试消息已发送”只表示发送命令已被接受;请到对应聊天软件确认收到测试消息,再向机器人发送一句“你好”,确认 Agent 能回复。若未收到消息,先检查通道连接并重新测试;若能收到但 Agent 不回复,再检查模型和积分,并查看诊断中心。
对话与记忆
单条消息能否删除
当前不支持单独删除一条聊天消息。聊天记录与长期记忆是不同的数据:如果想让 Agent 忘记某项长期记忆,可以在对话中明确提出删除请求,再让它确认结果,详见记忆管理。不要为了删除一条记忆而删除整个 Hermes Agent。
删除 Hermes Agent 后能否恢复
不能。删除为不可逆操作,对话、通道绑定、已安装技能均会一并清除。
技能相关
安装技能后是否需要触发词
不需要。使用自然语言描述需求即可,Hermes Agent 自动判断是否调用技能。
如何卸载技能
在技能页打开当前 Bot 的 已安装 列表,找到目标技能,点击删除图标并确认;系统预置技能不能删除。详见配置技能 - 删除已安装的技能。
技能是否额外收费
取决于技能作者。SkillHub 上架的多数技能免费,部分技能可能调用外部付费服务(消耗自有 API 额度),详见技能详情页说明。
能否自行开发技能上架
开发者上架能力规划中,当前仅可使用已上架技能。
故障排查
创建 Hermes Agent 长时间停留在过渡页
可能为云端初始化慢或网络波动。建议:
-
等待 1 分钟
-
仍无响应则刷新页面
-
再无响应则重新点击「+ 创建 Hermes Agent」
扫码后管理台无响应
可能为授权未完成或网络延迟。关闭弹窗重新点击「连接」生成新二维码。
机器人完全无响应的排查顺序
| 检查项 | 方法 |
|---|---|
| 通道状态 | 「已接入通道」列表是否仍在 |
| 体验积分 | 是否耗尽 |
| 模型状态(若使用自有模型) | 主模型及备用配置、模型状态检测结果 |
| Key 状态(若使用自有模型) | 在服务商后台确认余额与 Key 状态 |
| 网络 | 浏览器是否能正常打开 LightVela |
回复内容为乱码或无意义
先核对自定义模型的兼容协议、Base URL 和模型 ID,并运行模型状态检测。输出异常可能来自协议不匹配、模型能力或上下文问题;可用一条简短消息与另一可用模型对比,不要直接判断为某一种协议故障。
提示「模型响应超时」
服务商限流或网络波动。稍后重试,或切换其他服务商。
如何重建 Hermes Agent
先在 探索 → 管理 → 诊断中心 查看日志并选择可用的维护操作,再按问题选择重置模型配置、重置工作环境或 重置 Hermes(保留数据)。各操作的影响范围不同;整实例维护会影响同一 Agent 的其他 Bot,执行前阅读确认提示。不要把删除整个 Agent 当作常规恢复步骤。完整流程见诊断中心。
迁移与兼容
能否导出数据
可以通过云存储下载单个文件;整实例数据可使用诊断中心的备份与恢复,按提示将备份发送到绑定邮箱。备份包含整个 Agent 的所有 Bot,须等待备份任务完成,不能把提交成功当作备份已生成。
可以从其他 Agent 迁入吗?
可以在 探索 → 管理 → 高级设置 → 从其他 Agent 迁移 上传支持的备份,预览后选择新建 Bot、合并或跳过。人设、记忆、Skill 与聊天记录的导入范围以预览为准,模型或外部服务凭证可能需要重新配置。详见高级设置。
能否在多设备登录
可以。同一账号在任意设备登录后均可访问相同数据。
其他
本文档未涵盖的问题
建议先使用 Cmd/Ctrl + F 搜索。如仍未找到,可通过官方渠道反馈(具体入口以官网为准)。
最后更新于 2026-11-14