LightVela

常见问题 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 无响应的排查方式

按以下顺序检查:

  1. 当前 Bot 是否在线;若从聊天软件发消息,再检查该 Bot 的通道是否已连接。网页对话不依赖外部通道

  2. 若使用自有模型:主模型是否已配置、状态检测是否通过、服务商余额是否充足

  3. 若使用体验积分:积分是否耗尽

  4. 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. 等待 1 分钟

  2. 仍无响应则刷新页面

  3. 再无响应则重新点击「+ 创建 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

本页目录

摘要账号与登录支持哪些登录方式?同一用户能否用 QQ 和微信各登录一次?如何退出登录实名认证为什么要实名认证实名认证何时触发实名信息如何保管支持哪些证件类型实名是否需要每次开通套餐都做一次实名后能否修改实名信息实名后能否修改账号显示名或 Hermes Agent 名字认证失败如何处理套餐与体验积分当前有哪些套餐「100 体验积分」的含义积分耗尽后如何处理积分是否支持充值启航套餐是否永久免费一个套餐是否只能创建 1 个 Bot模型相关如何获取 API Key如何选择模型能否使用 Claude / GPT / Gemini消息发送后 Hermes Agent 无响应的排查方式切换模型是否会丢失对话记忆能否同时配置多个模型通道相关微信、QQ、企业微信、飞书、钉钉能否同时接入是否支持企业微信能否将机器人添加至个人微信群加入企业微信群后,能否自动读取全部群历史更换手机或 QQ / 微信号后的影响如何解除已接入的通道QQ 机器人是否需要自行注册如何测试已接入的通道对话与记忆单条消息能否删除删除 Hermes Agent 后能否恢复技能相关安装技能后是否需要触发词如何卸载技能技能是否额外收费能否自行开发技能上架故障排查创建 Hermes Agent 长时间停留在过渡页扫码后管理台无响应机器人完全无响应的排查顺序回复内容为乱码或无意义提示「模型响应超时」如何重建 Hermes Agent迁移与兼容能否导出数据可以从其他 Agent 迁入吗?能否在多设备登录其他本文档未涵盖的问题