Windows环境下OpenClaw本地部署完整指南

一、AI智能体框架OpenClaw部署openclaw.aiOpenClaw是一款完全开源、本地优先的AI智能体执行网关它不仅能对话还能直接操控电脑执行任务管理文件、编写代码、浏览网页、发送邮件等所有数据完全存储在本地设备上。系统要求操作系统Windows 10 21H2 或 Windows 11内存最低2GB推荐4GB以上存储约500MB可用空间网络互联网连接用于AI API调用本地模型可离线运行依赖Node.js 22.0.0LTS版本推荐方案一一键脚本部署新手首选5分钟完成这是官方推荐的最简单方法自动检测并安装所有依赖。以管理员身份打开PowerShell开始菜单搜索PowerShell右键点击Windows PowerShell选择以管理员身份运行允许脚本执行Windows默认禁止运行远程脚本需要先授权Set-ExecutionPolicyRemoteSigned-Scope CurrentUser当系统提示确认时输入Y并按回车。执行官方安装脚本# 官方脚本推荐iwr-useb https://openclaw.ai/install.ps1|iex# 国内网络超时可使用中国社区镜像# iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex等待2-5分钟出现OpenClaw installed successfully即为安装完成。验证安装关闭所有PowerShell窗口重新打开一个新的PowerShell窗口openclaw--version如果显示版本号说明安装成功。方案二WSL2部署官方推荐稳定性最佳官方明确表示原生Windows安装虽然可用但稳定性较差强烈推荐使用WSL2环境部署OpenClaw。安装WSL2和Ubuntu以管理员身份打开PowerShellwsl--install安装完成后重启电脑系统会自动创建Ubuntu用户账户。在WSL2中启用systemd打开Ubuntu终端编辑wsl.conf文件sudonano/etc/wsl.conf添加以下内容[boot] systemdtrue保存退出CtrlO回车CtrlX然后关闭WSLwsl--shutdown重新打开Ubuntu终端。在WSL2中安装OpenClawcurl-fsSLhttps://openclaw.ai/install.sh|bash安装完成后重新加载环境变量source~/.bashrc验证安装openclaw--version方案三Docker容器化部署生产/隔离环境首选Docker部署提供了最佳的隔离性和可移植性适合需要长期稳定运行的场景。安装Docker Desktop从Docker官网下载并安装Windows版Docker Desktop。安装时确保勾选Use the WSL 2 based engine选项。启动Docker Desktop等待Docker状态显示为Running。运行OpenClaw容器打开PowerShelldocker run-d--name openclaw-p 18789:18789--restart unless-stopped openclaw/openclaw:latest--restart unless-stopped参数确保容器在系统重启或崩溃后自动启动。验证容器运行状态dockerps你应该看到openclaw容器状态为Up。初始化配置与启动无论使用哪种部署方式都需要完成以下初始化步骤运行新手引导openclaw onboard--flow quickstart按照向导提示完成选择AI模型提供商支持Claude、OpenAI、DeepSeek、Kimi等输入对应的API密钥配置聊天通道推荐Telegram配置最简单启动OpenClaw服务openclawstart安装为系统服务可选让OpenClaw在系统启动时自动运行openclaw gateway install访问Web管理界面打开浏览器访问http://localhost:18789在这里你可以查看日志、管理技能、配置更多通道。常见问题排查问题现象可能原因解决方案openclaw: command not found环境变量未生效关闭所有PowerShell窗口后重新打开或重启电脑ExecutionPolicy报错脚本执行权限不足重新执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUsernode-gyp编译失败缺少C编译工具下载安装Microsoft Visual Studio Build Tools勾选使用C的桌面开发工作负载防火墙拦截Windows Defender阻止网络访问在Windows防火墙中允许OpenClaw相关进程通过WSL2下服务无法访问跨网络问题确保WSL2和Windows在同一网络使用localhost:18789访问