夜雨聆风让一只聪明的龙虾住进您的飞书
📋 目录
前置准备
安装步骤
配置指南
飞书集成
常见问题
进阶玩法
🎯 前置准备
系统要求
操作系统: Linux / macOS / Windows (WSL2)
Node.js: v18.0+ (推荐 v20+)
内存: 至少 2GB 可用内存
存储: 至少 500MB 磁盘空间
必需账号
飞书开发者账号 - 用于创建飞书应用
GitHub 账号 - 用于获取源码（可选）
检查环境
# 检查 Node.js 版本
node -v
# 检查 npm 版本
npm -v
🚀 安装步骤
方式一：使用 npm 全局安装（推荐）
# 安装 OpenClaw
npm install -g openclaw
# 验证安装
openclaw --version
方式二：从源码安装
# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# 安装依赖
npm install
# 全局链接
npm link
初始化工作区
# 创建工作目录
mkdir -p ~/openclaw-workspace
cd ~/openclaw-workspace
# 初始化 OpenClaw
openclaw init
⚙️ 配置指南
1. 创建配置文件
在工作目录下创建 openclaw.json：
{
"channel": "feishu",
"provider": "feishu",
"model": "miaoda/miaoda-model-auto",
"skills": {
"entries": {
"feishu-im-read": { "enabled": true },
"feishu-calendar": { "enabled": true },
"feishu-bitable": { "enabled": true },
"feishu-create-doc": { "enabled": true }
}
},
"agents": {
"defaults": {
"model": "miaoda/miaoda-model-auto",
"thinking": "off"
}
}
}
2. 配置飞书应用
2.1 创建飞书应用
访问 飞书开发者后台
点击「创建企业自建应用」
填写应用名称（如：OpenClaw 智能助手）
选择应用类型：机器人
2.2 配置应用能力
在「应用能力」页面添加以下权限：
权限名称 | 用途 |
|---|---|
发送消息 | 机器人回复消息 |
读取消息 | 接收用户消息 |
创建云文档 | 文档管理功能 |
日历管理 | 日程查询与创建 |
多维表格 | 数据表操作 |
通讯录 | 获取用户信息 |
2.3 配置机器人
进入「机器人」菜单
启用机器人
设置机器人头像和名称
复制 App ID 和 App Secret
2.4 配置事件订阅
进入「事件订阅」菜单
启用事件订阅
配置请求网址（需要公网可访问的地址）
订阅以下事件：
im.message.receive_v1- 接收消息im.message.read_v1- 消息已读（可选）
2.5 发布应用
进入「版本管理与发布」
创建新版本
提交审核（企业自用通常自动通过）
启用版本
🔗 飞书集成
启动 Gateway 服务
# 启动服务
openclaw gateway start
# 查看状态
openclaw gateway status
# 查看日志
openclaw gateway logs
在飞书中添加机器人
打开飞书，进入任意群聊或私聊
点击右上角「...」→「添加机器人」
选择您创建的 OpenClaw 机器人
完成添加
测试连接
在飞书中向机器人发送消息：
你好
如果收到回复，说明配置成功！🎉
❓ 常见问题
Q1: 服务启动失败
症状: openclaw gateway start 报错
解决方案:
# 检查端口占用
lsof -i :3000
# 查看错误日志
openclaw gateway logs --tail 100
# 重新安装
npm uninstall -g openclaw
npm install -g openclaw
Q2: 飞书收不到消息
可能原因:
事件订阅 URL 不可达
权限未正确配置
应用未发布
排查步骤:
检查事件订阅中的请求网址是否可公网访问
确认已订阅
im.message.receive_v1事件确认应用已发布并启用
Q3: 机器人回复乱码
原因: 编码问题或模型配置错误
解决方案:
// openclaw.json 中明确指定模型
{
"model": "miaoda/miaoda-model-auto"
}
Q4: 如何更新 OpenClaw
# 使用 npm 更新
npm update -g openclaw
# 重启服务
openclaw gateway restart
🎨 进阶玩法
自定义技能
在工作目录创建 skills/ 文件夹，添加自定义技能：
workspace/
├── openclaw.json
├── skills/
│ └── my-custom-skill/
│ └── SKILL.md
└── memory/
└── YYYY-MM-DD.md
配置记忆系统
创建 MEMORY.md 文件存储长期记忆：
# 长期记忆
## 用户偏好
- 喜欢简洁的回复风格
- 工作时间：9:00-18:00
- 常用功能：日程管理、文档创建
## 重要事项
- 项目 A 截止日期：2024-12-31
- 每周例会：周一 10:00
设置定时任务
使用 cron 功能设置定期检查：
# 编辑配置添加定时任务
openclaw config edit
多模型切换
在配置文件中设置多个模型：
{
"models": {
"default": "miaoda/miaoda-model-auto",
"creative": "miaoda/miaoda-auto-multimodal",
"fast": "轻量级模型"
}
}
📚 参考资源
OpenClaw 官方文档
GitHub 仓库
Discord 社区
飞书开放平台
🆘 获取帮助
遇到问题？试试以下方式：
查看日志：
openclaw gateway logs运行诊断：
openclaw status查阅文档：
/usr/lib/node_modules/openclaw/docs社区求助：Discord 或 GitHub Issues
🦞 龙虾提示: 安装完成后，记得说一声「OpenClaw 已就绪！」
