OpenClaw 在 Windows 环境下的 WSL 部署与飞书配置指南

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash

3.4 安装 Node.js

sudo apt install -y nodejs

3.5 验证安装

node --version # 应输出 v22.x.x

4 一键安装 OpenClaw

在 WSL 终端中运行安装脚本：

curl -fsSL https://openclaw.ai/install.sh | bash

等待 2-5 分钟，安装完成后会自动进入配置向导。

若在安装过程中遇到类似下面的错误（sharp 模块安装失败）：

!npminstall failed for openclaw@latest

请按以下步骤手动修复（所有命令仍在 WSL 终端中执行）：

4.1 清理 npm 缓存（避免残留文件干扰）

npm cache clean --force

4.2 安装构建工具（node-gyp）

sudo npm install --global npm@latest
sudo npm install --global node-gyp

4.3 设置 sharp 国内镜像并手动安装 sharp

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

4.4 重新安装 OpenClaw（指定版本）

sudo npm install --loglevel info --global [email protected]

等待几分钟，如果一切顺利，OpenClaw 就会安装成功。

4.5 验证安装

openclaw --version

输出 2026.3.2 表示 Openclaw 安装成功！

5 Openclaw 配置

安装完成后，会自动进入交互式配置向导。如果没有自动启动，可以手动运行：

openclaw onboard --install-daemon

--install-daemon 会将 OpenClaw 注册为系统服务，实现开机自启。

5.1 安全提醒

系统会提示 OpenClaw 是实验性软件，可能访问你的文件和网络。

操作：用键盘左箭头←选择 Yes 并回车。

注：OpenClaw 需读取文件来执行任务，建议不要在存放敏感文件的电脑上使用，或注意限制其访问范围。

5.2 选择安装模式

选择 QuickStart（快速开始）后回车，它会帮你配置好基础设置。

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

5.3 选择 AI 模型提供商

用上下箭头选择，回车确认。

推荐如下：

初次尝试可选 MiniMax 或 Kimi，注册就有免费额度，国内直连无需魔法。

5.4 选择默认模型

根据提供商选择推荐模型，同样上下箭头选择，回车确认：

5.5 连接 AI 模型

选 Paste API Key now，接着创建一个 API Key 并复制至此。

以 MiniMax 为例：访问 该地址 → 注册 → 左侧选择 接口密钥 → 创建新的 API Key → 复制密钥（只显示一次，务必保存）。

其他提供商获取地址：

OpenAI

Gemini

Claude

DeepSeek

Kimi

再次确认模型：

5.6 配置聊天渠道

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

可以先选 跳过（Skip）。网页面板默认可用，后续可通过 openclaw onboard 重新配置。

本示例选择 Feishu/Lark（飞书），并选择安装飞书插件：

5.6.1 创建飞书应用

发布应用

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

配置机器人权限

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

或者选择批量导入/导出权限，并复制如下的代码块到导入权限框中→下一步，确认新增权限→申请开通：

{"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", "offline_access","base:app:copy", "base:field:create", "base:field:delete", "base:field:read", "base:field:update", "base:record:create", "base:record:delete", "base:record:retrieve", "base:record:update", "base:table:create", "base:table:delete", "base:table:read", "base:table:update", "base:view:read", "base:view:write_only", "base:app:create", "base:app:update", "base:app:read", "board:whiteboard:node:create", "board:whiteboard:node:read", "calendar:calendar:read", "calendar:calendar.event:create", "calendar:calendar.event:delete", "calendar:calendar.event:read", "calendar:calendar.event:reply", "calendar:calendar.event:update", "calendar:calendar.free_busy:read", "contact:contact.base:readonly", "contact:user.base:readonly", "contact:user:search", "docs:document.comment:create", "docs:document.comment:read", "docs:document.comment:update", "docs:document.media:download", "docs:document:copy", "docx:document:create", "docx:document:readonly", "docx:document:write_only", "drive:drive.metadata:readonly", "drive:file:download", "drive:file:upload", "im:chat.members:read", "im:chat:read", "im:message", "im:message.group_msg:get_as_user", "im:message.p2p_msg:get_as_user", "im:message.send_as_user", "im:message:readonly", "search:docs:read", "search:message", "space:document:delete", "space:document:move", "space:document:retrieve", "task:comment:read", "task:comment:write", "task:task:read", "task:task:write", "task:task:writeonly", "task:tasklist:read", "task:tasklist:write", "wiki:node:copy", "wiki:node:create", "wiki:node:move", "wiki:node:read", "wiki:node:retrieve", "wiki:space:read", "wiki:space:retrieve", "wiki:space:write_only"]}}

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

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

创建一个企业自建应用

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

前往 飞书开放平台

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

5.6.2 输入应用凭证

5.6.3 选择飞书连接方式

默认选第一个 WebSocket：

选择国内服务器：

设置群聊权限：

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

5.7 技能及其他配置

一些预设功能如网页浏览、文件管理等。建议选 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

5.8 配置飞书接收消息

回到飞书开放平台，在事件与回调的事件配置 中选择 使用长连接接收事件 并点击保存。

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

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

接着点击发布版本，等待审核通过。

然后在飞书个人版中发送一条消息给机器人，并复制最后一行的消息在 wsl 终端中运行：

再次回到聊天中与其对话测试，收到回复即表示成功了！