OpenClaw 安装指南(Windows 10 + WSL2 版)

⚠️ 温馨提示:本文更新于 2026-03-20。技术内容具有时效性,若发现步骤错误或链接失效,欢迎在下方留言反馈!后续将陆续推出其他操作系统的安装教程。

📌 为什么选择 WSL2?

在 Windows 10 上安装 OpenClaw 主要有两种路径:
  1. 直接使用 Windows Docker
  2. 通过 WSL2 (Windows Subsystem for Linux) 安装 Ubuntu,再在其中部署。
结论:请坚定选择第二种方案(WSL2 + Ubuntu)。
虽然听起来步骤稍多(有点绕),但这是最佳实践。经验表明,Windows 原生 Docker 环境配置繁琐且兼容性较差,而 WSL2 提供的 Linux 环境更加稳定、易用。

安装并配置 WSL2

在系统搜索栏中输入“PowerShell”,找到结果后右键点击,选择“以管理员身份运行”。
输入命令
wsl –install
在安装过程中,系统会提示您设置 Ubuntu 的用户名。完成该步骤后,请重启计算机。

确认 WSL 版本

重启后,再次以管理员身份打开 PowerShell,输入:
wsl -l -v

检查输出中的 VERSION 列是否为 2

如果不是 2,请执行以下命令升级:

wsl --set-version Ubuntu 2

在 Ubuntu 中安装 Node.js 22

在 Windows 开始菜单中搜索并打开 Ubuntu。

更新系统包
sudo apt update && sudo apt upgrade -y

通过 NodeSource 安装 Node.js 22(依次执行以下两条命令):

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

验证安装

node –version
npm –version

若正确显示版本号,则安装成功。

部署 OpenClaw

安装 Git 并克隆项目

在 Ubuntu 终端中执行:
# 安装
Git sudo apt install -y git
# 克隆 OpenClaw 仓库
git clone https://github.com/openclaw/openclaw.git
# 进入目录并安装依赖
cd openclaw && npm install

配置文件设置

复制示例配置文件并编辑:
cp .env.example .env
nano .env
在编辑器中修改以下关键信息(按 Ctrl+O 保存,Ctrl+X 退出):
# OpenClaw 环境变量配置
OPENAI_API_KEY=你的API_KEY
# ANTHROPIC_API_KEY=sk-ant-your-key  (如需使用可取消注释)
# DEEPSEEK_API_KEY=your-deepseek-key  (如需使用可取消注释)

DEFAULT_MODEL=gpt-4o
ACCESS_CODE=设置你的访问密码
PORT=3210
⚠️ 注意:如果您在配置中修改了 PORT,启动时的端口会随之改变;若未修改,默认登录端口可能为 18789(具体视程序内部逻辑而定,建议以 .env 中设置的 3210 为准)。

3. 全局安装与初始化

# 将包安装到全局
sudo npm install -g .

# 运行配置向导
openclaw configure

启动服务

方式一:首次启动(在当前目录)

由于当前已在 openclaw 目录下,可直接运行:
# 启动网关(如需)
npm start -- gateway

# 启动主程序(龙虾)
npm start

方式二:日常启动(推荐命令)

下次使用时,需先进入目录再启动。可以使用组合命令一键完成:
cd ~/openclaw && npm start


🎉 完成

至此,OpenClaw(龙虾)的核心对话功能已安装完毕!
目前的版本仅具备基础对话能力,后续我们将继续教程,为它安装“手脚”和“嘴巴”(插件与扩展功能),敬请期待下一篇文章!
1. 本站所有资源来源于用户上传和网络,如有侵权请联系站长!
2. 分享目的仅供大家学习和交流,您必须在下载后24小时内删除!
3. 不得使用于非法商业用途,不得违反国家法律。否则后果自负!
4. 本站提供的源码、模板、插件等等其他资源,都不包含技术服务请大家谅解!
5. 如有链接无法下载、失效或广告,请联系站长处理!
6. 本站不售卖代码,资源标价只是站长收集整理的辛苦费!如果您喜欢该程序,请支持正版软件,购买注册,得到更好的正版服务。

延伸阅读:

OpenClaw 安装指南(Windows 10 + WSL2 版)

⚠️ 温馨提示:本文更新于 2026-03-20。技术内容具有时效性,若发现步骤错误或链接失效,欢迎在下方留言反馈!后续...

[email protected]
2026年3月21日
2025萌次元(异次元4.0)发卡网搭建教程

异次元发卡网4.0版本(又名“萌次元”)是基于异次元店铺系统3.0进行全新重构的成果,历时两年精心打磨,始终秉持初心。该...

[email protected]
2026年3月17日