Qclaw（龙虾）使用文档：把算力装进你的客户端

本页说明如何将「埃拉Ai」模型接入 Qclaw（龙虾）桌面端。本账号与积分仅限 Qclaw 使用。

1详细使用说明（先读这段）

整体流程只有三步，全程无需懂技术：

  1. 兑换码激活积分：在兑换页或门户「我的额度」里粘贴兑换码（形如 AILA-XXXX-XXXX），积分立即到账。
  2. 下载配置包：在「我的额度」点击「生成配置 / 下载配置」，得到 qclaw-config.zip（压缩包里已含你的专属网关密钥）。
  3. 导入 Qclaw：解压后双击 import.bat（推荐，最简单），或按本文「手动部署」自己操作。然后打开 Qclaw 切到模型即可看到。

积分是结算单位，Qclaw 内只显示「积分余额」与用量，不显示金额。每次调用模型按 token 消耗扣减积分，余额用尽需续费。

2在线一键脚本（免解压，推荐）

除了 zip 离线包，还有更省事的方式：在线一键脚本。在「我的额度」里和「下载配置」并列提供，按你的系统下载 qclaw-setup.cmd（Windows）或 qclaw-setup.sh（macOS）。脚本里已经烘焙好你的专属密钥与模型清单，下载后直接运行即可，无需解压、也无需本机安装 Python。

  1. 登录 Qclaw 门户 → 「我的额度」卡片，点击对应的 「Windows 脚本」/「macOS 脚本」按钮下载。
  2. Windows：双击 qclaw-setup.cmd；macOS：在终端执行 bash qclaw-setup.sh。
  3. 看到「配置成功」提示后，重启 Qclaw（龙虾），即可看到 埃拉Ai/GLM-5.2 等模型。
为什么比 zip 更省心？
脚本会自动对你原有的 openclaw.json 做备份（生成 .backup-时间戳-PID 文件），按模型 id 合并写入（相同 id 覆盖、异 id 追加，不会抹掉你已有的其它自定义模型），密钥仅写入本机配置目录、不外泄。无需解压、无需 Python、也无需临时关闭杀毒软件。

3获取「一键部署脚本（.bat / zip）」的方法

我们不直接发放 .bat 文件（容易被杀毒软件当作病毒拦截删除），而是把它打包进「配置包」里，由你登录后自行下载：

  1. 打开 Qclaw 门户 并登录。
  2. 登录后在「我的额度」卡片里，点击 「生成配置 / 下载配置」 按钮。
  3. 浏览器会下载一个 qclaw-config.zip 压缩包，解压到桌面等你能找到的位置。
  4. 解压后里面就有 import.bat（一键部署脚本）和 使用说明.txt，以及 qc-provider.json、qc_import.py 等配置文件。

如果浏览器提示「下载的文件可能有害」被拦截，请在下载栏选择「保留」或「仍要下载」——这是压缩包 + 脚本的误报，文件本身安全。

前往 Qclaw 门户下载配置包

4⚠ 重要：运行 .bat 前请先临时关闭杀毒软件

运行 import.bat 之前，请先临时关闭 Windows 安全中心 / 第三方杀毒软件。
该脚本会向你的 Qclaw 配置目录写入主配置 openclaw.json。杀毒软件对「可执行脚本 + 写入系统目录」的行为高度敏感，常会误判并直接拦截或删除脚本，导致导入失败（表现：双击没反应、文件被秒删、客户端看不到模型）。

正确做法：

  1. 暂时退出 / 关闭杀毒软件与 Windows 安全中心（实时防护）。
  2. 双击 import.bat，看到窗口显示「导入成功」再关闭窗口。
  3. 导入完成后、Qclaw 已能正常连接模型，再把杀毒软件重新开启。

若双击时被 SmartScreen 拦截，点「更多信息 → 仍要运行」即可。整个过程只是写入本地配置文件，不会联网上传任何东西。

如果你对「关闭杀软」感到不安，请直接走下方「手动部署」，全程不运行任何脚本，同样能把模型接好。

5手动部署（不运行任何脚本的替代方案）

如果你不想关闭杀软、或脚本方式失败，可以用手动方式导入。Qclaw（openclaw）不读独立的 models.json，而是把自定义模型写在主配置 %USERPROFILE%\.qclaw\openclaw.json 里。所以手动部署是把提供方合并进该文件。

  1. 解压 qclaw-config.zip，找到里面的 qc-provider.json（提供方配置）和 qc_import.py（合并脚本）。
  2. 方法 A（推荐，需本机有 Python 3）：进入该文件夹，地址栏输入 cmd 回车打开命令行，执行 py -3 qc_import.py，看到「[OK] 已将埃拉Ai 模型写入 Qclaw 配置」即完成（脚本会自动备份原配置为 openclaw.json.bak）。
  3. 方法 B（完全不用脚本）：用记事本打开 qc-provider.json 记下整段内容；再打开 %USERPROFILE%\.qclaw\openclaw.json（先备份一份），在 models.providers 下新增一项 "aila-luxy": { …把 qc-provider.json 的内容原样贴进来… }，保存文件。
  4. 打开 Qclaw（龙虾），左侧菜单切到「模型 / 设置」，刷新或重启客户端，即可看到 埃拉Ai/GLM-5.2、埃拉Ai/GLM-5.1。

提示：配置包里的 使用说明.txt 也提供了详细步骤；若仍看不到模型，先确认 openclaw.json 的 models.providers 里是否含 aila-luxy 一项，再重启 Qclaw。

6查询你的积分余额（随时查看用量）

登录 Qclaw 门户 后，在「我的额度」里可实时查看积分余额、每次调用的 token 消耗与用量明细。点击下方按钮直接跳转查询（需先登录 Qclaw 账号）：

🦞 Qclaw 积分查询

查看 Qclaw 专用积分余额、用量与专属令牌状态。

前往 Qclaw 门户

7信任说明与常见问题

🔒 密钥安全吗？为什么敢把 Key 放在脚本 / 配置里？

  • 配置与脚本里的「专属密钥」是只对你这台机器、Qclaw 客户端生效的网关令牌，里面不含你的登录密码。
  • 脚本只把配置写入你自己本机的客户端目录（%USERPROFILE%\.qclaw），不会联网上传、不会外发给任何人。
  • 密钥仅用于 Qclaw 向网关请求模型调用，传输走 HTTPS；我们不会在网页或 URL 里展示完整密钥。用完脚本建议即删。

♻️ 配置写错了 / 想还原怎么办？（备份机制）

  • 无论 zip 还是在线脚本，写入前都会自动备份你原有的 openclaw.json → openclaw.json.backup-时间戳-PID。
  • 还原方法：把备份文件重命名回原名（去掉 .backup-… 后缀）即可恢复。
  • 脚本按模型 id 合并，不会覆盖你已有的其它自定义模型；覆盖同名 id 时也会先备份。

😵 Qclaw 看不到模型？

  • 先确认脚本提示「配置成功」——若没成功，按下方「工具跑不起来」排查。
  • 成功率最高的办法：完全退出（含后台进程）Qclaw，再重新打开，很多客户端需要重启才刷新模型列表。
  • 打开 Qclaw 后「模型 / 设置」看一下。
  • 仍看不到：回到「我的额度」再点一次「下载配置 / 脚本」重新生成（每次都用当前生效的密钥），然后重来。

🐢 兑换后积分到账延迟？

  • 兑换码通常即时到账；偶有支付平台延迟，最多等几分钟，可在「我的额度」刷新查看。
  • 若长时间未到账，请凭订单号联系客服核对，不要重复购买。

🛠 工具跑不起来 / 脚本报错？

  • 确认下载的是与系统匹配的文件（Windows 用 qclaw-setup.cmd，macOS 用 qclaw-setup.sh）。
  • Windows 被拦截：点「更多信息 → 仍要运行」；或在「设置 → 更新和安全 → Windows 安全中心 → 病毒和威胁防护」临时关闭实时保护后再运行 zip 里的 import.bat。
  • macOS 提示权限：终端里先 chmod +x qclaw-setup.sh 再运行；若报错「osascript 不存在」说明不是 macOS。
  • Qclaw 脚本提示「找不到 openclaw.json」：请先安装并登录过一次 Qclaw（龙虾），让它生成主配置。

🔑 提示 Key 无效 / 401？

  • 密钥是随配置包/脚本一起下发的，不要手动改动或复制粘贴错行；直接重新下载一次最新配置即可。
  • 同一密钥可在多台机器的同一个 Qclaw 使用；若被怀疑泄露，回「我的额度」重新下载配置，旧密钥即被新密钥覆盖。