让 AI 住进你的电脑
码虾 CodeClaw · 使用说明书

本软件通过 U 盘 发放，不需要安装到电脑。把 U 盘插上就能用，软件、配置、激活信息、聊天记录全部存在 U 盘里， 换一台电脑插上还是你原来那套配置。

U 盘根目录里应该有这些东西：

• OpenClawCN-2.1.6-Portable.exe —— 主程序，双击这个
• 先看我.txt —— 1 分钟看完，能避开最常见的坑（建议先看）
• Data 文件夹 —— 你的配置、插件、运行环境都在里面，不要删、不要改名
• 我的项目 文件夹 —— 建议让 AI 在这个文件夹里干活，换电脑文件也跟着走
• U盘_激活码.txt —— 你的激活码（OC-XXXX-XXXX-XXXX-XXXX）

运行步骤

1. 把 U 盘插到电脑上（建议 USB 3.0 蓝色接口），打开「此电脑」进入 U 盘。
2. 双击 OpenClawCN-2.1.6-Portable.exe。不要先把它复制到电脑硬盘——程序会检测到并拒绝启动，提示「请插在 U 盘上运行」。
3. 如果屏幕弹出蓝色窗口「Windows 已保护你的电脑」，点 更多信息 → 仍要运行。（我们还没买微软签名证书，没签名的程序第一次运行都会提醒一次，之后不再弹。）
4. 第一次打开如果提示「运行环境未安装」，去左侧 更多设置 → 环境管理，点 一键安装环境。 约 200MB，等 3～5 分钟（只装这一次，装在 U 盘里，换电脑不用再装）。 说明不装也能纯聊天；装完才有「自己执行命令、读写文件」的 Agent 能力。
5. 接着会弹出「授权登录」窗口要求输入激活码（下一章教你填）。

系统要求

第一次双击 OpenClawCN-2.1.6-Portable.exe 启动软件时，会直接弹出「授权登录」窗口，要求输入激活码。

激活步骤

1. 打开你的 U 盘，找到里面存放激活码的文件（里面是一串 OC-XXXX-XXXX-XXXX-XXXX 这样的字符）。
2. 复制这串激活码（Ctrl+C）。
3. 回到软件的「授权登录」窗口，把激活码粘贴（Ctrl+V）到输入框里。
4. 点击 验证 按钮，提示成功即激活完成，自动进入主界面。

OpenClaw 本身不含模型，它负责帮你"连接"各家大模型。你需要先在模型厂商官网注册一个账号，拿到一串 API Key（调用密钥），再填进软件。

这一步要花一点点钱（很少）：模型调用的费用是厂商收的，我们收不到，也没有任何加价。DeepSeek 最低充 10 元，普通人日常使用能用很久。下面以 DeepSeek 为例详细演示，其他厂商在后面列表。

3.1 DeepSeek（最常用，推荐新手）

1. 打开 DeepSeek 开放平台：https://platform.deepseek.com/，点击右上角 注册（支持手机号 / 微信 / 邮箱，按页面提示完成即可）。
2. 注册后登录，点右上角头像 → 账户设置 → 实名认证，按提示上传证件完成认证（一般几分钟到 2 小时通过）。关键这一步不做，后面根本看不到充值按钮，很多人就卡在这里。
3. 认证通过后，点右上角头像 → 账户余额 → 点充值，选 10 元（也有 50 / 100 等档位），用微信或支付宝支付，一般 1~3 分钟到账。
4. 回到左侧菜单 API keys（接口密钥） → 点击 创建 API key，起个名字（随意，如 openclaw），确认。
5. 系统会生成一串以 sk- 开头的密钥，例如 sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx（你自己生成的那串，每个人都不一样）。
   重要这串密钥 只显示这一次！请立刻点击复制，粘贴到记事本或微信"文件传输助手"里保存好。
6. 把复制好的 Key 填进软件（见第 4 章），就可以开始聊天了。

3.2 中国大模型 · 注册与获取 Key 一览（共 15 家）

以下均为国内厂商，国内网络直连可用，注册基本用手机号 / 微信即可。标「✅ 预设支持」的，在 OpenClaw「AI 模型配置」里直接点对应卡片即可；标「🔧 兼容接入」的，在「自定义 / 标准接口」里填该平台的地址即可（说明书第 4 章有讲）。

3.3 关于「接入方式」的说明

• ✅ 预设支持：OpenClaw「AI 模型配置」里已内置该厂商卡片，点一下、填 Key 即可，无需记地址。
• 🔧 兼容接入：在「AI 模型配置」选「自定义 / 标准接口」，填入该平台的 API Key 与 Base URL（各厂商文档可查），即可使用。本软件仅接入国内大模型。
• 🔑 通用提醒：无论哪家，注册后创建的 API Key 通常只显示一次，请立刻复制保存到记事本或微信「文件传输助手」；各平台计费独立，使用前确认账户有余额 / 免费额度。

拿到 API Key 后，把它填进 OpenClaw 的「AI 模型配置」页面即可。下面以 DeepSeek 为例。

操作步骤

1. 在软件 左侧侧边栏 找到「更多设置」（可点击展开），点开里面的 AI 模型配置 ⚙️ 菜单项。
2. 进入后，页面顶部是 「🎯 选择 AI 模型」，里面是一排模型厂商卡片。点击 DeepSeek 这张卡片（选中后会打勾 ✓）。
3. 下方出现三个输入框：
   • API Key：把第 3 章复制的 sk-... 粘贴进来（输入时会显示为圆点，保护隐私）。
   • 模型：默认已填 deepseek/deepseek-v4-pro，一般不用改；想换模型可点击输入框选择或手动输入。
   • API 地址：默认 https://api.deepseek.com/v1，保持默认即可，不要改动。
4. 填好后，点击页面右上角的 💾 保存配置 按钮。
5. 看到「保存成功」提示，即代表大模型已接入。现在可以回到左侧 AI 对话 💬 开始聊天了。

如果用的是硅基流动 / 其他厂商

步骤完全一样，只是在第 2 步点对应的厂商卡片。各厂商填法：

配置好模型后，左侧栏顶部「常用功能」有五个入口：

第一次对话建议

1. 点左侧 AI 对话 💬。
2. 在底部输入框输入：你好，介绍一下你能帮我做什么？
3. 如果龙虾正常回复，恭喜——全部配置成功！

Q1：提示「授权码无效」？

① 检查从 U 盘文件复制的激活码是否完整（格式 OC-XXXX-XXXX-XXXX-XXXX，无多余空格）；② 重新复制粘贴一次再点验证；③ 同一激活码最多绑 3 台设备，超限需换码。

Q2：对话报错「401 Authentication Fails / API Key 无效」？

① 检查 API Key 是否复制完整（sk- 开头，没有空格）；② 确认地址、模型名、Key 是同一家（最常见的坑，见第 4 章警示）；③ 到平台确认账户余额是否充足（余额为 0 会提示余额不足，见 Q2-1）；④ 在「AI 模型配置」重新粘贴并保存；⑤ 关闭软件重开。

Q2-1：提示「Insufficient Balance / 余额不足」怎么办？

意思是你的账号里没钱了，充值一下就好，不是软件坏了：
① 登录 platform.deepseek.com → 右上角头像 →「账户余额」→ 点充值，选 10 元，微信 / 支付宝支付；
② 如果找不到充值按钮，说明还没实名认证 → 右上角头像 →「账户设置 → 实名认证」，通过后再回来充值（这是最常见的原因）；
③ 充完值不用改软件里任何配置，直接回来继续聊就行。10 元大约能聊几百到上千次。

Q3：发消息提示「Gateway 正在启动中」一直不停？

首次启动 Gateway 需要 30~40 秒。若超过 1 分钟仍如此，请彻底退出软件（托盘右键退出），再重新打开。如仍失败，检查电脑是否有其他程序占用了 18789 端口。

Q4：能换别的模型吗？比如用通义千问或 Kimi？

可以。在「AI 模型配置」点对应厂商卡片，填入该平台的 API Key 与模型名即可。目前内置的都是国内大模型（DeepSeek、通义千问、智谱 GLM、Kimi、豆包、MiniMax 等），国内手机号即可注册。

Q5：我的聊天数据安全吗？

对话通过你自己的 API Key 直连模型厂商，数据不经过 OpenClaw 官方服务器；软件本体运行在你的电脑上，属于本地运行。

Q6：想升级到新版本怎么办？

U 盘版不支持软件内自动更新。升级方式：到官网下载最新的便携版 exe，直接覆盖 U 盘里的旧 exe 即可（Data 文件夹不要动，配置和激活信息都还在）；或者找客服换一张新版 U 盘。

如果软件报错、用不了，不用自己查原因。软件里有一个「一键上报」按钮，它会把必要的排障信息发给我们，系统当场自动分析问题原因，并直接给你一个「一键修复」按钮——大多数情况点一下就好，连客服都不用找。

1. 在软件左下角（「Gateway 运行中」下面）点 🩺 上报问题。
2. 在输入框里简单写一句遇到了什么（选填，比如「一直报 401」）。
3. 点 ① 收集信息，等几秒。
4. 屏幕上会显示即将发送的内容，你可以先看一遍，确认没问题后点 ② 确认发送。
5. 几秒后，系统会告诉你：问题出在哪、为什么、要怎么修。
6. 如果看到 「一键修复」 按钮，直接点它，软件会自动改好，完事后等 30 秒再试一次即可。
7. 如果显示的是「去填 API Key」「去充值」这类提示，说明这一步只能你自己做（要你的账号密码），按屏幕上的说明操作就行。