本文基于真实安装经验整理，全程只用到 PowerShell / CMD 命令行，不需要 Web 控制台。

前置条件：

• OpenClaw 已安装完成，能通过 openclaw chat 正常使用（参考上份指南）

• 必须有飞书账号（个人/企业均可，企业账号需有开发者权限）

📁 一、飞书开放平台：创建机器人并获取凭证

⚠️ 不需要公网 IP，全程使用飞书自带的 WebSocket 长连接模式

1. 登录并创建应用

访问 飞书开放平台，使用飞书账号登录 [6†L8-L11][8†L7-L9]。

点击右上角「开发者后台」→「创建企业自建应用」，填写：

• 应用名称：OpenClaw助手（可自定义）

• 应用图标：任意上传一张图片

点击「创建」保存 

2. 添加机器人能力

进入应用详情页 → 左侧「添加应用能力」→ 找到并添加「机器人」。

3. 批量导入权限（关键步骤）

左侧「权限管理」→「批量导入/导出权限」→ 选择「应用身份权限」，粘贴以下 JSON：

{
  "scopes": {
    "tenant": [
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:send_as_bot",
      "im:resource",
      "contact:user.base:readonly"
    ]
  }
}

点击「格式化」→「下一步」→「申请开通」。

💡 个人账号免审核，立即生效；企业账号需管理员审核 

4. 获取 App ID 和 App Secret

左侧「凭证与基础信息」→ 在「应用凭证」区域：

• App ID：格式 cli_xxxxx，直接复制

• App Secret：点击「显示」，复制完整内容

⚠️ App Secret 相当于应用的密码，请妥善保管。

🔧 二、OpenClaw 命令行配置

全程在 PowerShell（管理员）中进行

1. 逐条执行配置命令

openclaw config set channels.feishu.enabled true
openclaw config set channels.feishu.appId "cli_你的AppID"
openclaw config set channels.feishu.appSecret "你的AppSecret"
openclaw config set channels.feishu.connectionMode websocket
openclaw config set channels.feishu.dmPolicy pairing
openclaw config set channels.feishu.groupPolicy allowlist
openclaw config set channels.feishu.requireMention true

每条命令执行后显示 Updated... 表示成功 。

💡 dmPolicy pairing 表示私聊需要配对才能使用，后续会进行设备配对。

2. 配置保存到配置文件

这些命令会自动写入 %USERPROFILE%\.openclaw\openclaw.json。

3. 重启 Gateway

openclaw gateway restart

Windows下如果 restart 报错，手动操作：

• 在运行 openclaw gateway 的窗口按 Ctrl+C

• 重新运行 openclaw gateway

注意保持 Gateway 窗口一直打开，不要关闭。

✨ 三、返回飞书开放平台完成关键配置

1. 配置事件订阅

左侧「事件与回调」→ 订阅方式选择「使用长连接接收事件」→ 点击右上角「保存」。

⚠️ 选择「使用长连接接收事件」，不是 Webhook！这是内网用户无需公网 IP 的关键 。

2. 添加接收消息事件

点击「添加事件」→ 搜索 im.message.receive_v1 → 勾选「接收消息 v2.0」→ 点击「确认添加」。

3. 发布应用使配置生效

左侧「版本管理与发布」→「创建版本」

• 应用版本号：1.0.0

• 更新说明：OpenClaw 机器人初始配置

• 移动端/桌面端默认能力：均选择「机器人」

点击「保存」→「确认发布」。

✅ 四、验证与设备配对

1. 在飞书中找到机器人

打开飞书 PC 端或手机端 → 搜索你创建的应用名称（如 OpenClaw助手）。

2. 发送消息获取配对码

向机器人发送任意消息（如 你好）→ 机器人会回复一个 6 位数字配对码（如 123456）。

💡 配对码由飞书机器人自动生成，不需要提前配置。

3. 在终端批准配对

openclaw pairing approve feishu 123456

（把 123456 换成你实际收到的配对码）

4. 验证是否成功

再次给机器人发送 你好，如果能正常回复，就成功了！

配对成功后不需要重启，立即生效。

🐛 五、常见问题排查

现象	原因	解决方法
飞书收不到消息	应用未发布/权限未开通	确认应用状态为「已发布」，检查权限和事件
机器人不回复	设备未配对	发送消息获取配对码，执行 openclaw pairing approve feishu <配对码>
群聊不回复	默认需要 @提及	发送 @机器人 你好 试试，或在配置中修改 requireMention false [12†L24-L25]
发布后仍无响应	缓存未刷新	等待几分钟，或在飞书管理后台重新测试
Gateway 连接异常	服务未运行	运行 openclaw gateway 确保服务在线

快速诊断：

openclaw status --all        # 检查整体状态
openclaw pairing list feishu  # 查看待配对请求
openclaw logs --follow        # 查看实时日志

🎯 六、补充：群聊使用

机器人默认加入群聊后，需要 @机器人 才会回复。如果想让它自动响应所有消息，可以修改配置：

openclaw config set channels.feishu.requireMention false
openclaw gateway restart

此时机器人在群里看到任何消息都会回复，注意可能会造成刷屏 [12†L13-L15]。

📌 七、总结

项目	状态
飞书机器人创建	✅ 完成
权限配置	✅ 完成（含 im:message 等）
长连接订阅	✅ 完成
CMD 配置凭证	✅ 完成
设备配对	✅ 完成
可以开始使用	✅ 是

现在你可以在飞书里直接给机器人发指令了，比如 帮我整理桌面文件、列出C盘下的PDF。配对不同担心，一次成功以后就稳定了——你的龙虾终于愿意用你习惯的方式和你说话了。🦞

43 个网页