开始使用安装验证

安装验证

适用对象

已完成任一快速开始路径，希望确认 Alice 的完整链路可以工作的用户。

支持状态与验证版本

  • 已支持：Windows Alice 桌面应用及 Java 1.21.4 路径。
  • 实验性：Bedrock LSE Node.js 路径。
  • 已支持：桌面版 NapCat 的纯 QQ 路径。
  • 最后核对：2026-07-28；具体版本与限制见 下载与支持平台。

前置条件

步骤

  1. 验证桌面应用：确认主窗口可进入“模型”页面，并且模型卡片的“测试连接”成功。
  2. 验证接入状态：
    • Java：在世界或服务端控制台执行 /alice status，确认模组运行且 TCP 已连接；Alice 中应出现对应实例/工作区。
    • Bedrock：确认 BDS 日志中插件完成加载与 TCP 连接，Alice 中出现 Bedrock 实例及其动态注册工具。
    • 纯 QQ：确认 QQ 账号在 Alice 中为在线状态，并且 NapCat/OneBot 连接没有报错。
  3. 验证智能体：创建或选择一个绑定到当前 Minecraft 实例或 QQ 账号的智能体。
  4. 执行最小测试：
    • Minecraft：发送只读请求，例如“描述当前周围环境”，观察一次工具调用和回复。
    • QQ：从允许的私聊或群聊发送一条测试消息，观察机器人回复。
  5. 检查调用记录或运行日志，确认请求到达正确执行端且没有认证、模型或工具错误。

成功标志

以下项目全部满足才算安装完成：

  • Alice 启动正常；
  • 模型连接测试成功；
  • Minecraft 实例或 QQ 账号在线；
  • 智能体创建并绑定成功；
  • 至少一次工具调用或 QQ 消息产生可观察结果。

常见失败

  • 模型测试失败：检查 API 地址、密钥、模型名称及服务商余额；不要把真实密钥粘贴到日志或反馈中。
  • Java 的 /alice status 不存在：Alice Mod 未加载，或游戏版本/Java/Fabric 依赖不匹配。
  • Minecraft 实例未出现：先确认 Alice 已启动；Java 与 Bedrock 执行端当前应和 Alice 同机，并连接 127.0.0.1:27541。
  • 实例在线但没有工具：查看执行端日志中的握手或工具注册错误，并确认智能体绑定了正确工作区。
  • QQ 在线但不回复：检查账号绑定、群/私聊权限、是否需要 @，以及智能体的 QQ 模型配置。

下一步

纯 QQ 快速开始