OpenClaw 在 Windows WSL 环境下的部署与飞书配置指南
在 Windows 系统通过 WSL 子系统部署 OpenClaw AI 工具的完整流程。内容包括安装 WSL、配置 Node.js 环境、执行一键安装脚本,以及解决 sharp 模块和 systemd 服务启动等常见问题。后续章节详细说明了如何配置 AI 模型提供商(如 MiniMax、Kimi 等)及飞书聊天渠道的接入步骤,包括创建应用、设置权限和回调配置,最终实现本地 AI 助手与飞书的交互。

在 Windows 系统通过 WSL 子系统部署 OpenClaw AI 工具的完整流程。内容包括安装 WSL、配置 Node.js 环境、执行一键安装脚本,以及解决 sharp 模块和 systemd 服务启动等常见问题。后续章节详细说明了如何配置 AI 模型提供商(如 MiniMax、Kimi 等)及飞书聊天渠道的接入步骤,包括创建应用、设置权限和回调配置,最终实现本地 AI 助手与飞书的交互。

WSL 是微软官方提供的工具,使得我们能在 Windows 上直接运行 Linux 系统(如 Ubuntu),无需虚拟机或双系统。OpenClaw 不能直接在 Windows 上运行,但通过 WSL 可以完美运行。
按 Win 键,搜索 PowerShell,右键点击'Windows PowerShell'并选择'以管理员身份运行'。

在 PowerShell 中输入以下命令并回车:
wsl --install
系统会自动下载并安装 WSL 2 和 Ubuntu(需能访问 github 环境下载)。
系统提示 Create a default Unix user account: XXX 后按回车键,接着设置密码并再次输入密码以确认密码。

安装完成后记得重启电脑。
之后的所有操作都在 WSL 终端(Ubuntu)中进行。
WSL 终端打开方式:开始菜单搜索 Ubuntu 并打开或在 PowerShell 中输入 wsl 并回车。

打开后会看到类似 user@电脑名:~$ 的提示符。
在 WSL 终端中依次执行以下命令
sudo apt update
如果提示输入密码,输入之前设置的 WSL 密码(输入时不可见),按回车即可。

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
node --version # 应输出 v22.x.x

在 WSL 终端中运行安装脚本:
curl -fsSL https://openclaw.ai/install.sh | bash
等待 2-5 分钟,安装完成后会自动进入配置向导。
若在安装过程中遇到类似下面的错误(sharp 模块安装失败):
!npminstall failed for openclaw@latest
请按以下步骤手动修复(所有命令仍在 WSL 终端中执行):
npm cache clean --force
sudo npm install --global npm@latest
sudo npm install --global node-gyp
export SHARP_DIST_BASE_URL=https://npmmirror.com/mirrors/sharp-libvips/v8.15.1/
export SHARP_IGNORE_GLOBAL_LIBVIPS=1
sudo npm install --global sharp
sudo npm install --loglevel info --global [email protected]
等待几分钟,如果一切顺利,OpenClaw 就会安装成功。
openclaw --version
输出 2026.3.2 表示 Openclaw 安装成功!

安装完成后,会自动进入交互式配置向导。如果没有自动启动,可以手动运行:
openclaw onboard --install-daemon
--install-daemon 会将 OpenClaw 注册为系统服务,实现开机自启。
系统会提示 OpenClaw 是实验性软件,可能访问你的文件和网络。
操作:用键盘左箭头←选择 Yes 并回车。

注:OpenClaw 需读取文件来执行任务,建议不要在存放敏感文件的电脑上使用,或注意限制其访问范围。
选择 QuickStart(快速开始)后回车,它会帮你配置好基础设置。

熟悉后可用 openclaw onboard 重新自定义配置。

用上下箭头选择,回车确认。
推荐如下:
| 提供商 | 定位 | 特点 | 价格 |
|---|---|---|---|
| MiniMax(国内多模态大模型,如 Abab 系列) | MiniMax | 省钱首选 | 中文强,注册送免费额度 |
| Moonshot AI(月之暗面,Kimi 系列大模型) | 国内首选 | 国内直连,注册送额度 | 便宜 |
| OpenAI(GPT 系列、Codex 等) | 综合首选 | 稳定,授权登录有免费额度 | 额度较大 |
| Anthropic(Claude 系列模型) | 功能备选 | 功能最强,建议用 API | 较贵 |
| Google(Gemini、PaLM 系列模型) | 性价比备选 | 性价比高,建议用 API | 免费额度 |
| Ollama(本地模型) | 本地免费 | 本地模型,无需联网,需高配置(不推荐) | 完全免费 |
初次尝试可选 MiniMax 或 Kimi,注册就有免费额度,国内直连无需魔法。
根据提供商选择推荐模型,同样上下箭头选择,回车确认:


选 Paste API Key now,接着创建一个 API Key 并复制至此。
以 MiniMax 为例:访问 该地址 → 注册 → 左侧选择 接口密钥 → 创建新的 API Key → 复制密钥(只显示一次,务必保存)。
其他提供商获取地址:
再次确认模型:

配置如何与 OpenClaw 交互。选项包括 Telegram、WhatsApp、飞书、网页面板等:

可以先选 跳过(Skip)。网页面板默认可用,后续可通过 openclaw onboard 重新配置。
这里我选择 Feishu/Lark(飞书),并选择安装飞书插件:

发布应用

填入必填信息后点击保存并确认发布:

配置机器人权限

可以选择点击开通权限后在弹窗中选择需开通的权限:

或者选择批量导入/导出权限,并复制如下的代码块到导入权限框中→下一步,确认新增权限→申请开通:
{"scopes":{"tenant":["contact:contact.base:readonly", "docx:document:readonly", "im:chat:read", "im:chat:update", "im:message.group_at_msg:readonly", "im:message.p2p_msg:readonly", "im:message.pins:read", "im:message.pins:write_only", "im:message.reactions:read", "im:message.reactions:write_only", "im:message:readonly", "im:message:recall", "im:message:send_as_bot", "im:message:send_multi_users", "im:message:send_sys_msg", "im:message:update", "im:resource", "application:application:self_manage", "cardkit:card:write", "cardkit:card:read"], "user":["contact:user.employee_id:readonly",

添加应用能力,选择机器人

从凭证与基础信息页面复制 AppID 和 App Secret

创建一个企业自建应用

输入应用名称、应用描述并选择应用图标

前往 飞书开放平台

参考文档: Feishu - OpenClaw OpenClaw 飞书官方插件

默认选第一个 WebSocket:

选择国内服务器:

设置群聊权限:

选择白名单并设置群聊名称:


一些预设功能如网页浏览、文件管理等。建议选 Yes 全部启用,后续可随时关闭。
对于个性、记忆等高级配置建议按空格键选 Skip for now 跳过,后续通过聊天方式设置更方便。
对于接下来的选择都选择 No:

这里遇到一个错误:

核心问题是 OpenClaw 想通过 Linux 的 systemd(系统服务管理器)设置开机自启 / 后台运行,但 WSL Ubuntu 默认没启用 systemd,导致 systemctl 命令用不了,报'无法检查 openclaw-gateway.service 是否启用';
这里使用手动启动 OpenClaw 网关,不配置 systemd 使用 Gateway 后台运行及开机自启。因此使用以下命令修复,跳过 systemd 直接启动核心服务:
# 直接启动 gateway,默认前台运行 openclaw gateway run
或者
# 用 nohup 后台启动,日志存到 openclaw-gateway.log
nohup openclaw gateway run > ~/openclaw-gateway.log 2>&1 &
接着使用以下命令验证 Gateway 是否启动成功(前台运行,需再开一个 wsl 终端):
openclaw gateway status
输出 Gateway is running 表示启动成功;
此时访问 http://127.0.0.1:18789 就能打开 OpenClaw 控制台。


同时还有个飞书重复插件的报错,使用以下命令修改:
# 删除重复的飞书插件文件夹
rm -rf /home/XXX/.openclaw/extensions/feishu
# 重启 Gateway
openclaw gateway run
回到飞书开放平台,在事件与回调的事件配置中选择 使用长连接接收事件 并点击保存。

点击添加事件,并在 消息与群组 中勾选 接收消息、消息已读、机器人进群、机器人被移除群。

接着在 回调配置 中同样的 使用长连接接收回调。

接着点击发布版本,等待审核通过。
然后在飞书个人版中发送一条消息给机器人,并复制最后一行的消息在 wsl 终端中运行:


再次回到聊天中与其对话测试,有回复即表示成功了!


微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online