升级说明

如果您已经安装过早期版本的 OpenClaw，本次升级无需重复安装 Docker、浏览器及浏览器插件。您只需下载最新的安装包，按照“第4步：一键自动部署”中的方法，运行新的安装脚本即可。脚本会自动检测并备份您现有的个人技能和配置文件，然后将容器环境升级到最新版本。整个升级过程简单快捷，您的数据将得到妥善保留。

在openclaw3.24版本中，openclaw操作浏览器方式由安装 OpenClaw Browser Relay，变更为独立谷歌浏览器，如果您已经安装过早期版本的 OpenClaw，后续使用openclaw控制浏览器时请先打开桌面的 “chrome(小龙虾)”

🛠️ 第 1 步：下载与准备工作

首先，我们需要准备好安装包和合适的浏览器。

1. 下载安装包：
   1. 点击下方百度网盘链接下载 OpenClaw 安装包，并解压到您的电脑中。
   2. 下载链接: https://pan.baidu.com/s/1vHWEMBNwqnIVAkWHQAyK2A?pwd=BGAI
   3. 提取码: BGAI
2. 选择系统版本：打开安装包文件夹，根据您电脑类型，找到对应的文件夹下载 

🔑 第 2 步：获取您的专属 API Key

1. 打开浏览器，访问 cnfcloud 模型服务平台：https://console.cnfcloud.com/login
2. 根据网站引导完成注册和登录。跟你的介绍人询问并输入推荐码 ，默认推荐码：2YUZJj4mAcs
3. 登录后，在控制台点击“我的资源- API密钥”，找到您的 API Key（是一串以 sk- 开头的代码）。
4. 重要： 请完整复制这串代码，并暂时粘贴到一个记事本里，我们在下一步马上就会用到。

🖥️ 第 3 步：安装浏览器（Chrome）

3. 准备浏览器：
   1. 我们强烈建议您使用 Google Chrome 浏览器，或微软自带的 Edge 浏览器。
   2. 如果您的电脑尚未安装，可以从解压后的部署包内每个系统版本的 “0. Chrome浏览器” 文件夹中找到安装程序，以Windows11为例：
      

🪟 第 4 步：安装windows基础功能 (WSL)

1. 在#Windows11 系统安装包中，打开1. wsl安装，双击运行wsl.2.6.3.0.x64.msi


🐳 第 5 步：安装运行环境 (Docker)

1. 在#Windows11 系统安装包中，打开2. docker-desktop安装，双击 Docker Desktop Installer-461.exe 安装程序。
   

2. 双击后，按照提示一路点击“下一步”（Next / OK / Accept）。请确保勾选 "Use WSL 2 instead of Hyper-V" 选项，这是推荐的设置。

3. 如果系统提示您需要安装 WSL (Windows Subsystem for Linux)，请同意安装。安装完成后，系统通常会要求重启电脑，请按提示操作。
   

4. 安装并重启后，请务必先手动启动 Docker Desktop，通常打开需要耐心等待一阵。首次启动时可能会有服务协议，点击 Accept 即可。

5. 耐心等待，直到电脑右下角任务栏的 Docker 鲸鱼图标静止不动，或 Docker 应用主界面显示 “Engine running”，表示其已成功运行。
   

⚡ 第 6 步：一键自动部署

1. 在#Windows11 系统安装包中，打开3. openclaw-安装，找到名为安装.bat 的文件，直接双击运行。
   

2. 系统会弹出一个黑色命令行窗口，脚本将自动运行。
   
3. 配置工程路径： 脚本会询问您“工程文件存放位置”。如果您不确定，直接按回车键使用默认路径即可。

4. 配置数据路径： 脚本会询问您“数据文件夹data创建的位置”。如果您不确定，直接按回车键使用默认路径即可。
   

5. 等待导入镜像，根据电脑磁盘性能，1-5分钟左右。

6. 配置 API Key： 当提示输入 API Key 时，将您在第 3 步保存在记事本里的 sk- 开头的代码粘贴进去，按回车确认。

7. 配置访问凭证 (Token)： 脚本会要求您设置一个网页登录密码 (Token)。您可以输入一个容易记住的数字（例如 123456），或直接按回车使用默认值。请务必记住这个密码。

8. 稍等 1-2 分钟，脚本会自动完成所有配置。当浏览器自动弹出 OpenClaw 的聊天界面时，恭喜您，部署成功！

🔌 第 7 步：打开Chrome 浏览器 （小龙虾）

一、 进入桌面

1. 打开 Chrome 浏览器 （小龙虾）
   

🌐 第 8 步：日常访问与管理

6.1 如何访问 OpenClaw？

http://127.0.0.1:18789/?token=您设置的凭证

6.2 常用后台管理命令

• ▶️ 启动 OpenClaw (电脑重启后或服务停止后使用，通常会自动拉起)：

docker compose up -d

• ⏹️ 停止 OpenClaw：

docker compose down

• 📋 查看运行日志 (用于排查故障)：

docker logs openclaw-gateway

❓ 常见问题排查 (FAQ)

答： 这通常是因为文件夹所在的路径包含了中文字符。请将整个 openclaw-deploy 文件夹移动到纯英文的路径下（例如直接放在 D:\openclaw 目录下），然后重试，仍然不行联系工作人员。

答： 这通常代表 API Key 没填对。

建议使用api-key修改较为复杂，建议使用脚本进行帮助切换。

以window11为例，在安装包中执行重设APIKey脚本。

手动操作：

1. 请在 openclaw-docker 文件夹中找到 .env 文件，右键选择用记事本打开。
2. 找到 API_KEY= 这一行，将等号后面的值改成正确的 Key，然后保存并关闭记事本。
3. 打开命令行进入该目录，依次执行 docker compose down 和 docker compose up -d 重启服务即可生效。

仍无生效请查看fcloud算力平台余额是否拥有充足余额。

答： 简单的重启命令无法加载新的配置文件。您必须先彻底停止服务 (docker compose down)，然后再重新启动 (docker compose up -d)，新配置才会被系统读取。

答： 与修改 API Key 的方法完全相同。用记事本打开 .env 文件，找到 OPENCLAW_GATEWAY_TOKEN= 这一行，修改等号后面的值并保存。最后一定要记得执行 docker compose down 和 docker compose up -d 重启服务。

答： 模型修改较为复杂，建议使用脚本进行帮助切换。

以window11为例，在安装包中执行切换模型脚本。