【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

Whisper 模型资源大全：官方 + 社区版本下载链接汇总

以下是关于Whisper模型的资源大全，包括官方和社区版本的下载链接汇总。Whisper是由OpenAI开发的先进语音识别模型，支持多语言转录和翻译。我将以结构清晰的方式组织信息，确保所有资源真实可靠，来源均为官方或知名社区平台（如GitHub和Hugging Face）。资源分为官方版本（由OpenAI直接提供）和社区版本（由开源社区维护），并附带简要说明。 1. 官方资源 官方版本是OpenAI发布的原始模型，提供完整的权重文件和代码。所有资源均可在OpenAI的GitHub仓库获取： * GitHub仓库链接：openai/whisper * 这里包含： * 模型权重下载：支持多种尺寸（如tiny、base、small、medium、large），下载地址在仓库的README中直接提供。 * 安装指南：使用Python和PyTorch运行模型的详细步骤。 * 示例代码：包括转录和翻译的Python脚本。 * 模型尺寸与选择：小尺寸（如base）适合快速任务，大尺寸（如large-v2）支持更高精度。 直接模型下载：仓库中的模型权

Llama-3.2V-11B-cot在金融文档处理中的应用：财报截图数据逻辑验证案例

Llama-3.2V-11B-cot在金融文档处理中的应用：财报截图数据逻辑验证案例 1. 项目背景与工具介绍 Llama-3.2V-11B-cot是基于Meta Llama-3.2V-11B-cot多模态大模型开发的高性能视觉推理工具，特别针对金融文档处理场景进行了优化。该工具在双卡4090环境下表现出色，通过深度优化解决了视觉权重加载等关键问题，支持Chain of Thought(CoT)逻辑推演能力。 在金融领域，分析师每天需要处理大量财报截图、数据表格和图表。传统人工验证方式效率低下且容易出错。Llama-3.2V-11B-cot的视觉推理能力可以自动识别金融文档中的关键数据，并进行逻辑验证，大幅提升工作效率。 2. 金融文档处理的核心挑战 2.1 传统方法的局限性 金融文档处理面临三大核心挑战： * 数据识别准确率低：财报截图中的表格结构复杂，传统OCR技术难以准确识别 * 逻辑验证困难：财务数据间的勾稽关系需要专业金融知识才能验证 * 处理效率低下：人工核对一份财报平均需要2-3小时，高峰期难以应对 2.2 Llama-3.2V-11B-cot的

ChatGPT降AIGC率指令实战指南：从原理到最佳实践

AIGC率：一个开发者必须面对的质量指标 最近在项目里用ChatGPT这类大模型生成内容时，总被一个词困扰——AIGC率。简单来说，它衡量的是生成内容与模型训练数据中已有内容的相似度，或者说“机器味儿”有多浓。对于开发者而言，高AIGC率不仅意味着内容可能缺乏新意、流于模板化，在严肃的应用场景（如知识输出、创意写作、代码生成）中，更可能引发原创性不足、甚至潜在的合规风险。因此，学会通过指令（Prompt）有效控制AIGC率，从“能用”走向“用好”，成了我们进阶路上的必修课。 1. 高AIGC率问题的根源：为什么模型总在“复读”？ 要解决问题，先要理解问题从何而来。大语言模型本质上是基于海量数据训练出的概率模型，其生成过程是预测下一个最可能的词元（Token）。这导致了几种常见的高AIGC率诱因： * 指令模糊或过于宽泛：当Prompt如“写一篇关于春天的文章”时，模型极易落入最常见的训练数据模式，产出千篇一律的套话。 * 缺乏具体约束与引导：没有提供独特的视角、具体的细节要求、期望的文体或情感基调，模型没有“

【工具】GitHub学生认证+PyCharm配置Copilot全流程指南

1. 为什么你需要GitHub学生认证和Copilot？ 如果你是一名在校学生，并且对编程、软件开发或者任何需要写代码的事情感兴趣，那你今天算是来对地方了。我猜你可能已经听说过GitHub Copilot这个“AI结对编程”神器，它能像一位经验丰富的搭档一样，在你写代码时实时给出建议，从补全一行代码到生成整个函数，甚至帮你写注释和测试用例。但它的订阅费用对于学生来说，可能是一笔不小的开销。 好消息是，GitHub为全球的学生提供了免费的Copilot Pro访问权限。是的，你没听错，完全免费。这不仅仅是试用，而是只要你保持学生身份，就可以持续享受的权益。我当年读书的时候可没这么好的事，现在看到学生们能免费用到这么强大的工具，真是既羡慕又欣慰。通过学生认证，你不仅能白嫖Copilot，还能解锁GitHub Pro账户、JetBrains全家桶的教育许可证、各种云服务商的免费额度等一大堆“学生包”福利，价值远超千元。 那么，整个流程到底麻不麻烦？实话说，如果你按部就班操作，顺利的话半小时内就能搞定。但我也见过不少同学因为一些细节没注意，卡在某个环节反复折腾。这篇文章，我就结合自己帮学