OpenClaw(龙虾🦞)是一个强大的 AI 工具,但原生运行需要 Linux 环境。在 Windows 上,可以通过 WSL(Windows Subsystem for Linux,Windows 的 Linux 子系统)轻松搭建 Linux 环境并一键安装 OpenClaw。
WSL 是微软官方提供的工具,使得我们能在 Windows 上直接运行 Linux 系统(如 Ubuntu),无需虚拟机或双系统。OpenClaw 不能直接在 Windows 上运行,但通过 WSL 可以完美运行。
按 Win 键,搜索 PowerShell,右键点击“Windows PowerShell”并选择“以管理员身份运行”。

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

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

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


在 WSL 终端中运行安装脚本:
等待 2-5 分钟,安装完成后会自动进入配置向导。
若在安装过程中遇到类似下面的错误(sharp 模块安装失败):
请按以下步骤手动修复(所有命令仍在 WSL 终端中执行):
等待几分钟,如果一切顺利,OpenClaw 就会安装成功。
输出2026.3.2表示Openclaw安装成功!

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

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

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

用上下箭头选择,回车确认。
推荐如下:
初次尝试可选 MiniMax 或 Kimi,注册就有免费额度,国内直连无需魔法。
根据提供商选择推荐模型,同样上下箭头选择,回车确认:


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

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

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

5.6.1 创建飞书应用
- 前往飞书开放平台
- 创建一个企业自建应用

输入应用名称、应用描述并选择应用图标
- 从凭证与基础信息页面复制AppID和App Secret
- 添加应用能力,选择机器人
- 配置机器人权限

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

或者选择批量导入/导出权限,并复制如下的代码块到导入权限框中→下一步,确认新增权限→申请开通:
- 发布应用

填入必填信息后点击保存并确认发布:
参考文档:
Feishu – OpenClaw
OpenClaw飞书官方插件
5.6.2 输入应用凭证

5.6.3 选择飞书连接方式
默认选第一个WebSocket:

选择国内服务器:

设置群聊权限:

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


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

这里遇到一个错误:

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


同时还有个飞书重复插件的报错,使用以下命令修改:
回到飞书开放平台,在事件与回调的 事件配置 中选择 使用长连接接收事件 并点击保存。

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

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

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


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

发布者:Ai探索者,转载请注明出处:https://javaforall.net/258441.html原文链接:https://javaforall.net
