MacOS 极简部署 OpenClaw：Docker 版 + 飞书集成

飞书配置

打开飞书开放平台

访问 飞书开放平台。

创建应用

创建机器人

进入应用—添加应用能力—机器人。

权限管理

批量导入权限，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"
  ]
 }
}

事件与回调

使用长链接接收事件。首先创建长链接环境：

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

编写 Python 脚本 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 的飞书插件：

◇ Channel status ────────────────────────────╮ │ │ │ Telegram: needs token │ │ WhatsApp (default): not linked │ │ Discord: needs token │ │ Slack: needs tokens │ │ Signal: needs setup │ │ signal-cli: missing (signal-cli) │ │ iMessage: needs setup │ │ imsg: missing (imsg) │ │ IRC: not configured │ │ Google Chat: not configured │ │ Feishu: install plugin to enable │ │ ... │ ├─────────────────────────────────────────────╯ │ ◇ Select channel (QuickStart) │ Feishu/Lark (飞书) │ ◇ Install Feishu plugin? │ Download from npm (@openclaw/feishu) ...

输入你的 App Secret 和 App ID 即可完成连接测试。

Skills 及其他配置

默认先选"no"或"skip"。

◇ Skills status ─────────────╮ │ │ │ Eligible: 7 │ │ Missing requirements: 41 │ │ Unsupported on this OS: 7 │ │ Blocked by allowlist: 0 │ │ ├─────────────────────────────╯ │ ◇ Configure skills now? (recommended) │ No │ ◇ Hooks ──────────────────────────────────────────────────────────────────╮ │ │ │ Hooks let you automate actions when agent commands are issued. │ │ Example: Save session context to memory when you issue /new or /reset. │ │ │ │ Learn more: https://docs.openclaw.ai/automation/hooks │ │ │ ├──────────────────────────────────────────────────────────────────────────╯ │ ◇ Enable hooks? │ Skip for now

注意观察 Gateway 状态，确保健康检查通过。

启动 openclaw 容器（container）

docker start openclaw

openclaw 容器内启动 gateway

docker exec -it openclaw openclaw gateway run

openclaw 容器内使用 tui 对话

docker 应用内对话

在 Docker Desktop 的 Containers 列表中找到 openclaw，点击 Exec，运行：

openclaw tui

新开终端对话

docker exec -it openclaw openclaw tui

openclaw 与飞书配对

回到飞书与机器人聊天

此时会提示需要配对。

在 docker 的 Container 终端内运行

复制飞书中的配对码，在终端执行：

openclaw pairing approve feishu CZQCNKEG

大功告成

回到飞书继续聊天，现在可以正常使用了。

总结

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

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

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