前言:OpenClaw是一款支持Windows本地部署的开源AI助手,可实现文件操作、终端控制等多种功能,无需依赖云端。本文精简核心部署步骤,适配新手快速上手,进阶配置细节可查看视频教程fuye365.github.io

一、部署前准备(必做)

1.1 系统配置要求

最低配置:Windows 10 21H2+(64位)、内存4GiB+、Node.js ≥22;推荐配置:Windows 11 23H2+、内存8GiB+、Node.js 22.x稳定版。

1.2 权限与工具

  1. 工具:确保网络通畅,命令行将自动下载依赖,详细命令解析可查看视频教程fuye365.github.io;2. 解锁权限:管理员身份打开PowerShell,输入命令并回车确认(Y):

powershell Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

二、三种核心部署方案(按需选择)

方案一:WSL2 + Ubuntu(新手首选)

  1. PowerShell输入3条命令启用WSL2,重启电脑:
    dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
    dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
    wsl --set-default-version 2

  2. 安装Ubuntu(Microsoft Store搜索Ubuntu 22.04/24.04,或命令行wsl --install -d Ubuntu-22.04),设置用户名密码。

  3. Ubuntu终端输入命令,更新系统并安装基础工具:
    sudo apt update && sudo apt upgrade -y
    sudo apt install -y curl git wget build-essential

  4. 安装Node.js 22+,验证版本(node -v显示v22.x.x):
    curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
    sudo apt install -y nodejs

  5. 一键安装OpenClaw:curl -fsSL https://openclaw.ai/install.sh | bash,验证安装(openclaw --version)。

  6. 启动网关:openclaw gateway run --port 18789,浏览器访问http://localhost:18789。

方案二:PowerShell原生部署(纯Windows用户)

  1. 官网(https://nodejs.org/zh-cn)下载Node.js 22+(64位msi),安装时勾选Add Node.js to PATH,验证版本。

  2. 管理员PowerShell输入一键安装命令:iwr -useb https://openclaw.ai/install.ps1 | iex。

  3. 初始化并启动:openclaw onboard --install-daemon(默认配置),再输入openclaw gateway run --port 18789,访问对应地址。

方案三:Docker Desktop部署(开发者)

  1. 安装Docker Desktop(勾选WSL2后端),重启后启动Docker。

  2. PowerShell输入命令部署:docker run -d -p 18789:18789 --name openclaw openclaw/openclaw:latest,访问对应地址。

三、初始化配置(通用)

访问http://localhost:18789,创建管理员账号,绑定AI模型(新手选Qwen),启用基础技能,测试指令(如“列出当前文件夹文件”)即可。

四、常见问题排查(精简)

  • 权限不足:重新执行权限解锁命令;

  • node -v无反应:重新安装Node.js并勾选PATH;

  • 无法访问网站:检查服务是否启动、端口是否占用,更换端口重试。

总结

新手优先WSL2方案,纯Windows选原生部署,开发者用Docker。本文精简核心步骤,可快速完成部署,如需进阶操作可参考相关教程。

Logo

Agent 垂直技术社区,欢迎活跃、内容共建。

更多推荐