OpenClaw 集成至飞书构建自动化办公智能体

2. 添加能力：在应用详情页点击'添加应用能力'，选择'机器人'。

3. 获取凭证：在'凭证与基础信息'中记录 App ID 和 App Secret；在'事件与回调'中记录 Verification Token。

4. 开通权限：在'权限管理'中，根据业务需求开通'应用身份权限'及'用户身份权限'。

5. 发布版本：点击'版本管理与发布'，创建并发布一个版本。注意：只有发布后的应用才能配置事件回调。

步骤 4：OpenClaw 通道配置

回到 EC2 终端，将获取的凭证配置到 OpenClaw 中，并启用长连接模式：

# 设置应用信息
openclaw config set channels.feishu.appId "您的 AppID"
openclaw config set channels.feishu.appSecret "您的 AppSecret"
openclaw config set channels.feishu.verificationToken "您的 VerificationToken"

# 修改配置后，需要重启 docker，更新 gateway
# 查找 openclaw 的 container id
docker ps
# 重启 docker，更新 gateway
docker restart <container id>

# 启用并配置 WebSocket 通道
openclaw config set channels.feishu.enabled true
openclaw config set channels.feishu.connectionMode "websocket"
openclaw config set channels.feishu.domain "feishu"
openclaw config set channels.feishu.dmPolicy "open"
openclaw config set channels.feishu.groupPolicy "open"
openclaw config set channels.feishu.requireMention false

可以通过查看配置文件检查是否配置成功。默认 openclaw 的配置文件在 /home/ubuntu/.openclaw/openclaw.json。

步骤 5：配置飞书事件订阅

回到飞书开放平台'事件与回调'页面：

• 事件配置：
  • 选择订阅方式为'长连接'
  • 加事件：搜索并添加 im.message.receive_v1（接收消息 v2.0），以允许机器人接收用户消息。

• 回调配置：
  • 选择订阅方式为'长连接'

实测与验收

在飞书客户端搜索您创建的机器人名称（如 Bot_Mars），直接发送消息（如'深圳天气如何'）。如果配置正确，OpenClaw 将调用 Bedrock 模型处理请求并返回结果。

注意：第一次和机器人对话时，如果出现如下回复，说明飞书插件已经正常工作了，需要进行授权配对，在 EC2 实例上执行命令，即可。

openclaw pairing approve feishu <pairing code>

常见问题排查与注意事项

1. 如果在连接过程中出现失败，请检查以下内容：

• 进程冲突：确保没有多个网关进程（如 clawdbot-gateway 和 openclaw-gateway）同时运行，这会导致端口占用和连接失败。
• 版本匹配：确保 OpenClaw 版本与插件版本兼容。

常用排查命令如下：

# 查看到当前 OpenClaw 进程实际占用的端口号
netstat -tunlp | grep openclaw
# 强制重启（解决端口冲突）
openclaw gateway stop && sleep 2 && openclaw gateway start
# 清理进程
pkill -f "openclaw.*gateway"
pkill -f "clawdbot-gateway"
# 检查端口占用
lsof -i :18789

# 验证配置完整性
openclaw config get channels.feishu | jq '.'
# 检查必需参数
echo "检查配置完整性："
openclaw config get channels.feishu.appId
openclaw config get channels.feishu.appSecret
openclaw config get channels.feishu.verificationToken
openclaw config get channels.feishu.enabled

# 关键成功指标
# 成功的日志标志
grep "feishu: WebSocket client started" /tmp/openclaw/openclaw-2026-02-03.log
grep "feishu: bot open_id resolved" /tmp/openclaw/openclaw-2026-02-03.log
grep "ws client ready" /tmp/openclaw/openclaw-2026-02-03.log

2. 确保 OpenClaw 机器人能正常接收用户输入并回传对话内容：

• 应用身份权限：接收单聊消息 (im:message.p2p_msg:readonly)、接收群聊消息 (im:message.group_at_msg:readonly)、以应用身份发送消息 (im:message:send_as_bot)、获取单聊、群聊消息记录 (im:message.p2p_msg:readonly, im:message.group_msg:readonly)
• 用户身份权限：获取用户基本信息 (contact:user.base:readonly)、获取用户 ID (contact:user.employee_id:readonly)