OpenClaw 真正难的不是“能不能跑”，而是“跑起来后能不能稳定接飞书”。 这篇就按实操顺序，把安装、配置、验证、排错一次走通。

参考文章：Windows 也能跑 OpenClaw（腾讯云）

先放核心链接

OpenClaw 飞书渠道文档（官方）

飞书开放平台（创建应用）

ClawX Releases（桌面版下载）

路线选择（先决定）

1. CLI 路线：适合你已经习惯终端、希望自己掌控全部配置。
2. ClawX 路线：适合想快速落地，减少命令行和配置文件心智负担。

我建议新手优先 ClawX。理由很简单：

• 图形化向导可直接完成首轮配置
• 内置 OpenClaw runtime，少一步“先装再配”的折腾
• 更容易定位问题（UI 状态 + 可视化配置）

ClawX 安装（不走 CLI）

这部分就是你要的重点：不用命令行也能把 OpenClaw 跑起来。

1. 打开 ClawX Releases 页面，下载你系统对应安装包（Windows/macOS/Linux）。
2. 安装后首次启动，按 Setup Wizard 走 4 步：

• Language & Region（语言地区）
• AI Provider（填模型提供商 Key）
• Skill Bundles（选预置技能）
• Verification（配置校验）

3. 进入主界面后，确认 Gateway 状态是 Running。
4. 在 Channels 页面准备新增飞书渠道。

提示

ClawX 官方 README 明确说明它是 OpenClaw 的桌面图形界面，目标就是把 CLI 编排变成「无终端」体验。

飞书配置（重点）

下面这套是“最少绕路版本”，按顺序做。

1. 创建飞书应用

1. 进入飞书开放平台：https://open.feishu.cn/app
2. 创建企业自建应用
3. 填应用名、描述、图标

2. 启用机器人能力

1. 打开 应用能力 -> 机器人
2. 启用机器人
3. 设置机器人名称

3. 配置权限

在 权限管理 里至少保证这几个权限有了：

• im:message
• im:message:send_as_bot
• im:chat
• im:message.p2p_msg:readonly
• im:resource（要收发文件/图片时必备）

如果你想一步到位，可以直接用社区整理的“批量导入 JSON”方案：

飞书权限批量导入示例（含完整 scopes）

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu: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"]
  }
}

4. 配置事件订阅（关键）

1. 进入 事件与回调 -> 事件配置
2. 选择 使用长连接接收事件（WebSocket）
3. 添加事件：im.message.receive_v1

这里非常关键：OpenClaw 官方也推荐长连接模式，因为不需要公网 URL/SSL 证书。

5. 复制凭证

在 凭证与基础信息 页面复制：

• App ID（通常是 cli_xxx）
• App Secret

6. 发布应用

1. 版本管理与发布 -> 创建版本
2. 提交发布，等审批通过

不发布的话，前面的权限和事件配置都不会真正生效。

7. 回到 OpenClaw / ClawX 配置渠道

如果你走 ClawX：

1. 打开 Channels
2. 新增 Feishu
3. 填 App ID 和 App Secret
4. 保存并重启 Gateway

如果你走 CLI（兜底命令）：

openclaw plugins install @openclaw/feishu
openclaw channels add
openclaw gateway restart
openclaw logs --follow

8. 消息验证 + 配对授权

1. 在飞书里给机器人发一条消息
2. 如果收到配对码，执行：

openclaw pairing approve feishu <配对码>

3. 再发一条，能正常回复就完成

推荐配置（给大多数人）

{
  "channels": {
    "feishu": {
      "enabled": true,
      "dmPolicy": "pairing",
      "groupPolicy": "open",
      "requireMention": true,
      "streaming": true,
      "accounts": {
        "main": {
          "appId": "cli_xxx",
          "appSecret": "YOUR_APP_SECRET",
          "botName": "My AI Assistant"
        }
      }
    }
  }
}

说明：

• dmPolicy: pairing：新用户先走配对，安全一些
• requireMention: true：群里必须 @机器人才回复，防刷屏
• streaming: true：开启流式回复，体验更像 ChatGPT

常见坑（我帮你先排）

1. 机器人没反应：通常是应用没发布，或漏了 im.message.receive_v1
2. 飞书能发但收不到：先看 Gateway 日志是否出现 feishu ws connected
3. 图片文件失败：大概率缺 im:resource 权限
4. 群聊不回复：你没 @机器人，或者 requireMention 开着
5. 国际版 Lark：把 domain 改成 lark

安全提醒

OpenClaw/ClawX 本质上是高权限自动化代理：

• 建议在干净设备或 VPS 跑
• App Secret 不进仓库，不发群
• 配对策略优先 pairing / allowlist，不要一上来 open

贡献者: paiad