Mac系统使用Docker部署OpenClaw

一、介绍

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

由于会修改本地文件，如果你只是想体验 OpenClaw，建议基于 Docker 环境安装 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、修改配置

vim ~/.openclaw/openclaw.json

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

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

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

{
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "controlUi": { // 一定要添加
      "enabled": true,
      "allowInsecureAuth": true
    },
    "trustedProxies": ["192.168.65.0/24", "172.17.0.0/16"] // 我测试下来可选
  }
}

10、设置token

查找token

cat ~/.openclaw/openclaw.json

复制token内容，打开页面并配置token，配置后点击Connect连接

11、设置模型长度

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

"contextWindow": 32000

 

12、聊天

聊天测试

 

三、和飞书打通

1、打开飞书开放平台

https://open.feishu.cn/app

2、创建应用

3、启用机器人能力

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

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

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

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

4. 添加事件订阅

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

5、添加其它所需权限

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

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

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

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

contact:contact.base:readonly

im:message.group_msg

6、发布应用

四、样例

1、预定会议室

2、保留技能

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

/app/skills/ — OpenClaw 自带的技能
/app/extensions/ — 扩展插件的技能（如飞书相关）
/home/node/.openclaw/workspace/skills/ — 你自己创建或安装的技能

---保留技能

使用保留的技能预定

3、总结群消息问题

 

 

 

五、异常排查

1、Chat聊天时一直转圈

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

查看日志方法：

cd /Users/robots2/gitProject/openclaw

docker compose logs -f openclaw-gateway

报错：openclaw-gateway-1  | 2026-02-13T05:15:37.474Z [diagnostic] lane task error: lane=main durationMs=36 error="FailoverError: Model context window too small (4096 tokens). Minimum is 16000."

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

contextWindow修改为："contextWindow": 32000

 

 

N、参考文档

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

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