飞书接入 OpenClaw：企业 AI 助手实战

🔧 Step 0：先配置消息接收渠道

⚠️ 本案例需要发送通知到你的手机，先配置消息渠道 👉 去配置 Telegram/飞书/微信接入 →

这个场景解决什么问题

企业环境用飞书，想在日常工作频道直接调用 AI，不需要切换到 Telegram 或浏览器。OpenClaw 的飞书渠道用 WebSocket 长连接，不需要公网 IP 和 Webhook 回调地址。

直接复制这段：飞书渠道最简配置

把下面这段加到 ~/.openclaw/openclaw.json，再重启 Gateway：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "dmPolicy": "pairing",
      "accounts": {
        "main": {
          "appId": "cli_xxxxxxxxxxxxx",
          "appSecret": "xxxxxxxxxxxxxxxxxx",
          "botName": "AI助手"
        }
      }
    }
  }
}

openclaw gateway restart

前置条件

• OpenClaw 已安装并运行（参考快速上手）
• 飞书企业管理员权限（或能让管理员审批应用）

第一步：创建飞书应用

1. 打开 飞书开放平台，登录
2. 点击创建企业自建应用，填写名称和描述
3. 进入凭证与基础信息，复制：
   • App ID（格式：cli_xxx）
   • App Secret

第二步：配置权限（批量导入）

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

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

第三步：开启机器人能力 + 事件订阅

1. 在应用能力→机器人中开启机器人功能
2. 先确保 OpenClaw Gateway 正在运行（下一步会用到）
3. 在事件订阅中：
   • 选择使用长连接接收事件（WebSocket 模式，无需公网 IP）
   • 添加事件：im.message.receive_v1

第四步：在 OpenClaw 配置飞书渠道

方法 A：向导配置（推荐）

openclaw channels add

选择 Feishu，输入 App ID 和 App Secret，向导自动完成配置。

方法 B：手动编辑配置文件

在 ~/.openclaw/openclaw.json 中添加：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "dmPolicy": "pairing",
      "accounts": {
        "main": {
          "appId": "cli_xxxxxxxxxxxxx",
          "appSecret": "xxxxxxxxxxxxxxxxxx",
          "botName": "AI助手"
        }
      }
    }
  }
}

配置完成后重启：

openclaw gateway restart

第五步：发布应用并测试

1. 在版本管理与发布创建版本，提交审核
2. 企业管理员审批后（自建应用通常自动通过）
3. 在飞书搜索你的机器人名称，发一条消息

第一次私聊会返回配对码，批准它：

openclaw pairing list feishu
openclaw pairing approve feishu <CODE>

群聊只响应 @ 消息

在配置中加入群聊设置：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "dmPolicy": "pairing",
      "accounts": {
        "main": {
          "appId": "cli_xxx",
          "appSecret": "xxx",
          "botName": "AI助手",
          "groups": {
            "*": {
              "requireMention": true
            }
          }
        }
      }
    }
  }
}

限制只有特定成员能使用

{
  "channels": {
    "feishu": {
      "accounts": {
        "main": {
          "appId": "cli_xxx",
          "appSecret": "xxx",
          "allowFrom": ["ou_xxxxx", "ou_yyyyy"]
        }
      }
    }
  }
}

allowFrom 里填飞书用户的 Open ID（在飞书开放平台用户管理页面查询）。

自动发飞书消息（cron 定时推送）

openclaw cron add \
  --name "周报提醒" \
  --cron "0 9 * * 5" \
  --tz "Asia/Shanghai" \
  --session isolated \
  --message "今天是周五，整理本周工作内容，生成一份简短的周报摘要" \
  --announce \
  --channel feishu \
  --to "飞书用户OpenID或群聊ID"

管理命令

openclaw gateway status         # 查看 Gateway 状态
openclaw logs --follow          # 实时查看日志
openclaw gateway restart        # 重启（配置修改后）
openclaw pairing list feishu    # 查看待审批配对

注意事项

• 使用 WebSocket 长连接，不需要公网 IP，本地机器也能用
• 飞书应用需要企业管理员审批才能生效（自建应用通常快）
• 每次修改配置文件后需要重启 Gateway
• 群聊里机器人需要被管理员拉入，并确认隐私模式设置
• 飞书 Open ID 格式为 ou_xxx，不是邮箱