新手也能看懂的龙虾使用教程

填好 Key 后怎么开始聊天

保存 API 配置成功后，不需要先接 QQ 或微信，也可以直接用网页聊天。建议先用这个办法测试“是不是真的通了”。

1. 打开聊天地址：http://127.0.0.1:18789/#token=uclaw
2. 进入页面后直接输入问题。
3. 第一次建议发一句“你好，能听到吗？”
4. 如果能正常回复，说明基础配置已经通过。

QQ 通道怎么对接

这里的 QQ 不是扫码登录个人 QQ，而是走 QQ 开放平台机器人。所以关键不是电脑里装没装 QQ，而是你有没有机器人参数。

1. 打开高级配置：http://127.0.0.1:18788/advanced.html
2. 找到 QQ Bot 区块。
3. 去 QQ 开放平台 创建机器人。
4. 登录平台时可以用手机 QQ 扫码完成注册或登录。
5. 复制平台给你的 App ID 和 Client Secret。
6. 回到龙虾，把这两个参数填进去并保存。

QQ / 微信等待回复慢，流式回复怎么看

QQ 和微信通道比网页聊天慢一点是正常的，因为它们还要经过通道插件、平台转发、登录态和反刷限制。只要网页聊天正常，通道端慢一点通常不是“坏了”。

1. 先用网页聊天确认模型能回话，再测试 QQ / 微信。
2. 如果客户感觉慢，先看是不是首条消息在建会话，首条通常会更慢。
3. QQ 插件支持手动打开流式消息，但目前只支持 C2C 私聊，群聊和频道不走这套流式接口。
4. 微信插件当前支持 typing 输入状态，但源码里已禁用块流式回复，所以不能像 QQ 那样只靠改配置就打开同类流式。
5. 想让体感更快，优先减少超长提示词、先用网页端验证、并尽量使用响应更快的模型或更稳定的网络。

{
  "channels": {
    "qqbot": {
      "streaming": true
    }
  }
}

如果你配了多个 QQ 机器人账号，就把开关写在对应账号下面：

{
  "channels": {
    "qqbot": {
      "accounts": {
        "bot2": {
          "streaming": true
        }
      }
    }
  }
}

改完保存配置文件后，要重启网关再试。想让等待时更像“正在输入”，还可以在同一个配置文件里加上下面这段：

{
  "agents": {
    "defaults": {
      "typingMode": "instant",
      "typingIntervalSeconds": 6
    }
  }
}