OpenClaw 飞书接入完整指南

飞书是国内企业常用的协作工具，把 OpenClaw 接入飞书后，你可以在飞书里直接和龙虾对话。这篇文章详细记录接入流程。

📋 前置准备

• 飞书管理员权限（或找管理员协助）
• 一台公网可访问的服务器
• OpenClaw 已安装并配置好

🏗️ 步骤 1：创建飞书应用

访问飞书开放平台创建企业自建应用：

# 飞书开放平台
https://open.feishu.cn/

# 创建企业自建应用
应用类型：企业自建应用
应用名称：OpenClaw Bot
应用描述：AI龙虾助手

🔑 步骤 2：获取凭证

创建完成后，获取 App ID 和 App Secret：

# 开发者后台 -> 凭证与基础信息
App ID: cli_xxxxxxxxxxxx
App Secret: xxxxxxxxxxxxxxxx

⚙️ 步骤 3：配置 OpenClaw

在 openclaw.json 中添加飞书配置：

{
  providers: {
    anthropic: { apiKey: "sk-ant-xxx" }
  },
  channels: {
    feishu: {
      appId: "cli_xxxxxxxxxxxx",
      appSecret: "xxxxxxxxxxxxxxxx"
    }
  }
}

🔐 步骤 4：配置权限

在飞书开放平台申请必要权限：

# 权限管理 -> 申请权限
消息: 读取、发送消息
用户: 获取用户基本信息
群组: 获取群组信息

权限说明：

权限	用途	必需
读取消息	接收用户发送的消息	✅ 必须
发送消息	回复用户消息	✅ 必须
获取用户信息	识别用户身份	⚠️ 推荐
获取群组信息	在群聊中使用	⚠️ 推荐

📡 步骤 5：配置 Webhook

设置事件订阅地址：

# 事件订阅 -> 配置订阅方式
请求网址: https://your-domain.com/webhook/feishu

# 订阅事件
消息: 接收消息
群消息: 接收群消息

注意事项：

• 网址必须是 HTTPS
• 服务器需要能公网访问
• 防火墙需要开放端口

🚀 步骤 6：启动服务

# 启动 OpenClaw Gateway
openclaw gateway --port 18789

# 检查飞书连接状态
openclaw channels status --channel feishu

📤 步骤 7：发布应用

在飞书开放平台提交应用审核：

1. 填写应用介绍
2. 上传应用图标
3. 选择可见范围（全员或指定部门）
4. 提交审核

审核通过后，应用即可在飞书中使用。

⚠️ 常见问题

问题 1：Token 无效

现象：连接失败，提示 Token 无效

解决：

• 检查 App ID 和 App Secret 是否正确
• 确认没有多余的空格
• 重新生成 Secret 后重启 Gateway

问题 2：权限不足

现象：无法发送或接收消息

解决：

• 检查权限配置是否完整
• 确认权限已审核通过
• 等待权限生效（可能需要几分钟）

问题 3：Webhook 连接失败

现象：事件订阅配置不成功

解决：

• 检查服务器是否可公网访问
• 确认端口已开放
• 检查 HTTPS 证书是否有效

问题 4：应用未发布

现象：用户无法看到应用

解决：

• 确认应用已提交审核
• 审核通过后发布应用
• 检查可见范围设置

📊 错误码速查

# 常见错误码
10001: Token 无效
10002: 权限不足
10003: 应用未发布
10004: IP 白名单限制

📝 最佳实践

📖 延伸阅读

• 《OpenClaw钉钉集成》 - 钉钉机器人配置指南
• 《OpenClaw是什么》 - 了解 OpenClaw 核心概念