欢迎光临
我们一直在努力
        找回密码
当前位置：171主机测评 > 服务器技术 > 正文

Windows 10/11子系统（WSL 2）下从Ubuntu系统到OpenClaw工作流搭建的全流程1（WSL 2+Ubuntu 24.04.4+OpenClaw）

2026-06-23 分类：服务器技术 阅读(34) 评论(0)

        在学习使用 OpenClaw 时发现 OpenClaw 从搭建到使用的各种文章内容都比较分散，所以发一份我的个人整理总结的流程供大家参考。由于篇幅过长，本总结分为两篇文章呈现。

        本文章主要参考文章如下：安装 WSL | Microsoft Learnhttps://learn.microsoft.com/zh-cn/windows/wsl/installLinux 下安装与使用 NVM（Node Version Manager）全指南 — geek-blogs.comhttps://geek-blogs.com/blog/linux-install-nvm/安装与环境 | 指南 | OpenClaw 中文教程https://openclawgithub.cc/guide/install/OpenClaw 完整安装与配置文档（包含Minimax/deepseek模型接入、飞书机器人接入） – 知乎https://zhuanlan.zhihu.com/p/2012898191738156487

         本流程中所有涉及到的镜像均来自清华源。清华大学开源软件镜像站 | Tsinghua Open Source Mirrorhttps://mirrors.tuna.tsinghua.edu.cn/

目录

一、WSL 2环境搭建

1、WSL系统安装

2、检查安装是否成功并切换为WSL 2

二、Ubuntu 24.04.4 LTS镜像的下载安装与环境配置。

1、下载ubuntu-24.04.4-wsl-amd64.wsl文件。（点击文中蓝色文本可直接下载）

2、安装镜像

3、指定子系统登录

4、更换国内镜像源

三、OpenClaw安装配置

1、基础环境配置

1.1 更新软件包索引

1.2 预装NVM

1.2.1 检查是否安装NVM

1.2.2 检查依赖工具，确保 curl、wget 和 git 已安装：

1.2.3 安装NVM

1.2.4 配置 Shell 环境

1.2.4.1 确认配置文件已更新

1.2.4.2 刷新 Shell 环境

1.2.5 验证 NVM 安装

1.3 Node.js 与 npm 安装（此部分最好采用魔法连接，否则可能出现速度极慢和下载失败的问题）

2、OpenClaw安装

3、OpenClaw 初始化配置

3.1 初始化 OpenClaw

3.1.1 确认个人使用协议

3.1.2 选择初始化模式

3.1.3 选择模型/授权提供商

3.1.4 筛选模型提供商

3.1.5 选择默认模型

3.1.6 选择渠道（QuickStart 模式）

3.1.7 是否配置技能（推荐后续配置）

3.1.8 是否启用钩子（Hooks）

3.1.9 选择机器人启动方式

一、WSL 2环境搭建

        如果你的电脑为Windows 10 版本 2004 及更高版本（内部版本 19041 及更高版本）或 Windows 11 的话可以使用方法 1，否则请使用方法 2。

1、WSL系统安装

方法1：快速安装

        以管理员身份打开PowerShell或Windows Terminal。

执行以下命令：

wsl –install

系统将自动：

  • 启用 WSL 和虚拟机平台功能。
  • 下载并安装最新 WSL 2 内核。
  • 安装默认的 Ubuntu 发行版（若无其他指定）。

    • 重启电脑以完成安装。

    方法2：如果系统不支持一键安装（版本较老）

            由于作者没有安装过，所以请参考官方文档流程。如果出现问题可以在评论区进行讨论或自行查找解决方案。

    旧版 WSL 的手动安装步骤 | Microsoft Learnhttps://learn.microsoft.com/zh-cn/windows/wsl/install-manual

    2、检查安装是否成功并切换为WSL 2

            查看已安装发行版的WSL版本

    wsl -l -v

            一般会显示一个Ubuntu 22.04的默认系统，也可以使用，但本文采用的是Ubuntu 24.04.4系统，所以请参考第二部分进行安装。

            如果不需要的话可以注销以释放C盘空间,指令如下所示。

    wsl –unregister Ubuntu-22.04
    wsl –unregister <发行版名称>

            在PowerShell中运行以下命令，将WSL 2设置为默认版本：

    wsl –set-default-version 2

            至此WSL 2环境的安装搭建完成

    二、Ubuntu 24.04.4 LTS镜像的下载安装与环境配置。

    1、下载ubuntu-24.04.4-wsl-amd64.wsl文件。（点击文中蓝色文本可直接下载）

     镜像源地址：Index of /ubuntu-releases/24.04.4/ | 清华大学开源软件镜像站 | Tsinghua Open Source Mirrorhttps://mirrors.tuna.tsinghua.edu.cn/ubuntu-releases/24.04.4/ 

    2、安装镜像

    在PowerShell中运行以下命令

    wsl –import OpenClaw "F:\\WSL\\Openclaw" "C:\\Users\\用户名\\Downloads\\ubuntu-24.04.4-wsl-amd64.wsl"

    # wsl –import <发行版名称> <安装目录> <镜像文件路径>

    名称可以自定义，这里我直接设置为了OpenClaw，安装目录和镜像文件路径请参考个人电脑。

    3、指定子系统登录

    在PowerShell中运行以下命令

    wsl -d OpenClaw
    wsl -d <子系统名>

    也可以去找快捷方式 源地址为"C:\\Users\\用户名\\AppData\\Roaming\\Microsoft\\Windows\\Start Menu"  

    4、更换国内镜像源

            由于Ubuntu官网的下载速度实在不敢恭维，故将非核心下载内容全更换为国内镜像源（此为清华源）。

            虽说清华源提示“在 Ubuntu 24.04 之前，Ubuntu 的软件源配置文件使用传统的 One-Line-Style，路径为 /etc/apt/sources.list；从 Ubuntu 24.04 开始，Ubuntu 的软件源配置文件变更为 DEB822 格式，路径为 /etc/apt/sources.list.d/ubuntu.sources。”，但我实测在Ubuntu24.04下传统格式（/etc/apt/sources.list）仍可以正常使用。所以此处仍为传统格式修改。

    # 默认注释了源码镜像以提高 apt update 速度，如有需要可自行取消注释
    deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble main restricted universe multiverse
    # deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble main restricted universe multiverse
    deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble-updates main restricted universe multiverse
    # deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble-updates main restricted universe multiverse
    deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble-backports main restricted universe multiverse
    # deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble-backports main restricted universe multiverse

    # 以下安全更新软件源为官方源配置
    deb http://security.ubuntu.com/ubuntu/ noble-security main restricted universe multiverse
    # deb-src http://security.ubuntu.com/ubuntu/ noble-security main restricted universe multiverse

    # 预发布软件源，不建议启用
    # deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble-proposed main restricted universe multiverse
    # # deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble-proposed main restricted universe multiverse

    在PowerShell中运行以下命令

    sudo nano /etc/apt/sources.list

            也可使用vim指令，看个人习惯。

            将上面代码框中的内容粘贴到此处。完成修改后，按 Ctrl + X 退出 nano 编辑器 ，按 Y 保存更改。

    更新缓存验证是否成功

    sudo apt update && sudo apt upgrade -y

    三、OpenClaw安装配置

    1、基础环境配置

            在开始安装之前，请确保你的系统满足以下要求：

    必需环境

    • Node.js ≥ 22.0.0
    • npm ≥ 10.0.0（或 pnpm ≥ 8.0.0）

    推荐配置

    • 操作系统：Linux、macOS、Windows 10/11
    • 内存：至少 4GB RAM（推荐 8GB 以上）
    • 存储空间：至少 2GB 可用空间
    • 包管理器：推荐使用 pnpm（性能更好，磁盘占用更少）

    1.1 更新软件包索引

    sudo apt update

    1.2 预装NVM

            后续需要使用NVM来安装 Node.js 与 npm，官方也提供了fnm和docker的安装方式，可自行选择。本处只提供通过NVM的安装流程。

    1.2.1 检查是否安装NVM

    nvm –version

    已安装会出现版本号。

    1.2.2 检查依赖工具，确保 curl、wget 和 git 已安装：

    # 检查 curl
    curl –version

    # 检查 wget
    wget –version

    # 检查 git
    git –version

    若某工具缺失，通过包管理器安装：

    sudo apt install curl wget git

    1.2.3 安装NVM

            NVM 的最新版本可在 GitHub 发布页 查看。截至2026/04/22，最新稳定版为 v0.40.4，安装命令如下：

    方式一：使用 curl

    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash

    方式二：使用 wget

    wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash

    此步骤需要连接的上Github，连接不上的话需要一点魔法。

    1.2.4 配置 Shell 环境

            安装脚本会自动将 NVM 配置添加到用户的 Shell 配置文件（如 ~/.bashrc、~/.zshrc、~/.profile 或 ~/.bash_profile），但需手动刷新 Shell 环境使其生效。

    1.2.4.1 确认配置文件已更新

    打开 Shell 配置文件（以 ~/.bashrc 为例）：

    nano ~/.bashrc

    也可使用 vim、code 等编辑器（nano指令按 Ctrl + X 退出 nano 编辑器 ，按 Y 保存更改。）

    检查文件末尾是否有类似以下内容（NVM 自动添加）：

    export NVM_DIR="$HOME/.nvm"
    [ -s "$NVM_DIR/nvm.sh" ] && \\. "$NVM_DIR/nvm.sh"  # 加载 NVM
    [ -s "$NVM_DIR/bash_completion" ] && \\. "$NVM_DIR/bash_completion"  # 加载 NVM bash 补全

    若未添加，需手动复制上述内容到配置文件并保存。

    1.2.4.2 刷新 Shell 环境

    执行以下命令使配置生效，或直接重启终端：

    source ~/.bashrc

    1.2.5 验证 NVM 安装

    安装完成后，运行以下命令验证 NVM 是否可用：

    nvm –version

    有数字版本号输出则安装成功。

    1.3 Node.js 与 npm 安装（此部分最好采用魔法连接，否则可能出现速度极慢和下载失败的问题）

    官方提供了全流程下载方式，可以直接使用。

    Node.js — Download Node.js®https://nodejs.org/en/download本文只提供使用 NVM 来下载安装 Node.js v24.15.0 LTS 和npm的代码。

    • 安装NVM

    这一段代码作用与上一段删除内容相同,不必重复操作。

    # Download and install nvm:
    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash

    # in lieu of restarting the shell
    \\. "$HOME/.nvm/nvm.sh"

    • 安装Node.js v24.15.0 LTS 和npm。

    # Download and install Node.js:
    nvm install 24

    # Verify the Node.js version:
    node -v # Should print "v24.15.0".

    # Verify npm version:
    npm -v # Should print "11.12.1".

    2、OpenClaw安装

    2.1 使用 npm 安装OpenClaw

    npm install -g openclaw@latest

    2.2 验证安装 安装完成后，验证 OpenClaw 是否正确安装：

    openclaw –version

    3、OpenClaw 初始化配置

    3.1 初始化 OpenClaw

    openclaw onboard –install-daemon

    执行命令后，进入交互式配置界面，按以下指引选择选项，所有可选项均完整列出：

            （如果出现BUG可以通过国内AI工具快速解决，此处我依次出现了3个外部依赖缺失故障，通过豆包解决了问题。）

    3.1.1 确认个人使用协议

    提示内容：I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue? 可选选项：● Yes / ○ No

    选择：● Yes（回车确认）

    3.1.2 选择初始化模式

    提示内容：Onboarding mode 可选选项： ● QuickStart (Configure details later via openclaw configure.) ○ Manual

    选择：● QuickStart（快速初始化，后续可通过命令补充配置，回车确认）

    3.1.3 选择模型/授权提供商

    提示内容：Model/auth provider 可选选项：（上方为各类模型提供商，最下方为跳过选项） ○ Anthropic ○ OpenAI ○ MiniMax …（其他提供商） ● Skip for now

    选择：● Skip for now（暂时跳过，后续通过 config 命令配置模型，回车确认）

    3.1.4 筛选模型提供商

    提示内容：Filter models by provider 可选选项：● All providers / ○ 其他具体提供商

    选择：● All providers（显示所有提供商的模型，回车确认）

    3.1.5 选择默认模型

    提示内容：Default model 可选选项：● Keep current (default: anthropic/claude-opus-4-6) / ○ 其他模型

    选择：● Keep current（保留默认模型，后续可修改，回车确认）

    3.1.6 选择渠道（QuickStart 模式）

    提示内容：Select channel (QuickStart) 可选选项： ○ Feishu/Lark (飞书) ○ WeChat (微信) …（其他渠道） ● Skip for now (You can add channels later via openclaw channels add)

    选择：● Skip for now（暂时跳过渠道配置，后续补充，回车确认）

    3.1.7 是否配置技能（推荐后续配置）

    提示内容：Configure skills now? (recommended) 可选选项：● Yes / ○ No

    选择：○ No（暂时不配置，回车确认）

    3.1.8 是否启用钩子（Hooks）

    提示内容：Enable hooks? 可选选项：◻ Skip for now / ○ 其他钩子选项

    操作：按空格键勾选 ◻ Skip for now，变为 ☑ Skip for now 后，回车确认

    3.1.9 选择机器人启动方式

    提示内容：How do you want to hatch your bot? 可选选项： ● Open the Web UI ○ Run in background (daemon mode) ○ Exit (configure later)

    选择：● Open the Web UI（打开 Web 管理界面，回车确认）

    3.2 访问 OpenClaw 网页控制面板

    openclaw dashboard

    复制第一项链接到浏览器打开（类似"Dashboard URL: http://127.0.0.1:18789/#token=XXXX"）即可看到OpenClaw控制台。

    赞(0)
    未经允许不得转载：171主机测评 » Windows 10/11子系统（WSL 2）下从Ubuntu系统到OpenClaw工作流搭建的全流程1（WSL 2+Ubuntu 24.04.4+OpenClaw）
    分享到： 更多 (0)
    标签：

    相关推荐

    评论 抢沙发

    取消

    • 昵称 (必填)
    • 邮箱 (必填)
    • 网址

    热门标签

    #人工智能(57803)#python(19691)#开发语言(16568)#java(15210)#运维(15143)#linux(14774)#大数据(14340)#服务器(12898)#算法(11607)#前端(10685)#网络(9210)#数据库(8748)#ai(8644)#c++(8045)#课程设计(6758)#学习(6638)#机器学习(6609)#区块链(5838)#OpenClaw(5378)#后端(5058)#spring boot(4955)#深度学习(4841)#c语言(4325)#毕业设计(4277)#数据结构(4145)#安全(3946)#docker(3890)#架构(3768)#javascript(3761)#大模型(3595)

    热门文章

    最新文章

    归档

    分类