OpenClaw 零基础上手：一键部署图文教程

OpenClaw 零基础上手：一键部署图文教程

前言：本文档是基于容器沙箱模式的 OpenClaw 安装教程，旨在为零基础的用户提供一份清晰、易于操作的指引。跟随本教程，您可以快速在个人电脑上部署并体验 OpenClaw 的强大功能。
当前版本：OpenClaw 3.2

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

首先，我们需要准备好安装包和合适的浏览器。
  1. 下载安装包：
    1. 点击下方百度网盘链接下载 OpenClaw 部署包，并解压到您的电脑中。
    2. 下载链接: https://pan.baidu.com/s/1l4PMOYi3J2zXHxn3PaaWbQ?pwd=BGAI 提取码: BGAI
    3. 提取码: BGAI
  1. 准备浏览器：
    1. 我们强烈建议您使用 Google Chrome 浏览器，或微软自带的 Edge 浏览器。
    2. 如果您的电脑尚未安装，可以从解压后的部署包内的 “0. Chrome浏览器” 文件夹中找到安装程序：
      • Windows 用户：选择 ChromeStandaloneSetup64.exe。
      • macOS 用户：选择 googlechrome.dmg。



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

容器沙箱模式的 OpenClaw 的运行需要依赖 Docker（您可以把它想象成一个装载 AI 程序的“集装箱”）。

🪟Windows 安装docker

  1. 在解压的部署包中，进入 1. docker-desktop安装包\Windows 文件夹。
  1. 检查您的系统类型：在系统设置的“系统信息”中，查看“系统类型”是 x64（Intel/AMD）还是 ARM。

  1. 根据您的系统类型，双击对应的 Docker Desktop Installer 程序。

  1. 双击后，按照提示一路点击“下一步”（Next / OK / Accept）。请确保勾选 "Use WSL 2 instead of Hyper-V" 选项，这是推荐的设置。
  1. 如果系统提示您需要安装 WSL (Windows Subsystem for Linux)，请同意安装。安装完成后，系统通常会要求重启电脑，请按提示操作。
  1. 安装并重启后，请务必先手动启动 Docker Desktop。首次启动时可能会有服务协议，点击 Accept 即可。


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


🍎 macOS 安装docker

  1. 在解压的部署包中，进入 1. docker-desktop安装包\MAC 文件夹。
  2. 检查您的芯片类型：点击屏幕左上角的苹果标志 🍎 > 关于本机，查看处理器是 Intel 还是 Apple (M系列或A系列)。
  3. 根据芯片类型选择对应的 .dmg 文件：
  • Intel 芯片：选择 Docker-intel.dmg。
  • Apple M 芯片：选择 Docker.dmg。

    1. 双击打开 .dmg 文件，将 Docker 图标拖拽到 “Applications” 文件夹中即可。
    2. 安装完成后，请从“应用程序”中启动 Docker Desktop。首次启动根据提示操作，选择 “Continue without signing in” 即可。

                4. 直到左下角任务栏出现它的图标，并显示为运行中状态。      

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

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


    ⚡ 第 4 步：一键自动部署

    准备工作全部就绪，接下来是最激动人心的自动化安装环节！请根据您的电脑系统选择对应的操作：

    🪟 Windows 用户操作指南

    1. 打开解压后的文件夹，进入2. openclaw-deploy目录，找到名为 import.bat 的文件，直接双击运行。

    1. 系统会弹出一个黑色的命令行窗口，请不要惊慌，脚本正在自动运行。
    2. 配置路径： 脚本会询问您“数据文件存放位置”。如果您不确定，直接按回车键使用默认路径即可。

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

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



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



    🍎 macOS 用户操作指南（Linux / WSL 在命令行的操作相同）

    1. 鼠标右键点击文件夹，点击“新建位于文件夹位置的终端窗口”


    1. 打开"openclaw-deploy"文件夹，把“import.sh”文件直接拖进终端里，然后按回车
    1. 配置路径： 脚本会询问您“数据文件存放位置”。如果您不确定，直接按回车键使用默认路径即可。
    1. 配置 API Key： 当提示输入 API Key 时，将您在第 3 步保存在记事本里的 sk- 开头的代码粘贴进去，按回车确认。

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


    1. 稍等 1分钟，脚本会自动处理所有复杂配置。访问浏览器127.0.0.1:18789?token=<gateway-token> 打开OpenClaw 的聊天界面时，恭喜您，部署成功！


    🔌第5步：安装浏览器拓展插件

    要让 OpenClaw 能够控制您的浏览器来完成任务，您需要安装两个配套的 Chrome 浏览器插件。

    5.1 进入扩展程序管理

    1. 打开 Chrome 浏览器，在地址栏输入 chrome://extensions 并按回车，进入扩展程序管理页面
    2. 或者，点击浏览器右上角的三个点 ⋮ -> “扩展程序” -> “管理扩展程序”。

    1. 在页面右上角，找到并打开“开发者模式”的开关。

    5.2 在 Chrome 中安装插件

    5.2.1 安装 OpenClaw Browser Relay插件

    1. 打开压缩包中浏览器拓展目录，将 OpenClaw Browser Relay 2026.2.26.crx 文件拖拽到刚刚打开的 Chrome 扩展程序页面中。


    1. 安装后，插件会自动打开一个配置页面。在 “Gateway token” 输入框中，输入您在第4步设置的 Token (例如 123456)，然后点击 Save。
    1. 将插件固定到浏览器工具栏。如果插件图标显示为红色并有 ON 字样，出现“OpenClaw Browser Relay”已开始调试此浏览器，表示连接成功。
    1. 安装成功！

    5.2.2 安装 openclaw-copilot 插件

    1. 打开压缩包中浏览器拓展目录，将 3. 浏览器拓展 文件夹中的 openclaw-copilot.crx 文件拖拽到 Chrome 扩展程序页面中，并点击“添加扩展程序”。
    1. 将 OpenClaw Copilot 插件也固定到浏览器工具栏。

    1. 将插件固定在浏览器拓展槽中

    1. 点击工具栏上的 OpenClaw Copilot 图标，侧边栏会弹出。点击设置按钮（齿轮图标）或 "Configure Settings"。

    1. 在 Gateway Access 部分，找到 Gateway Token 输入框，同样输入您设置的 Token (例如 123456)，然后点击 Connect。当 Snapshot 部分的 STATUS 变为绿色的 Connected 时，代表配置成功。

    1. 现在点击 Chat 选项卡，您就可以在侧边栏与 OpenClaw 对话了。至此，全部安装配置完成！

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

    6.1 如何访问 OpenClaw？

    如果您不小心关闭了网页，或者下次开机想要使用，请在浏览器地址栏输入以下网址手动访问：
    http://127.0.0.1:18789/?token=您设置的凭证
    (注意：请将“您设置的凭证”替换为您在安装时设置的密码，例如 123456)

    6.2 常用后台管理命令

    如需启动或停止服务，请打开命令行终端，并进入您的工程目录（Windows 通常在 C:\Users\您的用户名\openclaw-docker，Linux/Mac 通常在 ~/openclaw-docker）：
    • ▶️ 启动 OpenClaw (电脑重启后或服务停止后使用)：
    docker compose up -d
    • ⏹️ 停止 OpenClaw：
    docker compose down
    • 📋 查看运行日志 (用于排查故障)：
    docker logs openclaw-gateway

    ❓ 常见问题排查 (FAQ)

    问：在 Windows 下双击 import.bat，黑窗口一闪而过就消失了？
    答： 这通常是因为文件夹所在的路径包含了中文字符。请将整个 openclaw-deploy 文件夹移动到纯英文的路径下（例如直接放在 D:\openclaw 目录下），然后重试。
    问：打开网页后提示 "401" 错误，或者模型加载失败怎么办？
    答： 这通常代表 API Key 没填对。
    1. 请在 openclaw-docker 文件夹中找到 .env 文件，右键选择用记事本打开。
    2. 找到 API_KEY= 这一行，将等号后面的值改成正确的 Key，然后保存并关闭记事本。
    3. 打开命令行进入该目录，依次执行 docker compose down 和 docker compose up -d 重启服务即可生效。
    问：我修改了 .env 配置文件，为什么没生效？
    答： 简单的重启命令无法加载新的配置文件。您必须先彻底停止服务 (docker compose down)，然后再重新启动 (docker compose up -d)，新配置才会被系统读取。
    问：我想修改我的登录网页密码 (Token)，怎么操作？
    答： 与修改 API Key 的方法完全相同。用记事本打开 .env 文件，找到 OPENCLAW_GATEWAY_TOKEN= 这一行，修改等号后面的值并保存。最后一定要记得执行 docker compose down 和 docker compose up -d 重启服务。

    🎉 恭喜您！至此您已成功掌握了 容器化OpenClaw 的部署和基本使用方法。



    estoriginalRemove