究极无敌小白自用 Docker 安装 OpenClaw（MAC）

开发调优
,
1

1. 拉取源码并执行一键脚本

git clone https://github.com/openclaw/openclaw.git

cd openclaw

./docker-setup.sh

2. 安装完成后访问控制台

  • 打开：http://127.0.0.1:18789/
  • 按脚本输出，把 token（详情看 6. 常见问题） 填到 Control UI 的 Settings -> token

3. 需要重新拿 Dashboard 链接时

docker compose run --rm openclaw-cli dashboard --no-open

4. 模型载入/修改

~/.openclaw/openclaw.json
增加 "models:{}"

baseUrl 填入公益站的地址
apiKey 填入对应公益站的key

image
image1312×844 89.9 KB

修改后检查：

docker compose run --rm openclaw-cli doctor
docker compose run --rm openclaw-cli models status

一般会热加载生效；若未生效再重启：

docker compose restart openclaw-gateway

5.常用 Docker 命令


# 启动网关
docker compose up -d openclaw-gateway

# 查看日志
docker compose logs -f openclaw-gateway

# 停止
docker compose down

6. 常见问题

token 是 安装时自动生成 的，不是你手动创建的。

Docker 场景下来源有两个位置（本质同一个）：

  1. ./docker-setup.sh 运行时生成，并写入项目根目录 .env（通常是
    OPENCLAW_GATEWAY_TOKEN）
  2. Gateway 配置里的 gateway.auth.token

你可以直接取：

在 openclaw 仓库根目录执行

docker compose run --rm openclaw-cli config get gateway.auth.token

也可以看 .env：

grep OPENCLAW_GATEWAY_TOKEN .env

拿到后粘贴到 Control UI：Settings -> token。
如果丢了可重新生成：

docker compose run --rm openclaw-cli doctor --generate-gateway-token

出现 unauthorized / disconnected (1008): pairing required：

docker compose run --rm openclaw-cli devices list

docker compose run --rm openclaw-cli devices approve <requestId>
23 个赞
2

感谢佬友分享教程！

1 个赞
3

感谢佬的教程

1 个赞
4

感谢佬，请问只适用于mac吗

5

理论上只有有docker且配置足够的情况下什么机器都可以 我电脑是mac的 所以标明一下

6

感谢大佬 ！

1 个赞
7

大佬，我也是mac，然后docker里面安装了cpa、openclaw，现在openclaw访问不到cpa，我尝试过http://host.docker.internal:8317/v1，也是无法解析到

8

贴一下你的openclaw.json看一下

9

image
image1086×1288 96.1 KB

感谢佬回复，我没对json文件做任何修改，只是刚从git clone下来，然后./docker-setup.sh，进入了openclaw的配置（我的cherry studio这些能访问到cpa，cpa是正常运行的）

10

更可能是代理/容器网络差异 Cherry Studio 在宿主机跑 OpenClaw 在 Docker 里跑 宿主机能访问的 127.0.0.1:xxxx，容器里通常访问不到

11

最简单的一个方法 你可以用你的本地cli直接帮你处理这个openclaw的问题

12

感觉确实是代理、网络差异，我现在解决思路就是怎么让他们处于同一个网络，我自己再看下，谢谢佬

13

谢谢佬，实测win docker安装成功

14

启动成功了，在宿主机访问不了http://127.0.0.1:18789/，系统mac m2

15

佬友你的这个问题解决了吗？我是想docker访问局域网的模型，也遇到了同样的问题

16

没解决，后面我的解决办法是把openclaw安装在虚拟机里面，用orbstack，不用docker部署openclaw。

17

如果cpa也是跑在docker的，可以试试直接用cpa 的容器名称，比如http://cpa:8317/v1

18

感谢佬的回复，有机会试试佬说的办法，不过我现在已经把openclaw安装在虚拟机了，通过局域网ip访问的docker-cpa，也挺丝滑

19

LiNFERSmark～～～

20

试试看看成色