OpenClaw飞书配置教程

OpenClaw 飞书机器人配置教程

小龙虾 AI 训练营

一、概述

本教程指导怎样将本地部署的 OpenClaw（小龙虾）和飞书机器人对接，达成借助飞书群聊/私聊和 AI 助手交互。配置分为三个主要阶段：

创建飞书自建运用并开启机器人本领

在 OpenClaw 中配置飞书通道

配置经过订阅并连接

二、创建飞书自建运用

Step 1: 进入飞书开发者后台

访问 https://open.feishu.cn/app

点击「创建公司自建运用」

填写运用名称（如：小龙虾助手）、描述，图标

Step 2: 添加机器人本领

进入运用详情 → 「添加运用本领」

选项「机器人」，点击「添加」

Step 3: 记录凭证资讯

在「凭证和基础资讯」页面，记录以下资讯（后面会用到）：

App ID

如：cli_xxxxxxxxxxxx

App Secret

点击「查看」获取

三，配置 OpenClaw 飞书通道

Step 1: 进入配置界面

在服务器终端执行：

openclaw dashboard

或者手动编辑配置文件：

nano ~/.openclaw/openclaw.json

Step 2: 添加飞书配置

在配置文件的 channels 部分添加：

{

"channels": {

"feishu": {

"enabled": true,

"appId": "cli_xxxxxxxxxxxx",

"appSecret": "xxxxxxxxxxxxxxxx"

}

}

}

注意：将 appId 和 appSecret 替换为你自己的凭证

Step 3: 配置权限

在飞书开发者后台 → 「权限管控」，添加以下权限：

权限名称

说明

im:chat:readonly

读取群组资讯

im:message:send_as_bot

以机器人身份发送消息

im:message

读取消息

im:resource

上传文件/图片

⚠️ 要害：权限单词拼写必须正确，采用英文冒号，不是中文冒号

Step 4: 重启 OpenClaw

保存配置后，具体来看，重启使配置生效：

openclaw restart

四、配置经过订阅

Step 1: 发布运用版本

进入「版本管控和发布」

点击「创建版本」

填写版本号，更新说明，点击「保存」

点击「申请发布」，等待管控员审核借助

Step 2: 配置长连接（推荐）

在「经过订阅」页面，选项「长连接」模式：

连接方式

长连接

加密方式

无加密（开发测试）

添加以下经过订阅：

经过名称

说明

接收消息

im.message.receive_v1

进群

im.chat.member.bot.added_v1

Step 3: 将机器人添加到群组

在飞书群聊中，执行层面，点击右上角「设置」→「群机器人」

点击「添加机器人」→ 找到你的运用 → 点击「添加」

五，验证配置

在飞书群里 @机器人，换个角度看，发送测试消息：

@小龙虾助手 你好

倘若机器人正常回复，从实践看，说明配置成功！

六、常见问题排查

Q1: 机器人不回复

查验 openclaw 状态：openclaw status

查验 channels 列表：openclaw channels list

查看日志：openclaw logs

Q2: 权限配置报错

确保先添加 App ID 和密钥到 OpenClaw，实操中，重启后再配置长连接。权限单词查验拼写，实操中，换个角度看，采用英文冒号。

Q3: 个人账户无法添加机器人

飞书个人账户没有「添加到外部群」权限，需要公司管控员开通或者采用公司账号创建运用。

附录：常用命令

命令

说明

openclaw status

查看运行状态

openclaw channels list

查看通道列表

openclaw restart

重启服务

openclaw logs

查看日志

--- 教程结束 ---

老师简介

Introduction to lecturers

弄懂更多

博闻智咨询|冰洋老师