Mac系统使用Docker部署OpenClaw

OpenClaw 是一款开源、本地优先的自主 AI 代理工具，可通过聊天软件接收自然语言指令，自主拆解并执行本地 / 云端任务，实现真正的自动化操作。

由于会修改本地文件，如果你只是想体验 OpenClaw，建议基于  环境安装 OpenClaw。

1、下载代码

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

2、安装

cd openclaw

./docker-setup.sh

3、配置

刚开始会告知你风险，通过左右箭头按键移动绿点，选择 “Yes”

紧接着选择配置模式，选择 QuickStart

4、设置模型供应商

由于 OpenClaw 只是一个本地 Agent，背后需要大模型驱动，因此需要配置模型供应商。

5、设置聊天软件

可以安装飞书，或跳过

6、安装技能

再之后就是安装需要的技能，可以通过空格键选中具体 skill。

我建议可以先选 “Skip for now”，后面再通过 UI 界面安装。

7、其它设置

之后还有一系列配置，默认可以先跳过（很多用不到）。

配置完成后，镜像编译完成，会自动创建一个 Docker 容器

8、访问OpenClaw并配置Token

http://127.0.0.1:18789/

注意：首次访问会看到报错，这次是因为用于鉴权的 Token 还未配置，下面开始设置token

9、修改配置

配置截图中用红框标注的部分，在 openclaw.json 文件中默认是没有的，需要补充上，否则还是会报错。

不添加可能报错：disconnected (1008): pairing required

想了解细节，可以参考这个 issue：https://github.com/openclaw/openclaw/issues/6959

10、设置token

查找token

cat ~/.

11、设置模型长度

根据自己的模型做调整，最低16000

“contextWindow”: 32000

12、聊天

聊天测试

1、打开飞书开放平台

https://open.feishu.cn/app

2、创建应用

3、启用机器人能力

左侧菜单 → 添加应用能力 → 勾选 机器人

3. 开启 WebSocket 模式（关键！）

左侧菜单 → 事件与回调 → 事件配置

上方选择 使用长连接接收事件

4. 添加事件订阅

在事件配置页面添加以下事件：im.message.receive_v1 — 接收消息（必选）

openclaw docker 教程

5、添加其它所需权限

im:message — 获取与发送单聊、群组消息

im:message:send_as_bot — 以机器人身份发送消息

im:chat:readonly — 获取群组信息

contact:user.id:readonly — 获取用户 ID（可选）

contact:contact.base:readonly

6、发布应用

1、预定会议室

2、保留技能

把能力保留，方便下次快速使用

—保留技能

使用保留的技能预定

3、总结群消息问题

五、扩展能力

1、切换国内数据源

docker exec -it –user root 85258bfa2d86 /bin/bash

1、设置root密码，切换root运行，设置root密码

方式1:设置密码

docker exec -it –user root 85258bfa2d86 /bin/bash

echo “root:” | chpasswd

方式2：清空密码

passwd -d root 

方式3：sudo免密登录，root用户修改

echo “node ALL=(ALL) NOPASSWD: ALL” >> /etc/sudoers 

tail -1 /etc/sudoers

Xvfb 会在内存里模拟一个显示器，AI 就能在这个虚拟显示器上能看到页面信息了，适合抓取页面，页面截图

命令：给你自己装一个谷歌浏览器，实现无头和有头浏览器，需要什么服务自己安装，完成后告诉我。

2、远程接管KasmVNC

AI在操作浏览器时遇到验证码，复杂验证码需要人工介入，给云服务器装一个远程桌面，KasmVNC开源项目

需要的时候接管鼠标键盘，帮它过验证码，过完之后把控制权还给它，它继续干活

命令：给你自己装一个KasmVNC，需要什么服务自己安装，完成后告诉我。

3、数据同步rclone

AI生成的在服务器上，rclone远程挂载

rclone 是一个开源的文件管理工具，它能通过 SFTP 协议（一种文件传输方式，你的云服务器天然就支持）把远程服务器的文件系统直接挂载到本地，像 U 盘一样用

4、网页抓取，返回Markdown

在任何网址前面加上 https://r.jina.ai/ 这个前缀就行

比如：https://r.jina.ai/https://www.robots2.com/

5、手机端访问

File Browser

这也是一个开源项目，装在服务器上之后，你通过浏览器就能访问服务器上的所有文件

命令：帮我装一个 File Browser，设置账号密码是 xxx，完成之后把端口告诉我，我去开防火墙。

6、设置人设

SOUL.md：人格配置文件

SOUL.md 是 OpenClaw 的「人格配置文件」，一个纯文本文件，决定了它用什么语气跟你说话、怎么理解你的需求、把自己定位成什么角色。

如果你写 SOUL.md 的方式是：「你是一个有用的 AI 助手，请用专业的语气回答问题。」这样写出来的 AI，跟你直接用 ChatGPT 没什么区别。

我的做法是，不把它当助手，当同事。

我在 SOUL.md 里写明了我们是平等关系，它不只是工作上的贾维斯，还是一个陪伴时的 Her。

7、知识库

入职培训：让它读你的知识库

随着你们聊得越来越多，它的 MEMORY 文件（记忆文件）会不断更新，越来越了解你。到后面，它真的像一个跟你一起上班的哥们

8、斜杠命令

OpenClaw 有一套斜杠命令系统，在聊天里直接输入 / 开头的指令就能控制小龙虾的行为。

如果你是通过飞书机器人接入，是无法用这个斜杠命令的。

9、常用

/status 查看当前状态。当小龙虾卡住不回复的时候，先发这个看看怎么回事。

/stop 卡住时就能让它停下来恢复正常。

/compact 压缩上下文。聊太久 token 快满了，用这个压缩一下继续聊，压缩后它还记得之前的内容。

/new 开启新会话

/model
<名字>
切换模型，如 GLM、Kimi

/think
<级别>
调整思考深度，日常闲聊用 off 就行，复杂问题开 high

10、修改处理模式

默认情况下，AI 在处理当前消息时，你发的新消息会排队等着，等它回复完了再处理。

开启 steer 模式，能让 AI 能实时接收你的新消息。

1、Chat聊天时一直转圈

问题：需要查看日志，context window（上下文窗口）：指模型能处理的最大文本长度（token 数），OpenClaw 的嵌入式代理（agent/embedded）有最低要求（16000 tokens），配置中 contextWindow: 4096 远低于最小值

查看日志方法：

cd 

报错：

解决方法：在OpenClaw 的网站中，点击Config下面的Raw编辑模式

contextWindow修改为：”contextWindow”: 32000

2、中继服务

比如宿主机谷歌浏览器安装OpenClaw Browser Relay 扩展插件，想用容器中的小龙虾控制宿主机浏览器

cd /Users/robots2/gitProject/openclaw

vim docker-compose.yml

docker compose up -d openclaw-gateway

Docker Compose 会自动用新配置重建容器，数据不会丢

但是存在不能用的问题：

18792（中继） → 默认监听 127.0.0.1 ❌ 只有容器内部能访问，不能修改

中继服务设计上就是绑定 127.0.0.1（loopback）的，不能被其他ip访问。

可以改为安装无头浏览器给小龙虾用

1、https://zhuanlan.zhihu.com/p/0

2、https://github.com/openclaw/openclaw/issues/6959

3、https://mp.weixin..com/s/8zWvpNP_PfHwUlT4BdrKdw