本教程整合了有道云笔记的 WSL 安装指南与 GitHub 上 m1heng/clawdbot-feishu 项目的飞书接入方法，帮助你从零开始搭建一个可以通过飞书交互的个人 AI 助手。
- 什么是 OpenClaw
- 环境准备
- WSL2 安装与配置
- OpenClaw 安装
- OpenClaw 初始配置
- 飞书开放平台应用创建
- 安装飞书插件
- 飞书插件配置
- 启动与测试
- 常见问题排查
- 进阶配置
OpenClaw（曾用名 ClawdBot、MoltBot）是一个开源的个人 AI 助手平台。它部署在你自己的电脑上，让你能够完全掌控自己的数据。通过 WhatsApp、Telegram、飞书等聊天工具，你可以与它交互，让它处理邮件、管理文件、编写代码，甚至控制你的电脑。
核心特点：
- 本地部署，数据私有
- 支持多种大语言模型（Claude、GPT、Gemini 等）
- 支持多平台聊天渠道
- 可扩展的技能（Skills）系统
- 拥有持久记忆功能
2.1 系统要求
| 项目 | 要求 |
|——|——|
| 操作系统 | Windows 10 版本 2004+ 或 Windows 11 |
| WSL2 | Ubuntu 22.04 或 24.04（推荐） |
| Node.js | 版本 22 或更高 |
| 内存 | 建议 8GB+ |
| 飞书账户 | 企业版账户（个人账户无法创建自建应用） |
2.2 需要准备的 API Key（任选其一）
- Anthropic API Key（推荐，用于 Claude 模型）
- OpenAI API Key（用于 GPT 模型）
- Google AI API Key（用于 Gemini 模型）
3.1 安装 WSL2
以管理员身份打开 PowerShell，执行：
这将自动安装 WSL2 和 Ubuntu。安装完成后重启电脑。
3.2 初始化 Ubuntu
重启后，Ubuntu 会自动启动并要求你设置用户名和密码。
3.3 更新系统
3.4 安装 Node.js 22
3.5 配置 systemd（WSL2 后台服务必需）
编辑或创建 ：
添加以下内容：
保存后，在 PowerShell 中重启 WSL：
4.1 一键安装（推荐）
在 WSL Ubuntu 终端中执行：
安装脚本会自动检测系统环境并安装 OpenClaw CLI。
4.2 手动安装（如一键安装失败）
如果遇到权限问题：
4.3 验证安装
5.1 运行配置向导
向导会引导你完成以下配置：
- Gateway 模式：选择 （本地）
- AI 模型认证：
- 选择你的模型提供商（Anthropic/OpenAI/Google）
- 输入对应的 API Key
- 通信渠道：暂时跳过（稍后配置飞书）
- 后台服务：选择 安装 systemd 服务
5.2 验证配置
5.3 启动 Gateway
如果服务未自动启动：
或手动运行（便于查看日志）：
访问 可打开 Web 控制台。
重要：飞书机器人功能需要企业版账户，个人账户无法创建自建应用。
6.1 创建自建应用
- 访问 飞书开放平台（国际版使用 Lark Open Platform）
- 登录企业账户
- 点击「创建企业自建应用」
- 填写应用名称和描述（如：OpenClaw AI 助手）
- 点击「创建」
6.2 添加机器人能力
- 进入应用详情页
- 在「添加应用能力」中选择「机器人」
- 点击添加
6.3 获取凭证
在「凭证与基础信息」页面记录：
- App ID：格式为
- App Secret：保密字符串
6.4 配置权限
进入「权限管理」，开启以下权限：
必需权限（6项）：
| 权限标识 | 说明 |
|———-|——|
| | 获取用户基本信息 |
| | 发送和接收消息 |
| | 读取私聊消息 |
| | 接收群聊 @机器人 消息 |
| | 以机器人身份发送消息 |
| | 上传和下载图片/文件 |
可选权限（完整功能）：
| 权限标识 | 说明 |
|———-|——|
| | 读取群聊所有消息（敏感） |
| | 获取消息历史 |
| | 更新/编辑已发送消息 |
| | 撤回已发送消息 |
6.5 配置事件订阅
- 进入「事件与回调」
- 关键步骤：选择「长连接」作为订阅方式（不要选 Webhook）
- 添加事件：搜索「接收消息」，启用
为什么选择长连接？ 长连接模式更稳定，无需暴露端口或配置 SSL 证书，适合本地部署。
6.6 发布应用
- 进入「版本管理与发布」
- 创建版本
- 至少发布到「测试版本」（供自己使用）或提交审核发布到正式版本
7.1 安装插件
在 WSL 终端中执行：
如果安装失败，可手动安装：
7.2 验证安装
应显示已安装的 插件。
8.1 配置凭证
选择飞书，然后按流程配置
8.2 重启 Gateway
配置完成后重启服务：
9.1 检查服务状态
9.2 在飞书中测试
私聊测试：
- 在飞书中搜索你的机器人名称
- 发送消息「你好」
群聊测试：
- 将机器人添加到群聊
- @机器人 并发送消息
openclaw
10.1 Gateway 无法启动
10.2 WSL2 网络问题
如需从其他设备访问 WSL 中的服务，需要设置端口转发：
11 日常维护命令
发布者：Ai探索者，转载请注明出处：https://javaforall.net/258665.html原文链接：https://javaforall.net
