MacOS 基于 Docker 部署 OpenClaw 并集成飞书机器人

配置飞书机器人

打开飞书开放平台

访问 飞书开放平台 进行后续操作。

创建应用

进入开发者后台，点击创建自建应用。

创建机器人

在应用管理中添加应用能力，选择机器人。

权限管理

批量导入所需的权限范围。可以参考官方文档或直接使用以下 JSON 配置：

{
 "scopes": {
  "tenant": [
   "aily:file:read",
   "aily:file:write",
   "aily:session:read",
   "aily:session:write",
   "application:application.app_message_stats.overview:readonly",
   "application:application.self_manage",
   "application:bot.menu:write",
   "bitable:app",
   "bitable:app:readonly",
   "board:whiteboard:node:create",
   "board:whiteboard:node:delete",
   "board:whiteboard:node:read",
   "board:whiteboard:node:update",
   "cardkit:card:write",
   "contact:contact.base:readonly",
   "contact:user.base:readonly",
   "contact:user.employee_id:readonly",
   "corehr:file:download",
   "docs:doc",
   "docs:doc:readonly",
   "docs:document.comment:create",
   "docs:document.comment:read",
   "docs:document.comment:update",
   "docs:document.comment:write_only",
   "docs:document.content:read",
   "docs:document.media:download",
   "docs:document.media:upload",
   "docs:document.subscription",
   "docs:document.subscription:read",
   "docs:document:copy",
   "docs:document:export",
   "docs:document:import",
   "docs:event.document_deleted:read",
   "docs:event.document_edited:read",
   "docs:event.document_opened:read",
   "docs:event:subscribe",
   "docs:permission.member",
   "docs:permission.member:auth",
   "docs:permission.member:create",
   "docs:permission.member:delete",
   "docs:permission.member:readonly",
   "docs:permission.member:retrieve",
   "docs:permission.member:transfer",
   "docs:permission.member:update",
   "docs:permission.setting",
   "docs:permission.setting:read",
   "docs:permission.setting:readonly",
   "docs:permission.setting:write_only",
   "docx:document",
   "docx:document.block:convert",
   "docx:document:create",
   "docx:document:readonly",
   "docx:document:write_only",
   "drive:drive",
   "drive:drive.metadata:readonly",
   "drive:drive.search:readonly",
   "drive:drive:readonly",
   "drive:drive:version",
   "drive:drive:version:readonly",
   "drive:export:readonly",
   "drive:file",
   "drive:file.like:readonly",
   "drive:file.meta.sec_label.read_only",
   "drive:file:download",
   "drive:file:readonly",
   "drive:file:upload",
   "drive:file.view_record:readonly",
   "event:ip_list",
   "im:chat",
   "im:chat.access_event.bot_p2p_chat:read",
   "im:chat.members:bot_access",
   "im:message",
   "im:message.group_at_msg:readonly",
   "im:message.group_msg",
   "im:message.p2p_msg:readonly",
   "im:message:readonly",
   "im:message:send_as_bot",
   "im:resource",
   "sheets:spreadsheet",
   "sheets:spreadsheet.meta:read",
   "sheets:spreadsheet.meta:write_only",
   "sheets:spreadsheet:create",
   "sheets:spreadsheet:read",
   "sheets:spreadsheet:readonly",
   "sheets:spreadsheet:write_only",
   "slides:presentation:create",
   "slides:presentation:read",
   "slides:presentation:update",
   "slides:presentation:write_only",
   "space:document.event:read",
   "space:document:delete",
   "space:document:move",
   "space:document:retrieve",
   "space:document:shortcut",
   "space:folder:create",
   "wiki:member:create",
   "wiki:member:retrieve",
   "wiki:member:update",
   "wiki:node:copy",
   "wiki:node:create",
   "wiki:node:move",
   "wiki:node:read",
   "wiki:node:retrieve",
   "wiki:node:update",
   "wiki:setting:read",
   "wiki:setting:write_only",
   "wiki:space:read",
   "wiki:space:retrieve",
   "wiki:space:write_only",
   "wiki:wiki",
   "wiki:wiki:readonly"
  ],
  "user": [
   "aily:file:read",
   "aily:file:write",
   "im:chat.access_event.bot_p2p_chat:read"
  ]
 }
}

事件与回调

为了接收消息，需要使用长链接。创建一个 Python 环境来运行监听脚本：

conda create -n py38 python=3.8
conda activate py38
pip install lark-oapi -U

编写 feishu_ws.py 脚本用于处理消息接收：

import lark_oapi as lark

# P2ImMessageReceiveV1 为接收消息 v2.0；CustomizedEvent 内的 message 为接收消息 v1.0。
def do_p2_im_message_receive_v1(data: lark.im.v1.P2ImMessageReceiveV1) -> None:
    print(f'[ do_p2_im_message_receive_v1 access ], data: {lark.JSON.marshal(data, indent=4)}')

def do_message_event(data: lark.CustomizedEvent) -> None:
    print(f'[ do_customized_event access ], type: message, data: {lark.JSON.marshal(data, indent=4)}')

event_handler = lark.EventDispatcherHandler.builder("", "") \
    .register_p2_im_message_receive_v1(do_p2_im_message_receive_v1) \
    .register_p1_customized_event("这里填入你要自定义订阅的 event 的 key，例如 out_approval", do_message_event) \
    .build()

def main():
    cli = lark.ws.Client("配置成应用的 App Id", "配置成应用的 App Secret", event_handler=event_handler, log_level=lark.LogLevel.DEBUG)
    cli.start()

if __name__ == "__main__":
    main()

启动长链接服务：

python feishu_ws.py

启动成功后，回到飞书开放平台，'事件配置'与'回调配置'中的'保存'按钮即可点击。

在'事件配置'中，添加所有'消息与群组'相关事件：

在'回调配置'中，添加所有回调地址：

新建版本

完成配置后发布新版本。发布成功后，飞书会收到审批通过通知，打开应用即可看到机器人聊天对话框。

启用飞书插件

在 OpenClaw 容器内启用飞书通道插件：

◇ Select channel (QuickStart) │ Feishu/Lark (飞书)
◇ Install Feishu plugin? │ Download from npm (@openclaw/feishu)
...
Installing to /root/.openclaw/extensions/feishu…
...
◇ Feishu credentials ──────────────────────────────────────────────────────────────╮
│ 1) Go to Feishu Open Platform (open.feishu.cn)
│ 2) Create a self-built app
│ 3) Get App ID and App Secret from Credentials page
│ 4) Enable required permissions: im:message, im:chat, contact:user.base:readonly
│ 5) Publish the app or add it to a test group
│ Tip: you can also set FEISHU_APP_ID / FEISHU_APP_SECRET env vars.
├───────────────────────────────────────────────────────────────────────────────────╯
◇ Enter Feishu App Secret │ XXXXXXXXXXXXXXXXXXXX
◇ Enter Feishu App ID │ XXXXXXXXXXXXXXXX
[info]: [ 'client ready' ]
◇ Feishu connection test ───────────────────────────╮
│ Connected as ou_XXXXXXXXXXX
├────────────────────────────────────────────────────╯
◇ Feishu connection mode │ WebSocket (default)
◇ Which Feishu domain? │ Feishu (feishu.cn) - China
◇ Group chat policy │ Open - respond in all groups (requires mention)
◇ Selected channels ──────────────────────────────────────────╮
│ Feishu — 飞书/Lark enterprise messaging. Docs: feishu
├──────────────────────────────────────────────────────────────╯
Config warnings: - plugins.entries.feishu: plugin feishu: duplicate plugin id detected; later plugin may be overridden (/root/.openclaw/extensions/feishu/index.ts)
Updated ~/.openclaw/openclaw.json
Workspace OK: ~/.openclaw/workspace
Sessions OK: ~/.openclaw/agents/main/sessions

其他配置

默认先选"no"或"skip"，后续可根据需求调整 Skills 和 Hooks。

◇ Configure skills now? (recommended) │ No
◇ Enable hooks? │ Skip for now
◇ Gateway service │ Use your container supervisor or docker compose up -d.
◇ Dashboard ready ────────────────────────────────────────────────────────────────╮
│ Dashboard link (with token): http://127.0.0.1:18789/#token=xxxxxxx
│ Copy/paste this URL in a browser on this machine to control OpenClaw.
├───────────────────────────────────────────────────────────────────────────────────╯
◇ What now ─────────────────────────────────────────────────────────────╮
│ What now: https://openclaw.ai/showcase ("What People Are Building").
└ Onboarding complete. Use the dashboard link above to control OpenClaw.

启动容器

如果之前停止了容器，请重新启动：

docker start openclaw

启动 Gateway

进入容器内部启动网关服务：

docker exec -it openclaw openclaw gateway run

使用 TUI 对话

容器内对话

在 Docker 桌面版——Containers——点击 openclaw 这个 container——Exec——运行：

openclaw tui

新开终端对话

也可以直接在宿主机终端通过 exec 命令进入对话：

docker exec -it openclaw openclaw tui

完成飞书配对

发起配对

回到飞书与机器人聊天，会提示需要配对。

确认配对

在 Docker 的 Container 终端内运行配对命令：

openclaw pairing approve feishu CZQCNKEG

验证成功

回到飞书继续聊天，此时机器人应能正常响应，大功告成！

总结

本教程完整覆盖了 MacOS 系统下，基于 Docker 部署 OpenClaw 并完成飞书机器人集成的全流程操作。核心逻辑是依托 Docker 实现标准化环境部署，规避系统兼容问题，再通过大模型 API 配置赋予工具 AI 核心能力，最后对接飞书开放平台实现办公场景落地。

从实操关键点来看，Docker 环境正常启动、大模型 API 信息准确、飞书长链接稳定运行、权限配置完整、两端成功配对是整个部署流程的核心要点。新手操作时需重点关注长链接启动后再保存飞书配置、权限批量导入完整、容器全程保持运行这几个细节。

完成全部部署后，OpenClaw 飞书 AI 机器人即可正常投入使用，实现飞书端的 AI 对话、信息查询、任务处理等功能。整体部署流程门槛较低，无需深厚的运维和开发基础，能够快速帮助个人和团队实现 AI 办公能力的轻量化落地。