第 00 章：飞书极速上手 ⭐⭐

本章解决什么问题：5 分钟在飞书上配置好 OpenClaw，开始和 AI 对话

学习目标：完成飞书 Bot 配置，让 AI 在飞书中回复你的消息

版本基准：OpenClaw 3.13 + 飞书开放平台 2026

前置条件：已安装 OpenClaw，有飞书企业管理员权限

---

0.1 快速对比：飞书 vs Telegram

特性	Telegram	飞书
适用场景	个人使用	个人/团队
配置难度	⭐ 简单	⭐⭐ 中等
审核要求	无	企业需管理员审批
配对流程	需要 pairing approve	无需配对

💡 选择建议：个人用 Telegram，企业用飞书。

---

0.2 三步快速配置

步骤一：创建飞书应用（3 分钟）

1. 访问 飞书开放平台

2. 点击"企业应用" → "创建应用"

3. 填写应用信息：

   • 应用名称：OpenClaw 助手
   • 应用图标：上传任意图片
   • 应用描述：AI 助手

4. 在"凭证与基础信息"页面，复制：

   • App ID：cli_xxxxxxxxxxxxxxxx
   • App Secret：xxxxxxxxxxxxxxxxxxxxxxxx

---

步骤二：配置权限（2 分钟）

在"权限管理"页面添加以下权限：

权限	权限标识	用途
发送消息	im:message	回复用户消息
读取消息	im:chat	接收用户消息
机器人管理	im:bot	配置回调

添加权限后提交审核（通常几分钟通过）。

---

步骤三：配置 OpenClaw（1 分钟）

编辑 ~/.openclaw/openclaw.json：

{
  channels: {
    feishu: {
      enabled: true,
      appId: "cli_xxxxxxxxxxxxxxxx",      // 替换为你的 App ID
      appSecret: "xxxxxxxxxxxxxxxxxxxxxxxx",  // 替换为你的 App Secret
      verificationToken: "xxxxxxxxxxxxxxxx",  // 事件订阅中的验证 Token
    },
  },
}

重启 Gateway：

openclaw gateway restart

---

0.3 发布应用

方式一：个人版本（快速测试）

1. 进入"版本管理与发布"
2. 创建版本 → 填写 1.0.0
3. 发布为"个人版本"
4. 在飞书中搜索应用名称，添加到聊天

方式二：企业版本（正式使用）

1. 创建版本 → 提交企业审核
2. 管理员审批通过后发布
3. 企业成员可在应用商店安装

---

0.4 验证配置

在飞书中找到 OpenClaw 应用，发送：

你好

AI 回复：

你好！我是 OpenClaw 助手，有什么可以帮你的吗？

✅ 如果收到回复，配置成功！

---

0.5 常见问题

问题	解决方案
应用找不到	发布后在飞书搜索应用名称并安装
消息不回复	检查权限是否审批通过
Token 错误	重新复制 App ID/Secret，注意不要有空格
回调失败	检查回调地址是否公网可访问（生产环境需要）

---

✅ 你已解锁能力

能力	状态
创建飞书应用	✅ 已掌握
配置权限 Scope	✅ 已掌握
配置 OpenClaw	✅ 已掌握
发布应用	✅ 已掌握

---

🎯 下一章

第 01 章：第一次对话

学习如何让 AI 帮你：

• 回答问题
• 编写代码
• 处理文件
• 搜索资料

---

📚 参考资源

• 飞书开放平台
• 飞书应用开发文档
• 飞书权限管理
• OpenClaw 官方文档

---

本文由郭峰主导，基于 GPT-5.4、OpenClaw Agent 完成，并经人工审校定稿。

---

课后练习（可选）

1. 在飞书开放平台创建测试应用
2. 配置权限并完成发布
3. 在飞书中与 AI 对话

有任何问题，随时在群里提问！ 🚀