MAC 容器化部署 Openclaw V2026-03-24

MAC 容器化部署 Openclaw V2026-03-24

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


升级说明
如果您已经安装过早期版本的 OpenClaw，本次升级无需重复安装 Docker、浏览器及浏览器插件。您只需下载最新的安装包，按照“第4步：一键自动部署”中的方法，运行新的安装脚本即可。脚本会自动检测并备份您现有的个人技能和配置文件，然后将容器环境升级到最新版本。整个升级过程简单快捷，您的数据将得到妥善保留。
Warning
在openclaw3.24版本中，openclaw操作浏览器方式由安装 OpenClaw Browser Relay，变更为独立谷歌浏览器，如果您已经安装过早期版本的 OpenClaw，后续使用openclaw控制浏览器时请先打开桌面的 “chrome(小龙虾)”

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

首先，我们需要准备好安装包和合适的浏览器。
  1. 下载安装包：
    1. 点击下方百度网盘链接下载 OpenClaw 安装包，并解压到您的电脑中。
    2. 下载链接: https://pan.baidu.com/s/13b5dR9eAP2v5sa7Ilohewg?pwd=qf77
    3. 提取码: BGAI
  2. 选择系统版本：打开安装包文件夹，可根据您电脑的处理器类型（Apple M系列或 Intel），找到对应的文 件夹下载

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

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

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

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

OpenClaw 运行在一个名为 Docker 的“容器”环境中，这能确保程序稳定运行且不影响您的电脑系统。
  1. 在解压的部署包中，进入“ 1. docker-desktop安装“ 文件夹。
  2. 以mac os 13为例：选择” Docker-apple-4.6.1.dmg“


  1. 双击打开 .dmg 文件，将 Docker 图标拖拽到 “Applications” 文件夹中即可。
  2. 安装完成后，请从“应用程序”中启动 Docker Desktop。首次启动根据提示操作，选择 “Continue without signing in” 即可。
直到左下角任务栏出现它的图标，并显示为运行中状态。

⚡ 第 4 步：一键自动部署

  1. 选择系统版本：打开安装包文件夹，根据您电脑的处理器类型（Apple M系列或 Intel），找到对应的文件夹进入


  1. 执行脚本：打开“openclaw-安装”文件夹，找到名为“安装.command”的文件，使用右键点击并选择“打开”来运行该脚本 。
💡 注意：如果系统弹窗提示无法执行，请打开旁边的“安装说明.txt”文件，按照指引前往 Mac 的“系统设置 > 隐私与安全性”中批准此脚本运行 。


  1. 选择安装路径：脚本运行后，首先会询问您“数据文件存放位置” 。如果您不熟悉路径配置，直接按回车键使用默认路径即可 。

  1. 选择数据目录：随后，脚本会提示您选择数据目录的父路径，如果您不确定，直接按回车键使用默认路径即可。

  1. 配置 API Key：当终端提示输入 API Key 时，请将您事先保存好的（以 sk- 开头的代码）粘贴进去，并按回车键确认 。

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

  1. 自动配置：参数设置完毕后，请耐心稍等约 1 分钟，脚本会自动在后台为您处理所有复杂的环境配置 。
  1. 连接控制面板：当 OpenClaw 的网页界面自动弹出时，说明部署已经成功！在界面中的“网关令牌”输入框内，填入您刚才设置的 Gateway Token（默认：123456） 。

  1. 开始使用：点击红色的“连接”按钮，即可顺利进入 OpenClaw 的聊天界面，开始使用

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

要让 OpenClaw 能够控制您的浏览器来完成任务，您需要打开Chrome 浏览器 （小龙虾）。

5.1 进入桌面

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


🌐 第 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 的部署和基本使用方法。


如果在安装或使用 OpenClaw 过程中遇到任何问题，欢迎访问我们的帮助中心寻求支持。您可以注册帮助中心用户，并提交问题工单，我们的技术支持团队会及时为您解答。

    • Related Articles

    • windows 容器化部署 Openclaw V2026-03-24

      前言：本文档window系统是基于容器沙箱模式的 OpenClaw 安装教程，旨在为零基础的用户提供一份清晰、易于操作的指引。跟随本教程，您可以快速在个人电脑上部署并体验 OpenClaw 的强大功能。 当前版本：OpenClaw 3.24 安装包版本：3.24.20260324 升级说明 如果您已经安装过早期版本的 OpenClaw，本次升级无需重复安装 ...

    • windows 容器化部署 Openclaw V2026-03-13

      前言：本文档window系统是基于容器沙箱模式的 OpenClaw 安装教程，旨在为零基础的用户提供一份清晰、易于操作的指引。跟随本教程，您可以快速在个人电脑上部署并体验 OpenClaw 的强大功能。 当前版本：OpenClaw 3.13 安装包版本：3.13.20260319 升级说明 如果您已经安装过早期版本的 OpenClaw，本次升级无需重复安装 ...

    • MAC 容器化部署 Openclaw V2026-03-13

      前言：本文档是MAC电脑基于容器沙箱模式的 OpenClaw 安装教程，旨在为零基础的用户提供一份清晰、易于操作的指引。跟随本教程，您可以快速在个人电脑上部署并体验 OpenClaw 的强大功能。 当前版本：OpenClaw 3.13 安装包版本：3.13.20260319 🛠️ 第 1 步：下载与准备工作 首先，我们需要准备好安装包和合适的浏览器。 下载安装包： 点击下方百度网盘链接下载 OpenClaw 安装包，并解压到您的电脑中。 下载链接: ...

    • Mac容器版OpenClaw -配置飞书、钉钉、QQ、企业微信官方插件指引

      本文档适用于通过容器版 OpenClaw 配置飞书、企业微信、QQ、钉钉四个平台的企业自建应用或官方机器人，实现消息对接与智能交互。 一、准备工作 在开始配置之前，请确保： 已成功部署 OpenClaw 容器环境； 已下载并解压 OpenClaw 安装包（获取方式见下文）； 容器和龙虾服务已处于运行状态（打开容器，确保龙虾正常运行）。 下载安装包 点击下方百度网盘链接下载 OpenClaw 安装包中的tools文件夹，并解压到您的电脑中。 下载链接: ...

    • Windows容器版OpenClaw -配置飞书、钉钉、QQ、企业微信官方插件指引

      本文档适用于通过容器版 OpenClaw 配置飞书、企业微信、QQ、钉钉四个 IM 平台的企业自建应用，实现消息对接与智能交互。 一、准备工作 在开始配置之前，请确保： 已成功部署 OpenClaw 容器环境； 已下载并解压 OpenClaw 安装包（获取方式见下文）； 容器和龙虾服务已处于运行状态（打开容器，确保龙虾正常运行）。 下载安装包 点击下方百度网盘链接下载 OpenClaw 安装包中的tools文件夹，并解压到您的电脑中。 下载链接: ...