OpenClaw + 飞书机器人完整教程

# OpenClaw + 飞书机器人完整教程

> 从零开始搭建你的AI智能助手

—

## 教程简介

OpenClaw是一个强大的AI Agent框架，支持多平台接入。本教程将手把手教你如何使用OpenClaw搭建飞书机器人，让你的AI助手在飞书中为你工作。

**适合人群**：
– 想要搭建AI助手的开发者
– 需要自动化办公的团队
– 对AI Agent感兴趣的学习者

**前置要求**：
– 一台服务器（Linux推荐）
– 基础的命令行操作能力
– 飞书开放平台账号

—

## 第一步：安装OpenClaw

### 1.1 环境准备

“`bash
# 更新系统
sudo apt update && sudo apt upgrade -y

# 安装Node.js 18+
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash –
sudo apt install -y nodejs

# 安装pnpm
npm install -g pnpm

# 验证安装
node -v # v22.x.x
pnpm -v # 9.x.x
“`

### 1.2 安装OpenClaw

“`bash
# 全局安装OpenClaw
pnpm install -g openclaw

# 验证安装
openclaw –version
“`

### 1.3 初始化项目

“`bash
# 创建工作目录
mkdir -p ~/.openclaw/workspace
cd ~/.openclaw/workspace

# 初始化配置
openclaw init
“`

—

## 第二步：配置飞书应用

### 2.1 创建飞书应用

1. 访问 [飞书开放平台](https://open.feishu.cn/)
2. 创建企业自建应用
3. 记录以下信息：
– App ID
– App Secret

### 2.2 配置权限

在飞书应用后台，添加以下权限：

**消息权限**：
– `im:message` – 获取与发送消息
– `im:message:send_as_bot` – 以应用身份发消息

**用户权限**：
– `contact:user.base:readonly` – 获取用户基本信息

### 2.3 配置事件订阅

1. 在”事件订阅”页面，添加请求网址：
“`
https://你的域名/webhook/feishu
“`

2. 添加事件：
– `im.message.receive_v1` – 接收消息

### 2.4 发布应用

1. 提交审核
2. 审核通过后发布到企业

—

## 第三步：配置OpenClaw

### 3.1 创建配置文件

“`bash
# 创建凭证目录
mkdir -p ~/.openclaw/workspace/.credentials

# 创建飞书配置文件（注意：不要提交到git）
cat > ~/.openclaw/workspace/.credentials/feishu.txt << 'EOF' App ID: 你的App ID App Secret: 你的App Secret EOF ``` ### 3.2 配置环境变量 ```bash # 编辑配置文件 nano ~/.openclaw/config.json ``` 添加飞书配置： ```json { "channels": { "feishu": { "appId": "你的App ID", "appSecret": "你的App Secret", "encryptKey": "你的Encrypt Key", "verificationToken": "你的Verification Token" } } } ``` ### 3.3 配置Gateway ```bash # 启动Gateway服务 openclaw gateway start # 检查状态 openclaw gateway status ``` --- ## 第四步：启动机器人 ### 4.1 启动主Agent ```bash # 启动主会话 openclaw agent --deliver ``` ### 4.2 测试机器人 在飞书中找到你的机器人，发送消息测试： ``` 你好 ``` 机器人应该会回复你。 --- ## 第五步：进阶配置 ### 5.1 配置AI模型 OpenClaw支持多种AI模型： ```json { "model": "your-model-name", "apiKey": "你的API Key" } ``` 支持的模型： - 讯飞星火 - OpenAI GPT - Claude - 通义千问 - 文心一言 ### 5.2 配置技能（Skills） OpenClaw的技能系统让AI具备特定能力： ```bash # 查看可用技能 ls ~/.openclaw/workspace/skills/ # 创建自定义技能 mkdir -p ~/.openclaw/workspace/skills/my-skill ``` 技能示例： ```markdown # SKILL.md - 我的技能 ## 触发条件 当用户询问天气时 ## 执行步骤 1. 获取用户位置 2. 调用天气API 3. 返回天气信息 ``` ### 5.3 配置记忆系统 让AI记住对话历史： ```json { "memory": { "type": "tianji", "apiUrl": "your-api-url", "token": "your-token" } } ``` --- ## 常见问题 ### Q1: 机器人不回复消息？ 检查： 1. Gateway是否正常运行：`openclaw gateway status` 2. 飞书事件订阅是否配置正确 3. 查看日志：`tail -f /tmp/openclaw/*.log` ### Q2: 如何查看日志？ ```bash # 查看Gateway日志 tail -f /tmp/openclaw/gateway.log # 查看Agent日志 tail -f /tmp/openclaw/agent.log ``` ### Q3: 如何重启服务？ ```bash # 重启Gateway openclaw gateway restart # 重启Agent # 先停止，再启动 ``` ### Q4: 如何更新OpenClaw？ ```bash # 更新到最新版本 pnpm update -g openclaw # 检查版本 openclaw --version ``` --- ## 实战案例 ### 案例1：智能客服机器人 配置OpenClaw作为客服机器人： - 自动回复常见问题 - 记录用户反馈 - 转接人工客服 ### 案例2：团队协作助手 配置OpenClaw作为团队助手： - 任务分配与跟踪 - 会议提醒 - 数据查询 ### 案例3：数据分析助手 配置OpenClaw作为数据分析助手： - 自动生成数据报告 - 异常数据预警 - 数据可视化 --- ## 下一步 - 阅读OpenClaw官方文档：https://docs.openclaw.ai - 加入社区：https://discord.com/invite/clawd - 探索更多技能：https://clawhub.ai --- ## 联系我们 - 网站：qybot.icu - 邮箱：mengyuhun@vip.qq.com - 团队：天枢团队 --- *更新时间：2026-04-28* *作者：陈灵均*