OpenClaw 接入飞书机器人完整教程(Docker 部署版)

本教程适用于使用 Docker 方式部署 OpenClaw 的用户，在飞书聊天窗口直接向 AI 下达指令

背景说明

本教程基于 Docker 部署的 OpenClaw环境编写，所有命令都已适配 Docker 容器化场景：

• OpenClaw 运行在 Docker 容器中（容器名：openclaw-gateway）
• 配置目录：/opt/openclaw/
• 所有 openclaw命令需通过 docker exec -it openclaw-gateway执行
• 环境变量通过 .env文件和 docker-compose.yml配置

如果你尚未部署 OpenClaw，请先参考《2核2G服务器玩转OpenClaw:Docker安全部署完全指南》完成基础部署。

一、飞书开放平台配置

1.1 创建企业自建应用

1. 访问 飞书开放平台，用飞书账号扫码登录
2. 点击「开发者后台」→「创建企业自建应用」
3. 填写应用名称（如"OpenClaw助手"）、描述，上传图标
4. 点击「创建」

1.2 添加机器人能力

在应用管理页面，点击「添加应用能力」→ 选择「机器人」→ 点击「添加」

1.3 获取应用凭证

在左侧菜单「凭证与基础信息」中，复制并保存：

• App ID（格式如 cli_xxx）
• App Secret

⚠️ 妥善保管，后续会用到

1.4 配置权限

在「权限管理」页面，点击「批量导入权限」，粘贴以下 JSON：

{"scopes": {"tenant": ["im:message","im:message:readonly","im:message:send_as_bot","im:message.group_at_msg:readonly","im:message.p2p_msg:readonly","im:chat","im:chat:readonly","im:chat.members:bot_access","im:resource","contact:user.base:readonly"    ]  }}

点击「确认开通」。

1.5 配置事件订阅

1. 进入「事件与回调」页面
2. 订阅方式选择「长连接接收事件」
3. 点击「添加事件」，搜索并添加「接收消息 v2.0」（im.message.receive_v1）
4. 点击「保存」

💡 使用长连接（WebSocket）模式无需公网域名，适合 Docker 部署环境

二、OpenClaw Docker 配置

2.1 设置环境变量

编辑 /opt/openclaw/.env文件：

cd /opt/openclawnano .env

添加以下内容：

FEISHU_APP_ID=cli_你的AppIDFEISHU_APP_SECRET=你的AppSecret

2.2 修改 docker-compose.yml

nano /opt/openclaw/docker-compose.yml

在 environment:部分添加：

environment:-NODE_ENV=production-LOG_LEVEL=info-OPENCLAW_GATEWAY_TOKEN=${OPENCLAW_TOKEN}-FEISHU_APP_ID=${FEISHU_APP_ID}-FEISHU_APP_SECRET=${FEISHU_APP_SECRET}

2.3 配置飞书渠道

# 进入容器docker exec -it openclaw-gateway sh# 配置飞书openclaw config set channels.feishu.enabled trueopenclaw config set channels.feishu.appId ${FEISHU_APP_ID}openclaw config set channels.feishu.appSecret ${FEISHU_APP_SECRET}openclaw config set channels.feishu.connectionMode websocketopenclaw config set channels.feishu.dmPolicy pairingopenclaw config set channels.feishu.groupPolicy allowlistopenclaw config set channels.feishu.requireMention true# 退出容器exit

2.4 重启容器

cd /opt/openclawdocker compose downdocker compose up -d

2.5 验证容器状态

docker compose ps# 应显示 Up 状态docker compose logs --tail=30# 应看到 feishu 相关日志

三、发布应用

1. 返回飞书开放平台
2. 点击「版本管理与发布」
3. 点击「创建版本」，填写版本号和更新说明
4. 点击「保存」→「确认发布」
5. 等待审核（企业自建应用通常自动通过）

四、配对与测试

4.1 在飞书中找到机器人

打开飞书客户端，在搜索栏输入应用名称，找到你的机器人。

4.2 发送消息触发配对

向机器人发送任意消息（如"你好"），机器人会回复一条配对请求，包含配对码。

4.3 批准配对

# 查看待配对请求docker exec -it openclaw-gateway openclaw pairing list# 批准配对（替换为实际的配对码）docker exec -it openclaw-gateway openclaw pairing approve <配对码>

4.4 验证

配对成功后，在飞书中再次向机器人发送消息，应该能收到 AI 的正常回复。

五、Docker 环境常用命令

六、群聊配置（可选）

如果需要机器人在群聊中响应：

docker exec -it openclaw-gateway shopenclaw config set channels.feishu.groupPolicy openopenclaw config set channels.feishu.requireMention trueexitcd /opt/openclaw && docker compose restart

群聊中机器人会在被 @时回复。

七、常见问题排查（Docker 特定）

八、安全建议

完成以上配置后，你就可以在飞书中直接与 OpenClaw AI 对话了！🚀