本文以PowerShell 一键部署为核心方案兼顾新手友好与稳定性全程附操作说明与避坑要点30 分钟内可完成部署。 一、部署前准备必看1. 硬件与系统要求项目最低配置推荐配置说明系统Windows 10 64位1903Windows 11 64位22H2必须 64 位系统32 位无法运行内存4GB8GB8GB 运行更流畅避免卡顿磁盘10GB 可用空间20GB用于存储模型、依赖与数据网络稳定联网高速宽带部署时需下载依赖与程序运行后可离线2. 核心依赖说明OpenClaw 基于 Node.js 开发官方推荐 Node 22.x LTS 版本22.16一键脚本会自动安装无需手动下载。3. 权限与安全准备关闭第三方杀毒软件/防火墙或后续放行端口避免拦截服务启动。准备管理员权限安装、配置均需否则会报错。 二、核心部署步骤一键安装步骤 1以管理员身份打开 PowerShell点击左下角「开始菜单」输入PowerShell。右键「Windows PowerShell」或「终端」选择「以管理员身份运行」。弹出「用户账户控制」提示点击「是」确认窗口标题带「管理员」字样。步骤 2解锁 PowerShell 脚本权限必做Windows 默认禁止运行远程脚本需手动解锁否则安装脚本无法执行。在管理员 PowerShell 中复制以下命令并回车Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser提示「是否要更改执行策略」时输入Y并回车确认。 效果仅为当前用户解锁权限不影响系统安全后续安装可正常执行。步骤 3执行一键安装脚本方案 A官方源通用优先选择复制以下命令粘贴到 PowerShell回车执行全程自动无需手动干预iwr -useb https://openclaw.ai/install.ps1 | iex方案 B国内加速源官方源下载慢时用若出现network timeout报错切换国内镜像下载更稳定iwr -useb https://clawd.org.cn/install.ps1 | iex脚本执行流程耐心等待 3-8 分钟自动检测系统环境缺失 Node.js 则自动安装 22.x LTS 版本。自动配置 npm 国内镜像加速依赖下载。下载并安装 OpenClaw 核心程序写入系统环境变量。安装完成后终端显示OpenClaw installed successfully即为成功。步骤 4验证安装是否成功关闭当前管理员 PowerShell重新打开一个普通 PowerShell无需管理员。输入以下命令输出版本号即代表安装成功openclaw --version✅ 示例输出2026.3.7版本号以实际安装为准⚙️ 三、初始化配置与启动步骤 1初始化 Onboarding 向导首次使用需完成初始化配置基础参数模型、端口等。在普通 PowerShell 中输入命令启动快速配置流程openclaw onboard --flow quickstart按终端提示选择新手直接默认回车即可风险提示选择yes并回车。安装模式选择quick start快速安装。模型选择推荐选择「千问模型」有免费额度适合新手。授权跳转会自动打开浏览器完成账号登录认证认证后终端自动跳转下一步。其他配置选择skip暂时跳过后续可在面板修改。步骤 2启动 OpenClaw 服务在 PowerShell 中输入启动命令openclaw start终端显示Gateway started successfully等成功日志代表服务启动完成。⚠️ 注意不要关闭 PowerShell 窗口关闭会导致服务停止。步骤 3访问可视化面板打开浏览器Chrome/Edge 优先输入地址http://localhost:3000成功进入 OpenClaw 操作面板说明部署完全成功✅ 面板功能可配置模型、接入聊天工具QQ/微信、管理任务等。️ 四、进阶配置可选1. 设置开机自启长期使用必配管理员 PowerShell 中输入命令安装 Gateway 服务并设置开机自启openclaw gateway install openclaw gateway start后续开机后服务会自动启动无需手动执行openclaw start。2. 修改访问端口避免端口冲突若 3000 端口被占用如其他程序占用可修改为其他端口如 8080# 停止当前服务 openclaw gateway stop # 修改端口为 8080可替换为其他未被占用的端口 openclaw config set gateway.port 8080 # 重新启动服务 openclaw gateway start 访问地址同步更新http://localhost:8080。❌ 五、常见问题与避坑指南问题现象原因分析解决方法「无法加载文件禁止运行脚本」PowerShell 执行策略未解锁重新执行步骤 2 的权限解锁命令安装中途报错「network timeout」网络不稳定/官方源下载慢切换国内加速源重新安装启动后访问localhost:3000空白/404服务未启动/端口被占用1. 检查 PowerShell 服务日志是否正常2. 修改端口重试版本号命令提示「不是内部或外部命令」环境变量未配置成功重启电脑重新打开 PowerShell 验证若仍失败手动重启服务安装后提示「旧版 clawdbot/moltbot 冲突」历史版本残留执行命令卸载旧版npm uninstall -g clawdbotnpm uninstall -g moltbot再重新安装 六、总结与后续核心流程解锁权限 → 执行安装脚本 → 初始化 → 启动服务 → 访问面板新手按步骤操作即可 100% 成功。稳定性保障优先使用国内加速源避免网络问题配置开机自启后长期使用无需手动维护。后续操作可在面板中接入 QQ/微信等聊天工具配置自定义模型实现本地 AI 助手的个性化使用。
Windows 本地部署 OpenClaw 超详细图文教程（保姆级）
本文以PowerShell 一键部署为核心方案兼顾新手友好与稳定性全程附操作说明与避坑要点30 分钟内可完成部署。 一、部署前准备必看1. 硬件与系统要求项目最低配置推荐配置说明系统Windows 10 64位1903Windows 11 64位22H2必须 64 位系统32 位无法运行内存4GB8GB8GB 运行更流畅避免卡顿磁盘10GB 可用空间20GB用于存储模型、依赖与数据网络稳定联网高速宽带部署时需下载依赖与程序运行后可离线2. 核心依赖说明OpenClaw 基于 Node.js 开发官方推荐 Node 22.x LTS 版本22.16一键脚本会自动安装无需手动下载。3. 权限与安全准备关闭第三方杀毒软件/防火墙或后续放行端口避免拦截服务启动。准备管理员权限安装、配置均需否则会报错。 二、核心部署步骤一键安装步骤 1以管理员身份打开 PowerShell点击左下角「开始菜单」输入PowerShell。右键「Windows PowerShell」或「终端」选择「以管理员身份运行」。弹出「用户账户控制」提示点击「是」确认窗口标题带「管理员」字样。步骤 2解锁 PowerShell 脚本权限必做Windows 默认禁止运行远程脚本需手动解锁否则安装脚本无法执行。在管理员 PowerShell 中复制以下命令并回车Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser提示「是否要更改执行策略」时输入Y并回车确认。 效果仅为当前用户解锁权限不影响系统安全后续安装可正常执行。步骤 3执行一键安装脚本方案 A官方源通用优先选择复制以下命令粘贴到 PowerShell回车执行全程自动无需手动干预iwr -useb https://openclaw.ai/install.ps1 | iex方案 B国内加速源官方源下载慢时用若出现network timeout报错切换国内镜像下载更稳定iwr -useb https://clawd.org.cn/install.ps1 | iex脚本执行流程耐心等待 3-8 分钟自动检测系统环境缺失 Node.js 则自动安装 22.x LTS 版本。自动配置 npm 国内镜像加速依赖下载。下载并安装 OpenClaw 核心程序写入系统环境变量。安装完成后终端显示OpenClaw installed successfully即为成功。步骤 4验证安装是否成功关闭当前管理员 PowerShell重新打开一个普通 PowerShell无需管理员。输入以下命令输出版本号即代表安装成功openclaw --version✅ 示例输出2026.3.7版本号以实际安装为准⚙️ 三、初始化配置与启动步骤 1初始化 Onboarding 向导首次使用需完成初始化配置基础参数模型、端口等。在普通 PowerShell 中输入命令启动快速配置流程openclaw onboard --flow quickstart按终端提示选择新手直接默认回车即可风险提示选择yes并回车。安装模式选择quick start快速安装。模型选择推荐选择「千问模型」有免费额度适合新手。授权跳转会自动打开浏览器完成账号登录认证认证后终端自动跳转下一步。其他配置选择skip暂时跳过后续可在面板修改。步骤 2启动 OpenClaw 服务在 PowerShell 中输入启动命令openclaw start终端显示Gateway started successfully等成功日志代表服务启动完成。⚠️ 注意不要关闭 PowerShell 窗口关闭会导致服务停止。步骤 3访问可视化面板打开浏览器Chrome/Edge 优先输入地址http://localhost:3000成功进入 OpenClaw 操作面板说明部署完全成功✅ 面板功能可配置模型、接入聊天工具QQ/微信、管理任务等。️ 四、进阶配置可选1. 设置开机自启长期使用必配管理员 PowerShell 中输入命令安装 Gateway 服务并设置开机自启openclaw gateway install openclaw gateway start后续开机后服务会自动启动无需手动执行openclaw start。2. 修改访问端口避免端口冲突若 3000 端口被占用如其他程序占用可修改为其他端口如 8080# 停止当前服务 openclaw gateway stop # 修改端口为 8080可替换为其他未被占用的端口 openclaw config set gateway.port 8080 # 重新启动服务 openclaw gateway start 访问地址同步更新http://localhost:8080。❌ 五、常见问题与避坑指南问题现象原因分析解决方法「无法加载文件禁止运行脚本」PowerShell 执行策略未解锁重新执行步骤 2 的权限解锁命令安装中途报错「network timeout」网络不稳定/官方源下载慢切换国内加速源重新安装启动后访问localhost:3000空白/404服务未启动/端口被占用1. 检查 PowerShell 服务日志是否正常2. 修改端口重试版本号命令提示「不是内部或外部命令」环境变量未配置成功重启电脑重新打开 PowerShell 验证若仍失败手动重启服务安装后提示「旧版 clawdbot/moltbot 冲突」历史版本残留执行命令卸载旧版npm uninstall -g clawdbotnpm uninstall -g moltbot再重新安装 六、总结与后续核心流程解锁权限 → 执行安装脚本 → 初始化 → 启动服务 → 访问面板新手按步骤操作即可 100% 成功。稳定性保障优先使用国内加速源避免网络问题配置开机自启后长期使用无需手动维护。后续操作可在面板中接入 QQ/微信等聊天工具配置自定义模型实现本地 AI 助手的个性化使用。
