使用文档：把算力装进你的客户端

本页说明拿到兑换码并成功兑换后，如何把「埃拉Ai」模型接入 WorkBuddy 或 Qclaw（龙虾）。两种客户端均支持，账号与积分各自独立。

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

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

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

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

WorkBuddy 桌面端 Qclaw（龙虾）桌面端

WorkBuddy 用户看这里

  • 配置包：workbuddy-config.zip，写入目录 %USERPROFILE%\.workbuddy
  • 导入后可用的模型：埃拉Ai/DeepSeek-V4-Pro、埃拉Ai/DeepSeek-V4-Flash

Qclaw（龙虾）用户看这里

  • 配置包：qclaw-config.zip，写入目录 %USERPROFILE%\.qclaw
  • 导入后可用的模型：埃拉Ai/GLM-5.2、埃拉Ai/GLM-5.1

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

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

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

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

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

  1. 打开对应门户并登录：
    WorkBuddy → /workbuddy　｜　Qclaw → /qclaw
  2. 登录后在「我的额度」卡片里，点击 「生成配置 / 下载配置」 按钮。
  3. 浏览器会下载一个 *-config.zip 压缩包，解压到桌面等你能找到的位置。
  4. 解压后里面就有 import.bat（一键部署脚本）和 使用说明.txt。两个平台包内其余文件不同：WorkBuddy 包另含 models.json、merge.py；Qclaw 包另含 qc-provider.json、qc_import.py。

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

前往 WorkBuddy 门户下载配置包

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

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

正确做法：

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

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

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

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

如果你不想关闭杀软、或脚本方式失败，可以用手动方式导入。两种客户端机制不同：WorkBuddy 是「把一个 models.json 放进配置目录」；Qclaw（openclaw）则是「把提供方合并进主配置 openclaw.json」。下面分平台说明。

WorkBuddy 手动部署

  1. 解压 workbuddy-config.zip，找到里面的 models.json。
  2. 打开文件资源管理器，地址栏输入 %USERPROFILE%\.workbuddy 并回车，进入 WorkBuddy 配置目录。
  3. 把 models.json 复制到该目录下（若已存在同名文件，先备份原文件再覆盖）。
  4. 打开 WorkBuddy，左侧菜单切到「模型 / 设置」，刷新或重启客户端，即可看到 埃拉Ai/DeepSeek-V4-Pro 等模型。

Qclaw（龙虾）手动部署

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 也提供了分平台的详细步骤；若仍看不到模型，先确认配置已正确写入（WorkBuddy 看 models.json 是否到位；Qclaw 看 openclaw.json 的 models.providers 里是否含 aila-luxy 一项），再重启客户端。

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

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

WorkBuddy 积分查询

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

前往 WorkBuddy 门户查询
Qclaw 积分查询

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

前往 Qclaw 门户查询

提示：WorkBuddy 与 Qclaw 为两套独立账号与余额，互不通换、不共享登录态，请到各自门户查询。

7信任说明与常见问题

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

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

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

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

😵 装完后客户端看不到模型？

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

🐢 付款后 / 兑换后额度到账延迟？

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

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

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

🔑 提示 Key 无效 / 401？

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