OpenClaw + 1Panel 接入飞书完整教程：10分钟从零到跑通 ​

从创建飞书应用到配置完成，全程保姆级教程。权限JSON一键导入，1Panel可视化配置，小白10分钟也能跑通。

第一步：创建飞书应用 ​

1. 打开飞书开放平台 ​

访问飞书开放平台，使用飞书账号登录。

2. 创建应用 ​

• 点击「创建企业自建应用」
• 填个名称和描述
• 选择应用图标

3. 获取应用凭证 ​

在应用的「凭证与基础信息」页面，复制：

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

❗ 重要：请妥善保管 App Secret，不要分享给他人。

4. 配置应用权限 ​

在「权限管理」页面，点击「批量导入」按钮，粘贴以下 JSON 配置一键导入所需权限：

{
  "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:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "docs:document.content:read",
      "event:ip_list",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource",
      "sheets:spreadsheet",
      "wiki:wiki:readonly"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}

注意：im:message.group_msg 权限（获取群组中所有消息，属于敏感权限）允许机器人接收群组中所有消息（不仅仅是 @机器人的）。如果你需要配置 requireMention: false 让机器人无需 @ 也能响应，则必须添加此权限。

5. 启用机器人能力 ​

在「应用能力」>「机器人」页面：

• 开启机器人能力
• 配置机器人名称

6. 配置事件订阅 ​

⚠️ 重要提醒：在配置事件订阅前，请先确认已完成以下步骤：

• 运行 openclaw channels add 添加了 Feishu 渠道
• 网关处于启动状态（可通过 openclaw gateway status 检查状态）

在「事件订阅」页面：

• 选择「使用长连接接收事件」（WebSocket 模式）
• 添加事件：im.message.receive_v1（接收消息）

⚠️ 注意：这一步可以在 1Panel 中配置好飞书后再操作，如果网关未启动或渠道未添加，长连接设置将保存失败。

7. 发布应用 ​

• 在「版本管理与发布」页面创建版本
• 提交审核并发布
• 等待管理员审批（企业自建应用通常自动通过）

第二步：配置 OpenClaw ​

方式一：使用 1Panel 配置（推荐） ​

在 1Panel 中打开 OpenClaw 的配置页面，选择「聊天渠道」，配置好飞书的 App ID 和 App Secret，点击保存。

这一步保存好之后，再去执行上面的「配置事件订阅」就能订阅成功了。

方式二：通过配置文件配置 ​

编辑 ~/.openclaw/openclaw.json：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "dmPolicy": "pairing",
      "accounts": {
        "main": {
          "appId": "cli_xxx",
          "appSecret": "xxx",
          "botName": "OpenClaw机器人"
        }
      }
    }
  }
}

提示：配置文件支持 JSON5 格式（允许注释和尾随逗号），但以上示例使用标准 JSON 格式以便直接复制使用。

第三步：启动并测试 ​

1. 启动网关 ​

openclaw gateway

2. 发送测试消息 ​

在飞书中找到你创建的机器人，发送一条消息。

3. 配对授权 ​

机器人会回复一个配对码。

方式一：在 1Panel 的配置页面中填入配对码

方式二：使用命令执行

openclaw pairing approve feishu <配对码>

配对成功后，就可以正常对话了。

常见问题 ​

Q1: 长连接设置保存失败？ ​

检查网关是否启动、渠道是否添加：

openclaw gateway status
openclaw channels list

Q2: 机器人不响应消息？ ​

1. 确认事件订阅已添加 im.message.receive_v1
2. 确认配对码已授权
3. 检查权限配置是否完整

Q3: 群聊中机器人不响应？ ​

如果需要机器人响应非@消息，确保添加了 im:message.group_msg 敏感权限。

相关资源 ​

• OpenClaw 官方文档
• 飞书开放平台