← 返回首页
🤖 OpenClaw 接入飞书机器人教程
📅 更新时间：2026-03-10 | 🖥️ 阿里云 ECS
📋 概述
本文将详细介绍如何将 OpenClaw AI 助手接入飞书（Feishu/Lark），实现通过飞书群聊与 AI 对话。
⚠️ 准备工作： 需要先在飞书开放平台注册企业账号并完成企业认证
📝 第一步：创建飞书应用
1.2 进入「应用开发」→「创建应用」
1.3 填写应用名称：OpenClaw AI 助手
1.4 选择「自建应用」→「创建」
📌 获取应用凭证
在应用详情页获取以下信息：
- App ID - 应用 ID
- App Secret - 应用密钥（⚠️ 只显示一次，请妥善保存！）
🔐 第二步：配置应用权限
2.1 在应用详情页点击「权限管理」→「API 权限」
2.2 搜索并添加以下权限：
| 权限名称 | 说明 |
|---|
| im:chat:members | 获取群成员列表 |
| im:message:send_as_bot | 以机器人身份发送消息 |
| im:message:send_to_bot | 接收消息 |
| im:chat:create | 创建群聊 |
| im:chat:update | 更新群聊信息 |
2.3 点击「版本管理与发布」→「创建新版本」
2.4 填写版本号 1.0.0，提交审核并发布
🌐 第三步：配置回调地址
3.1 确认服务器公网 IP 可访问（当前：47.97.187.30）
⚠️ 阿里云用户： 请在云控制台安全组规则中开放 80 和 443 端口
3.2 在飞书应用点击「事件订阅」→「添加回调URL」
3.3 填写回调地址：
http://47.97.187.30/callback/feishu
3.4 生成并保存 Encrypt Key，点击保存
📦 第四步：安装飞书 SDK
pip3 install lark-sdk
cd /home/admin/.openclaw
pip3 install -r requirements.txt
⚙️ 第五步：配置 OpenClaw
编辑配置文件
vim /home/admin/.openclaw/config.yaml
添加飞书配置
feishu:
enabled: true
app_id: "cli_xxxxxxxxxxxxx"
app_secret: "xxxxxxxxxxxxxxxx"
encrypt_key: "xxxxxxxxxxxxxxxx"
verification_token: "xxxxxxxx"
callback_url: "http://47.97.187.30/callback/feishu"
或配置环境变量
export FEISHU_APP_ID="cli_xxxxxxxxxxxxx"
export FEISHU_APP_SECRET="xxxxxxxxxxxxxxxx"
export FEISHU_VERIFICATION_TOKEN="xxxxxxxx"
export FEISHU_ENCRYPT_KEY="xxxxxxxxxxxxxxxx"
🐍 第六步：创建回调服务
在 /home/admin/.openclaw/ 目录下创建 feishu_callback.py：
from flask import Flask, request, jsonify
from lark import Lark
import json, os
app = Flask(__name__)
def init_feishu():
global client
client = Lark(
app_id=os.getenv('FEISHU_APP_ID'),
app_secret=os.getenv('FEISHU_APP_SECRET'),
verification_token=os.getenv('FEISHU_VERIFICATION_TOKEN'),
encrypt_key=os.getenv('FEISHU_ENCRYPT_KEY')
)
@app.route('/callback/feishu', methods=['POST'])
def handle_callback():
data = request.json
if data.get('type') == 'url_verification':
return jsonify({'challenge': data.get('challenge')})
return jsonify({'code': 0})
if __name__ == '__main__':
init_feishu()
app.run(host='0.0.0.0', port=5000)
🚀 第七步：启动服务
sudo tee /etc/systemd/system/openclaw-feishu.service << 'SERVICE'
[Unit]
Description=OpenClaw Feishu Service
[Service]
Type=simple
User=admin
ExecStart=/usr/bin/python3 /home/admin/.openclaw/feishu_callback.py
Restart=always
[Install]
WantedBy=multi-user.target
SERVICE
sudo systemctl daemon-reload
sudo systemctl enable openclaw-feishu
sudo systemctl start openclaw-feishu
sudo systemctl status openclaw-feishu
💬 第八步：添加到群聊
8.1 打开飞书电脑客户端 → 创建群聊 → 群机器人
8.2 选择「OpenClaw AI 助手」
8.3 在群设置中添加机器人为成员
8.4 @机器人发送消息测试
❓ 常见问题
Q1: 回调 URL 验证失败？
- 检查服务是否启动：
systemctl status openclaw-feishu
- 检查防火墙：
firewall-cmd --list-ports
- 检查阿里云安全组规则
Q2: 消息发送失败？
- 确认应用已发布上线
- 检查
im:message:send_as_bot 权限
Q3: 如何配置 HTTPS？
- 方案一：使用 Nginx 反向代理 + SSL 证书
- 方案二：在阿里云申请免费 SSL 证书
📊 配置总结
| 配置项 | 说明 | 示例 |
|---|
| App ID | 飞书应用 ID | cli_xxxxxxxx |
| App Secret | 飞书应用密钥 | xxxxxxxxxxxx |
| Encrypt Key | 回调加密密钥 | xxxxxxxxxxxx |
| Verification Token | 验证 Token | xxxxxxxxxxxx |
| 回调地址 | 消息接收地址 | http://IP/callback/feishu |
📌 下一步
✅ 完成飞书接入
⬜ 配置更多功能（定时提醒、群管理）
⬜ 接入其他平台（钉钉、企业微信）
* 本文档由 OpenClaw 自动生成 *