OpenClaw 在 Windows 部署[AI人工智能(四十五)]—东方仙盟

OpenClaw 是一款开源的本地 AI 智能体平台，支持对接各类大模型、配置自定义技能，可实现文件管理、联网搜索、自动化办公等多种功能，数据本地存储、隐私性强，适配 Windows 10/11 64位系统。本次教程提供两种部署方案：原生 PowerShell 一键部署（新手首选，10分钟搞定）和 WSL2+Docker 隔离部署（进阶推荐，稳定性高），全程步骤详细，避坑指南贯穿始终，无编程基础也可轻松操作。

部署前请确认电脑满足以下要求，避免因配置不足或环境不符导致安装失败，这是顺利部署的核心前提：

• 系统版本：Windows 10 2004版本及以上、Windows 11（仅支持64位，Windows 11 22H2及以上版本报错率更低）；
• 路径要求：所有安装目录、命令行路径严禁出现中文、空格及特殊字符（如“D:软件OpenClaw”是错误路径，建议“D:SoftwaresOpenClaw”），否则会导致服务启动失败、依赖安装报错；
• 权限要求：部分操作需管理员权限，提前准备好电脑管理员账号（无需密码，但需确认有权限执行系统命令）。

• 关闭第三方杀毒软件、Windows Defender实时防护（或后续放行OpenClaw相关端口、文件），避免拦截安装脚本和服务启动；
• 确认网络通畅，国内用户可提前切换npm镜像（后续步骤会提及），避免下载依赖失败；
• 若电脑有旧版 OpenClaw、clawdbot、moltbot，需提前卸载（后续步骤有卸载命令），避免版本冲突。

该方案步骤极简、无需额外配置复杂环境，启动快、占用资源少，适合零基础新手、临时试用或个人日常使用，唯一不足是环境无隔离，可能与本地Node.js版本冲突（脚本会自动处理，无需担心）。

Windows 默认禁止运行远程脚本，若不解锁权限，后续安装命令会直接报错，操作如下：

1. 按下 Win+S 组合键，搜索“PowerShell”，右键选择「以管理员身份运行」（必须管理员权限，普通终端会失败）；
2. 在弹出的终端窗口中，输入以下命令，按回车键执行：
3. 执行后会提示“是否要更改执行策略”，输入“Y”（不区分大小写），按回车键确认，脚本权限解锁完成；
4. 验证权限：输入命令 ，输出“RemoteSigned”即为解锁成功。

权限解锁后，无需手动安装依赖（脚本会自动检测并安装），全程自动完成部署：

1. 关闭当前管理员 PowerShell 窗口，重新打开普通权限 PowerShell（避免管理员权限导致后续配置异常）；
2. 输入官方一键安装命令，按回车键执行（命令可直接复制，避免手动输入出错）： （备用命令：）；
3. 安装过程说明：
   1. 脚本会自动检测系统环境，若未安装 Node.js（要求≥v22，推荐v22 LTS版本），会自动下载适配Windows的版本并安装；
   2. 自动配置系统环境变量、安装全局依赖、完成主程序部署，无需手动干预；
   3. 耗时3-10分钟（取决于网络速度），安装过程中不要关闭终端，若长时间无响应，可按回车键刷新；
   4. 若出现“network timeout”（网络超时），先切换npm镜像（输入命令：），再重新执行安装命令。
4. 安装成功验证：终端显示“OpenClaw installed successfully”，输入命令 ，能输出版本号即为安装成功；若提示“openclaw: command not found”，关闭终端重新打开再试（环境变量未生效）。

安装完成后，需通过向导完成基础配置，新手全程选择默认选项+快速启动即可，无需复杂操作：

1. 在普通权限 PowerShell 窗口中，输入以下命令，启动初始化向导： （新手推荐添加参数：，直接跳过复杂配置）；
2. 向导配置步骤（新手推荐选项，按提示操作即可）：
   1. 运行模式：选择“QuickStart（快速启动）”，跳过高级配置；
   2. 模型提供商：无API Key（如OpenAI、阿里云百炼等）选择“Skip for now（暂不配置）”，后续可在配置文件中补充；有API Key可直接选择对应厂商，输入Key即可；
   3. 默认模型：直接按回车键，保持默认配置；
   4. 渠道对接：选择“Skip for now”，暂不配置Telegram、飞书、钉钉等第三方渠道；
   5. 技能配置：选择“Yes”，启用基础技能（文件操作、联网搜索等）；
   6. 其余高级配置（API密钥、钩子等）：全部选择“Skip for now”，向导会自动完成初始化。
3. 初始化完成后，终端会提示“Onboarding completed successfully”，进入下一步启动服务。

初始化完成后，启动网关服务，通过浏览器访问 OpenClaw 网页端，完成最终验证：

1. 在同一 PowerShell 窗口中，输入命令启动网关服务： （备用命令：）；
2. 等待终端提示“Gateway started successfully”，说明服务启动完成（若提示“Port 18789 already in use”，表示端口被占用，后续常见问题有解决方法）；
3. 打开任意浏览器（推荐Chrome、Edge），输入访问地址：（默认端口18789）；
4. 首次访问会提示“未授权：令牌缺失”，需获取授权令牌：
   1. 打开路径：（替换“你的Windows用户名”为实际用户名，如“Administrator”）；
   2. 找到“clawdbot.json”文件，右键选择「用记事本打开」；
   3. 查找“token”字段，复制引号内的长字符串（这是授权令牌，切勿泄露给他人）；
   4. 回到浏览器网页端，粘贴令牌，点击“授权”，页面正常加载即为部署成功。

该方案通过 WSL2（Windows Linux 子系统）+ Docker 实现环境完全隔离，彻底避免与本地 Windows 环境、Node.js 版本冲突，稳定性高、便于迁移，适合进阶用户、长期使用或多环境兼容场景，需先配置 WSL2 和 Docker Desktop。

1. 以管理员身份打开 PowerShell，执行以下命令，启用 WSL2 和虚拟机平台（命令依次执行，切勿跳过）：
2. 命令执行完成后，重启电脑（必须重启，否则配置不生效）；
3. 重启后，再次以管理员身份打开 PowerShell，安装 Ubuntu 22.04 LTS 子系统（推荐版本，兼容性最好）：
4. 安装完成后，会自动打开 Ubuntu 终端，按提示设置用户名和密码（密码输入时不显示，正常输入即可，记住密码后续会用到）；
5. 验证 WSL2 安装成功：在 Ubuntu 终端中输入命令 ，显示 Ubuntu 22.04 且版本为2，即为安装成功。

1. 访问 Docker 官网（https://www.docker.com/products/docker-desktop/），下载 Windows 版本的 Docker Desktop 安装包；
2. 双击安装包，全程默认安装，勾选“添加桌面快捷方式”，安装完成后重启电脑；
3. 打开 Docker Desktop，同意用户协议，即梦Ai 教程;可登录 Docker 账号（无账号可注册，也可跳过登录）；
4. 配置 WSL2 集成：点击 Docker Desktop 右上角「Settings」→「Resources」→「WSL Integration」，开启“Ubuntu 22.04”的集成开关，点击「Apply & Restart」，等待 Docker 重启生效。

1. 打开 Ubuntu 子系统终端（可通过开始菜单搜索“Ubuntu 22.04”打开），创建 OpenClaw 项目目录（英文路径，避免中文报错）：
2. 创建 docker-compose.yml 配置文件，输入以下内容（可直接复制，确保格式正确）：
3. 输入以下命令，启动 Docker 容器，自动部署 OpenClaw：
4. 部署验证：输入命令 ，若显示“openclaw-container”状态为“Up”，即为部署成功；
5. 初始化配置与网页访问：与方案一步骤3、4一致（初始化可在 Ubuntu 终端输入 ，授权令牌路径为 ）。

原因：Node.js 版本不兼容（低于v22）、环境变量未生效、旧版本残留冲突。 解决方法： 卸载旧版本（若有）：；手动安装 Node.js v22 LTS 版本（前往官网：https://nodejs.org/zh-cn/download/，下载Windows安装包，默认安装并配置环境变量）；关闭所有终端，重新打开，重新执行安装命令；若仍失败，查看 npm 全局路径（），将该路径添加到系统环境变量“Path”中，重启电脑再试。

原因：默认端口18789被其他程序占用。 解决方法（二选一）： 关闭占用端口的程序：在 PowerShell 中输入 ，找到“PID”对应的进程，打开任务管理器，结束该进程，再重启 OpenClaw 服务；修改 OpenClaw 端口：输入命令 （8888可替换为未被占用的端口），访问地址改为 。

原因：未获取正确的授权令牌，或令牌复制错误。 解决方法： 确认令牌路径正确（方案一：C:Users用户名.clawdbotclawdbot.json；方案二：~/openclaw/.openclaw/openclaw.json）；重新打开配置文件，复制“token”字段引号内的完整字符串（不要复制引号，避免多余空格）；若配置文件中无“token”字段，执行命令 重置配置，重新执行初始化向导，生成新令牌。

原因：国内网络限制，无法正常访问国外服务器。 解决方法： 切换 npm 镜像（永久生效）：；配置网络代理：在 PowerShell 中输入 （替换为自己的代理信息），再重新执行安装命令；使用国内镜像源重新安装：。

原因：WSL2 与 Windows 网络隔离，或防火墙未放行端口。 解决方法： 确保网关绑定0.0.0.0，在 Ubuntu 终端输入 ，重启容器；在 Windows 防火墙中放行18789端口（控制面板→系统和安全→Windows Defender 防火墙→高级设置→入站规则→新建规则，选择“端口”，输入18789，允许连接）；访问地址改为 ，而非 WSL2 的 IP 地址。

• 版本更新：输入命令 ，可一键更新到最新版本；
• 服务管理：启动 、停止 、重启 ；
• 日志查看：遇到未知错误，输入 ，查看实时日志，定位问题原因；
• 安全建议：OpenClaw 具备较高权限，不建议在主力工作环境裸奔运行，可在虚拟机或独立 Windows 账号中测试使用；数据目录建议定期备份；
• 模型优化：若本地运行大模型，建议安装 Ollama，在 OpenClaw 中选择“Ollama Provider”，稳定性更佳。

新手优先选择「方案一：原生 PowerShell 一键部署」，步骤简单、耗时短，10分钟即可完成部署；进阶用户、长期使用建议选择「方案二：WSL2+Docker 隔离部署」，环境隔离、稳定性高，避免版本冲突。部署过程中若遇到问题，优先查看日志和常见问题排查，大部分报错均可快速解决。完成部署后，可根据需求配置 API 密钥、自定义技能，解锁 OpenClaw 的全部功能。

在全球化与数字化浪潮中，东方仙盟始终秉持开放协作、知识共享的理念，积极拥抱开源技术与开放标准。我们相信，唯有打破技术壁垒、汇聚全球智慧，才能真正推动行业的可持续发展。

开源赋能中小商户：通过将前端异常检测、跨系统数据互联等核心能力开源化，东方仙盟为全球中小商户提供了低成本、高可靠的技术解决方案，让更多商家能够平等享受数字转型的红利。
共建行业标准：我们积极参与国际技术社区，与全球开发者、合作伙伴共同制定开放协议 与技术规范，推动跨境零售、文旅、餐饮等多业态的系统互联互通，构建更加公平、高效的数字生态。
知识普惠，共促发展：通过开源社区、技术文档与培训体系，东方仙盟致力于将前沿技术转化为可落地的行业实践，赋能全球合作伙伴，共同培育创新人才，推动数字经济 的普惠式增长

Hey folks, in this  wild tech – driven world, why not dive headfirst into the whole tech – sharing scene? Don’t just be the one reaping all the benefits; step up and be a contributor too. Whether you’re tossing out your code snippets   , hammering out some tech blogs, or getting your hands dirty with maintaining and sprucing up open – source projects, every little thing you do might just end up being a massive force that pushes tech forward. And guess what? The Eastern FairyAlliance is this awesome    place where we all come together. We’re gonna team up and explore the whole silicon – based life thing, and in the process, we’ll be fueling the growth of technology