OpenClaw配置飞书图文教程

OpenClaw更新很快，不同版本配置飞书略有区别。3月2号版本飞书插件已经没有了devDependencies配置参数问题，所以决定在此时出一个详细的配置教程。

先说点题外话：飞书免费用户API调用次数原本1万次/月，2月份临时上调为5万次/月，3月份直接给到了1百万次，真的很给力！

飞书、钉钉、企业微信、QQ哪个更适合OpenClaw？

创建飞书企业自建应用

注册飞书开放平台账号：

https://open.feishu.cn/

创建企业自建应用：

填写应用名称和应用描述并创建：

获取应用凭证：

复制App ID和App Secret，将在OpenClaw中使用。

OpenClaw配置飞书

执行OpenClaw配置聊天工具命令：

openclaw channels add

选择Yes，回车进入下一步：

选择飞书：

是否使用环境变量配置App ID和App Secret：

• 选择No：在接下来的配置会要求输入App ID和App Secret，密钥明文写入OpenClaw主配置文件openclaw.json；
• 选择Yes：需要配置环境变量FEISHU_APP_ID和FEISHU_APP_SECRET。

选择飞书区域，国内用户选择China：

群组设置：

• 需要群组功能：推荐选择Allowlist(白名单制)；
• 不需要群组功能：请选择Disabled。

完成配置，退出设置向导：

OpenClaw配置文件

配置环境变量： .openclaw目录中，找到.env文件，如果没有就新建一个，添加内容如下：

FEISHU_APP_ID="App ID"
FEISHU_APP_SECRET="App Secret"

填写变量名称： openclaw.json配置文件填写环境变量：

"channels": {
    "feishu": {
        "enabled": true,
        "domain": "feishu",
        "groupPolicy": "disabled",
        "appId": "${FEISHU_APP_ID}",
        "appSecret": "${FEISHU_APP_SECRET}",
        "botName": "小智",
        "connectionMode": "websocket"
    }
}

检查插件是否启用：

"plugins": {
    "entries": {
        "feishu": {
            "enabled": true
        }
    }
}

懒得编辑配置文件可以使用以下命令：

openclaw config set channels.feishu.appId "${FEISHU_APP_ID}"
openclaw config set channels.feishu.appSecret "${FEISHU_APP_SECRET}"
openclaw config set channels.feishu.enabled true
openclaw config set plugins.entries.feishu.enabled true

编辑配置文件后需要重启网关：

openclaw gateway restart

添加设置机器人

回到飞书开放平台，找到添加应用能力：

添加机器人：

设置机器人名称：

配置飞书API权限

找到权限管理，点击批量导入/导出权限：

删除原有内容，粘贴以下内容：

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:read",
      "cardkit:card:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "event:ip_list",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
  }
}

确认新增权限：

申请开通权限：

确认应用权限可访问数据范围：

设置事件与回调

找到事件与回调，点击订阅方式：

选择使用长连接接收事件，然后保存：

如果这一步无法保存，请检查OpenClaw是否已正确配置飞书API信息并重启网关。

添加事件：

im.message.receive_v1

发布飞书应用

找到版本管理与发布，点击创建版本：

设置版本号，填写更新说明保存：

飞书配对授权

给飞书机器人发送第一条消息，机器人会回复配对码，在服务器上批准：

openclaw pairing approve feishu <配对码>