WSL2通过镜像还原方式快速部署Openclaw

快速部署指南：基于DeepSeek与飞书的Ubuntu虚拟机镜像，30分钟完成私有AI助手搭建

你是否希望在本地快速搭建一个集成DeepSeek大模型能力、并能通过飞书机器人便捷调用的AI开发环境？我们提供的基于WSL2的Ubuntu预配置虚拟机镜像，正是为你量身打造的“一站式AI应用解决方案”。本文提供的详细操作教程，无论你是经验丰富的开发者，还是初次接触AI部署的新手，都能在30分钟内顺利完成整个配置流程。

第一步：系统环境准备

在开始部署前，请确保准备齐全所有必要组件。建议将下列三个核心文件统一保存在D盘根目录下，便于后续操作管理。

1. 启用Windows子系统功能
首先，需要激活Windows系统的两项关键功能。请通过控制面板或系统设置启用“适用于Linux的Windows子系统”和“虚拟机器平台”这两个选项。系统会提示重启计算机，请按照提示完成重启操作。

2. 下载部署所需文件
准备工作的核心是获取下列三个必需文件，它们是搭建DeepSeek飞书AI助手环境的基础：

• Ubuntu集成镜像文件：建议保存路径为 D:\ubuntu-backup.tar。
  百度网盘下载链接：https://pan.baidu.com/s/1_c76avA-2Teay5HqYECZRg?pwd=m71w 提取码：m71w
• WSL2内核更新包：建议保存为 D:\wsl.2.6.3.0.x64.msi。
  百度网盘下载链接：https://pan.baidu.com/s/1mJnqQA9G46z-QhEXgrgCbg?pwd=cyed 提取码：cyed
• 自动化配置脚本：建议保存为 D:\update_openclaw.ps1。
  百度网盘下载链接：https://pan.baidu.com/s/1DD-kfhszo9l_XPllPeGZzw?pwd=dtp2 提取码：dtp2

第二步：配置WSL2运行环境

完成基础文件下载后，现在开始配置WSL2运行环境。请注意，所有PowerShell命令都需要以管理员身份运行，这是确保命令执行权限的关键。

在管理员PowerShell中依次执行以下两条命令来启用核心功能：

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

更新WSL内核组件

接下来，安装之前下载的WSL内核更新包。找到wsl.2.6.3.0.x64.msi文件，双击运行安装程序。安装过程采用默认设置即可，点击“下一步”直至安装完成。

安装完成后，回到管理员PowerShell，执行以下命令将WSL2设置为默认版本：

wsl --set-default-version 2

第三步：导入Ubuntu集成镜像

WSL2环境配置完毕后，接下来开始部署集成了OpenClaw的Ubuntu系统镜像。

1. 创建系统安装目录
首选，在PowerShell中为Ubuntu系统创建安装目录。以下以D:\WSL\Ubuntu-24.04为例进行演示，你也可以自定义其他路径。

mkdir D:\WSL\Ubuntu-24.04

请记录此目录路径：D:\WSL\Ubuntu-24.04（如果修改了路径，后续所有命令中的路径都需要相应更新）。

2. 导入预配置镜像
这是部署DeepSeek飞书AI助手的核心步骤，将下载的集成镜像导入到指定目录。请注意，如果上一步修改了安装路径，本命令中的D:\WSL\Ubuntu-24.04也需要同步修改。

wsl --import Ubuntu-24.04 D:\WSL\Ubuntu-24.04 D:\ubuntu-backup.tar --version 2

镜像导入过程可能需要几分钟时间，请耐心等待命令行执行完成。

3. 启动Ubuntu虚拟机
镜像导入成功后，即可启动Ubuntu虚拟机。执行命令后，系统将显示标准的Linux命令行终端界面。

第四步：获取API密钥与飞书凭证

系统运行正常后，现在需要配置AI能力调用的关键凭证——DeepSeek API Key和飞书机器人访问凭证。

1. 申请DeepSeek API Key
本镜像默认集成DeepSeek云端API接口。你需要访问DeepSeek开放平台，注册并登录账户后，在API管理界面创建新的API密钥。平台为新用户提供免费额度，足以满足日常测试和使用需求。密钥创建成功后，请立即复制并安全保存该Key，关闭页面后将无法再次查看完整密钥。

2. 创建飞书自定义机器人
为了让DeepSeek AI助手能够在飞书群聊中直接响应，需要在飞书开放平台创建自定义机器人应用，并获取相应的身份凭证。详细的创建步骤和配置方法，可以参考这篇详细的第三方教程：
【保姆级教程】手把手教你安装OpenClaw并接入飞书，让AI在聊天软件里帮你干活-腾讯云开发者社区-腾讯云
按照教程指引操作，最终你将获得机器人的App ID和App Secret，这两个凭证与DeepSeek API Key同等重要。

第五步：自动化配置OpenClaw

所有准备工作就绪后，现在使用我们提供的PowerShell脚本，快速完成OpenClaw的最终配置。

运行配置脚本

打开PowerShell（此时无需管理员权限），首先执行以下命令设置脚本执行策略：

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

接着，运行下载的配置脚本：

.\update_openclaw.ps1

脚本将以交互方式提示你输入配置信息，请按顺序填入：
- 从DeepSeek平台获取的 apiKey
- 从飞书机器人配置获取的 appId
- 从飞书机器人配置获取的 appSecret
具体输入过程如下图所示：

脚本执行完成后，请执行最后的关键步骤：返回Ubuntu虚拟机的命令行界面，执行服务重启命令使所有配置生效：

openclaw gateway restart

部署完成！

验证部署结果：访问Web管理界面

打开你的浏览器，访问以下本地地址（请注意替换为实际生成的token）：

127.0.0.1:18789/#token=66682db26fe6f1693570085e2009c52bf8a688901aa542fc

如果全部配置正确，你将看到OpenClaw Web管理控制台界面，如下图所示，这表明DeepSeek飞书AI助手环境已成功部署并正常运行。

附：OpenClaw服务管理常用命令
环境部署完成后，你可能需要以下命令来管理和维护你的AI助手服务：

• openclaw gateway status 查看服务运行状态
• openclaw gateway restart 重启服务（修改配置后必须执行）
• openclaw gateway stop 停止运行服务
• openclaw gateway start 启动服务
• openclaw configure 进入交互式配置向导
• openclaw doctor 系统环境诊断与自动修复