【AI】OpenClaw一键部署安装指南（Windows+WSL+Feishu）

优质文章学习记录

— 12 min read
【AI】OpenClaw一键部署安装指南（Windows+WSL+Feishu）

目录

OpenClaw（龙虾🦞）是一个强大的 AI 工具，但原生运行需要 Linux 环境。在 Windows 上，可以通过 WSL（Windows Subsystem for Linux，Windows 的 Linux 子系统）轻松搭建 Linux 环境并一键安装 OpenClaw。

1 安装 WSL

WSL 是微软官方提供的工具，使得我们能在 Windows 上直接运行 Linux 系统（如 Ubuntu），无需虚拟机或双系统。OpenClaw 不能直接在 Windows 上运行，但通过 WSL 可以完美运行。

1.1 以管理员身份打开 PowerShell

按 Win 键，搜索 PowerShell，右键点击“Windows PowerShell”并选择“以管理员身份运行”。

在这里插入图片描述

1.2 执行安装命令

在 PowerShell 中输入以下命令并回车：

wsl --install

系统会自动下载并安装 WSL 2 和 Ubuntu（需能访问github环境下载）。

1.3 设置 Ubuntu 用户名和密码

系统提示Create a default Unix user account: XXX后按回车键，接着设置密码并再次输入密码以确认密码。

在这里插入图片描述

安装完成后记得！！！重启电脑 ！！！

2 重启后打开 WSL 终端

之后的所有操作都在 WSL 终端（Ubuntu）中进行。

WSL 终端打开方式：

开始菜单搜索 Ubuntu 并打开或在 PowerShell 中输入 wsl 并回车。

在这里插入图片描述

打开后会看到类似 user@电脑名:~$ 的提示符。

3 安装 Node.js

在 WSL 终端中依次执行以下命令

3.1 更新软件包列表

sudoapt update

如果提示输入密码，输入之前设置的 WSL 密码（输入时不可见），按回车即可。

在这里插入图片描述

3.3 添加 Node.js 22.x 源

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

3.4 安装 Node.js

sudoaptinstall-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）

sudonpminstall--global npm@latest sudonpminstall--global node-gyp

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

exportSHARP_DIST_BASE_URL=https://npmmirror.com/mirrors/sharp-libvips/v8.15.1/ exportSHARP_IGNORE_GLOBAL_LIBVIPS=1sudonpminstall--global sharp

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

sudonpminstall--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（国内多模态大模型，如 Abab 系列）MiniMax省钱首选中文强，注册送免费额度
Moonshot AI（月之暗面，Kimi 系列大模型）国内首选国内直连，注册送额度便宜
OpenAI（GPT 系列、Codex 等）综合首选稳定，授权登录有免费额度额度较大
Anthropic（Claude 系列模型）功能备选功能最强，建议用 API较贵
Google（Gemini、PaLM 系列模型）性价比备选性价比高，建议用 API免费额度
Ollama（本地模型）本地免费本地模型，无需联网，需高配置（不推荐）完全免费

初次尝试可选 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.lognohup 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终端中运行：

在这里插入图片描述


在这里插入图片描述


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

在这里插入图片描述

Read more

告别复杂制谱流程：Arcade-plus让音乐游戏谱面创作更高效

告别复杂制谱流程：Arcade-plus让音乐游戏谱面创作更高效 【免费下载链接】Arcade-plusA better utility used to edit and preview aff files 项目地址: https://gitcode.com/gh_mirrors/ar/Arcade-plus 作为音乐游戏爱好者，你是否曾因复杂的谱面制作工具望而却步？是否经历过音符与节奏难以同步的挫败？音乐游戏谱面制作往往因专业门槛高、操作流程繁琐成为创意表达的障碍。现在，自定义谱面工具Arcade-plus将彻底改变这一现状，让你的创作灵感不再受技术限制。 直面制谱痛点：新手常遇的三大挑战 制谱过程中，即使是经验丰富的玩家也会遇到各种难题。这些痛点不仅影响创作效率，更会消磨创作热情。 ▸ 时间轴校准难：手动调整音符时间戳导致节奏偏差，反复试听修改耗时费力 ▸ 界面操作复杂：专业软件的陡峭学习曲线让新手望而生畏 ▸ 创意实现受限：预设功能不足，难以实现独特的谱面设计 Arcade-plus的直观界面设计，将复杂功能简化为一目了然的操作区域，让创作焦点回归音乐本身
FPGA助力SATA固态存储：从SATA II到SATA III的飞跃

FPGA助力SATA固态存储：从SATA II到SATA III的飞跃

FPGA sataII sataIII 固态存储 文件系统FPGA sata2 sata3 固态存储 1.支持xilinx全系列 FPGA器件 2.提供文件系统 3.提供硬件解决方案 4.移植方便，相当于操作fifo接口就可以了，根据记录行程文件 在存储技术的快速发展历程中，固态存储凭借其高速、稳定等特性，逐渐占据了重要地位。而FPGA（现场可编程门阵列）与SATA（串行高级技术附件）接口的结合，更是为固态存储带来了新的活力。今天就来聊聊基于FPGA的SATA II和SATA III固态存储解决方案。 一、支持Xilinx全系列FPGA器件 Xilinx的FPGA器件以其强大的可编程能力和丰富的资源闻名。我们的方案能够无缝适配Xilinx全系列FPGA，这意味着无论你使用的是面向低功耗应用的Spartan系列，还是性能强劲的Virtex系列，都能轻松搭载我们的SATA固态存储方案。这种广泛的兼容性为开发者提供了极大的灵活性，根据不同的项目需求选择最合适的FPGA芯片。 二、文件系统的提供 文件系统在固态存储中起着至关重要的作用，它负责管理存储设备上的数据组织和访问。我们提

具身神经-机器人运控通讯架构与实现系列

具身智能热潮之下，大量企业投身具身行业。在机器人本体控制方案上各家争鸣，但是试错路径太长，不少团队会在底层控制方案上走大量的弯路，导致资源浪费、项目延期甚至破产。 以第一性原则，探索当前具身机器人通讯架构实现最优解，加速具身机器人行业底层控制（通讯）系统技术方向收敛。尽可能帮助机器人本体系统工程师减少试错。 本系列仅针对机器人本体控制系统底层通讯部分：小脑<--->执行器/传感器之间的架构和具体实现。 gitee链接：https://gitee.com/Lenz_s_law/embodied-nerve 博文汇总 欢迎投稿 通讯架构分析篇 * MIT开源四足机器狗通讯架构分析 * 智元灵犀X1通讯分析1-整机通讯架构 * 智元灵犀X1通讯分析2-CANFD性能优化 * 宇树G1主控拆解分析 * RS485、CAN/FD、EtherCAT三种主流机器人总线方案分析 CAN/FD技术篇 * CAN/FD总线性能分析-机器人应用 * 机器人CAN/FD总线通讯架构设计 * 机器人CAN/FD接口关键性能指标 * 机器人CAN/FD接口扩展/实现方案

FPGA Flash烧写步骤深度剖析（基于Vivado）

FPGA Flash烧写实战全解：从比特流到可靠启动（基于Vivado） 你有没有遇到过这样的场景？ FPGA设计在JTAG模式下运行完美，一切时序收敛、功能正常。可一旦断电重启，板子却“死”了——LED不闪、串口无输出、逻辑没加载。排查半天，最后发现是 Flash烧写配置出了问题 。 这并非个例。在嵌入式FPGA开发中， “能跑仿真”不等于“能上电自启” 。真正决定产品能否落地的关键一步，正是将.bit文件固化进QSPI Flash的全过程。而这一过程的核心，就是我们常说的 “vivado固化程序烧写步骤” 。 本文将以工程实践为视角，带你穿透Vivado界面背后的机制，深入剖析从生成比特流到成功启动的完整链路。不只是告诉你“怎么点”，更要讲清楚“为什么这么配”。 比特流不是终点，而是起点 很多人误以为综合实现后生成 .bit 文件就大功告成。但实际上，这个文件只是FPGA配置的“临时快照”，只能通过JTAG下载到易失性配置RAM中。断电即失，无法用于量产部署。 要想让FPGA“记住”