Mac mini 4 docker 安装openclaw

mac 通过docker 本地安装openclaw 教程

OpenClaw 不仅仅是一个聊天机器人，而是一个功能强大的 AI 智能体执行框架。你可以把它想象成一个能自主思考、调用工具、并替你完成复杂任务的数字员工。

1.环境准备

1.1安装Docker Desktop for mac

官网下载安装即可

docker 中设置加速地址

复制代码

  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "http://hub-mirror.c.163.com",
    "https://mirror.baidubce.com",
    "https://docker.mirrors.sjtug.sjtu.edu.cn"
  ]

1.2 拉取openclaw 镜像

这里会使用腾讯托管的镜像服务器拉取最新版本

复制代码

docker pull sgccr.ccs.tencentyun.com/openclaw/openclaw:latest

2.启动容器

复制代码

docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v openclaw-data:/data \
  sgccr.ccs.tencentyun.com/openclaw/openclaw:latest \
  openclaw gateway run --bind lan --port 18789 --allow-unconfigured

参数解释：

-d：后台运行容器。
--name openclaw：给容器命名，方便后续操作。
-p 18789:18789：将容器的 18789 端口映射到本机，用于访问 Web 控制台。
-v openclaw-data:/data：创建一个 Docker 卷 openclaw-data，挂载到容器内的 /data 目录，用于持久化配置和状态。
openclaw gateway run ...：容器启动后执行的命令，以网关模式运行，监听所有网络接口（--bind lan），端口 18789，允许未完全配置的状态下启动（--allow-unconfigured）。

3.首次访问并获取token

在浏览器中访问 http://localhost:18789，你会看到 OpenClaw 的仪表板页面，但状态显示为"Disconnected"，并提示需要 Token

复制代码

docker exec openclaw openclaw config get gateway.auth.token

3.1 获取token

使用默认token 会打印出一长串数字

例如 ed0904424aca*******0562a93847c142684339138a7），复制保存，后续需要用到。

在浏览器内输入上面的token，然后点击connect

此时可能会遇到两种错误：

pairing required：表示设备需要配对，见下一节。
control ui requires device identity ：确保你使用的是 http://localhost:18789 而非 IP 地址，否则浏览器会因安全策略阻止连接。

3.2 解决配对问题

进入容器，确保docker 内openclaw 运行中

复制代码

docker exec -it openclaw sh

然后输入

复制代码

openclaw devices list

会出现一个等待配对请求，其中包含一个本地ip请求类似下面

复制代码

Pending (2)
┌──────────────────────────────────────┬───────────────────────────────────┬──────────┬──────────────┐
│ Request                              │ Device                            │ Role     │ IP           │
├──────────────────────────────────────┼───────────────────────────────────┼──────────┼──────────────┤
│ a66fb94c-***-***2c4c21241c72 │ d53730f4722d2f9867ff6f0bbb70d2f8... │ operator │ 192.168.65.1 │

使用

复制代码

openclaw devices approve 请求id（上面的第一列）或设备id（上面的第二列）

后容器自动停止，需要手动启动

3.3 添加ai 模型提供商

desktop 内启动openclaw

然后终端中运行下面命令进入openclaw

复制代码

docker exec -it openclaw sh

openlaw 常用命令

复制代码

openclaw                    # 启动 OpenClaw
openclaw onboard            # 初始化向导
openclaw dashboard          # 打开网页控制台
openclaw config             # 查看/修改配置
openclaw skills             # 管理技能
openclaw --help             # 查看帮助

然后使用

复制代码

openclaw onboard

配置选择模型即可，

成功后即可聊天玩耍起来了

参考

https://libin9ioak.blog.csdn.net/article/details/157876493

https://blog.csdn.net/weixin_41905135/article/details/158346643

https://github.com/MaoTouHU/OpenClawChinese/blob/main/docs/INSTALL_GUIDE.md