一、核心背景

在企业自动化办公场景中，将 OpenClaw（原 Moltbot）抓取/自动化工具与飞书机器人集成，可实现信息推送、智能问答、任务自动化等能力。

前置说明：若未在 AWS EC2 部署 OpenClaw，需先参考《OpenClaw(Moltbot) + Amazon Bedrock 构建企业级全能 Agent 实战指南》完成基础部署。
https://blog.csdn.net/weixin_54534961/article/details/158496690?spm=1001.2014.3001.5502

二、集成操作步骤

步骤 1：检查并升级 OpenClaw 版本

# 查看当前版本及安装路径
openclaw --version
which openclaw

# 版本要求：低于 1.0 需升级至 2.1 及以上（参考官方升级文档）

步骤 2：安装飞书专用插件

# 检查插件状态
openclaw plugins list | grep feishu
# 存在启用官方版飞书插件，不存在安装
openclaw plugins enable feishu

# 安装飞书插件
openclaw plugins install @m1heng-clawd/feishu

# 验证插件加载状态（需显示 loaded）
openclaw plugins list

步骤 3：飞书开放平台配置

1. 创建应用：登录飞书开放平台 → 开发者后台 → 创建「企业自建应用」（如 Bot_Mars）。
   

2. 添加能力：应用详情页 → 添加应用能力 → 选择「机器人」。
   

3. 获取凭证：

   • 凭证与基础信息：记录 App ID、App Secret；
   • 事件与回调：记录 Verification Token。
     

4. 开通权限：权限管理页，按需开通「应用身份权限」「用户身份权限」（详见文末权限清单）。

6. 发布版本：版本管理与发布 → 创建并发布版本（仅发布后可配置事件回调）。
   

步骤 4：OpenClaw 飞书通道配置

{
  "models": {
    "mode": "merge",
    "providers": {
      "deepseek": {
        "baseUrl": "https://api.deepseek.com/v1",
        "apiKey": "${DEEPSEEK_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "deepseek-chat",
            "name": "DeepSeek Chat",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 128000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {"primary": "deepseek/deepseek-chat"},
      "compaction": {"mode": "safeguard"}
    }
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto",
    "restart": true
  },
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "lan",
    "controlUi": {"allowInsecureAuth": true},
    "auth": {
      "mode": "token",
      "token": "xxxxxx"
    }
  },
  "plugins": {
    "entries": {"feishu": {"enabled": true}},
    "allow": ["feishu"] 
  },
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "xxxx",
      "appSecret": "xxxx",
      "verificationToken": "xxxxxx",
      "connectionMode": "websocket",
      "domain": "feishu"
    }
  },
  "meta": {
    "lastTouchedVersion": "2026.2.19",
    "lastTouchedAt": "2026-02-28T09:46:54.630Z"
  }
}

# 配置飞书应用基础信息
openclaw config set channels.feishu.appId "您的AppID"
openclaw config set channels.feishu.appSecret "您的AppSecret"
openclaw config set channels.feishu.verificationToken "您的VerificationToken"

# 启用并配置 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 config get channels.feishu | jq '.'

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

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

1. 事件配置：
   • 订阅方式：选择「长连接」；
   • 添加事件：搜索并订阅 im.message.receive_v1（接收消息 v2.0）。
2. 回调配置：订阅方式选择「长连接」。

四、实测验收

1. 飞书客户端搜索机器人名称（如 Bot_Mars）；
2. 发送测试消息（如「深圳天气如何」）；
3. 验证结果：OpenClaw 调用 Bedrock 模型处理并返回回复，即配置成功。

五、问题排查与注意事项

1. 常见故障排查

问题类型	排查点 & 解决命令
进程冲突（端口占用）	1. 查看 OpenClaw 端口占用：`netstat -tunlp
版本不兼容	确保 OpenClaw 版本与飞书插件版本匹配
配置缺失	验证核心配置： openclaw config get channels.feishu.appId openclaw config get channels.feishu.enabled

2. 日志验证（成功标志）

# 检查飞书 WebSocket 连接成功日志
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

3. 必备权限清单

权限类型	具体权限（示例）
应用身份权限	接收单聊消息（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）

4. 用户未被授权访问

现在机器人已经能收到消息了，只是因为用户未被授权访问，所以返回了配对提示。你只需要执行机器人给出的授权命令即可。

操作步骤

1. 在你的服务器终端，执行以下命令（直接复制图片里的配对码 B6ZF7YUC）：

   openclaw pairing approve feishu B6ZF7YUC
   

2. 执行成功后，回到飞书客户端，再次给机器人发消息（比如“你好”），机器人就会正常回复了。

---

为什么会这样？
OpenClaw 默认开启了访问控制，只有被授权的用户才能和机器人交互，避免未授权的访问。这次的配对码就是用来把你的飞书用户 ID 加入白名单的。

授权后，你的飞书账号 ou_470550e71a283d77bd45136089f46f33 就被信任了，机器人就可以正常处理你的消息并返回回答。

需要我帮你把这个授权命令再确认一遍吗？