Windows 原生跑 OpenClaw 详解：从零装到会用的全流程指南 在一台普通的 Windows 电脑上装好 OpenClaw，等于是给电脑装上了一个小小的“机器人管家”。它可以帮你查文件、发邮件、甚至在聊天软件里回复，同事们会惊讶于这只看不见的手能干多少活。下面，我像跟朋友聊日常一样，把原生 Windows 安装 OpenClaw 的全过程拆开来，顺带聊聊常见坑、实用技巧以及使用感受，让你不再被一堆命令行吓退。一、为什么要在原生 Windows 上跑 OpenClaw？1. **省去 WSL 的额外步骤**——如果你只是想在本机快速体验 AI 助手，直接在 Windows 上装比在 WSL 里多套系统要省事。2. **更贴合 Windows 软件生态**——很多工具（比如 Office、PowerShell 脚本）只能在 Windows 环境下直接调用，原生跑能省去跨系统的路径转换麻烦。3. **开机自启动更自然**——通过计划任务或启动文件把 OpenClaw 的网关服务拉进系统启动流程，真的像装了一个随时待命的后台服务。> 小贴士：如果你以后可能会迁移到服务器或者容器，还是建议保留一份 WSL 安装方案作备份。两种路径并存，随时可以切换。二、装前准备：把电脑“打扫干净”- **系统要求**：Windows 10（2004 以上）或 Windows 11，建议 64 位。内存最低 8 GB，跑大模型最好 16 GB 以上。- **管理员权限**：整个过程需要管理员执行 PowerShell，记得右键“以管理员身份运行”。- **网络环境**：如果在公司内网，请确认可以访问 GitHub、npm 官方源，必要时配置代理或使用国内镜像。三、一步步敲代码：从 Node 到 OpenClaw1. 安装 Node.js（版本≥22）1) 打开浏览器，下载 Windows 安装包（.msi）——官方 LTS 版默认就是 22.x。2) 双击安装，一路 Next，记得勾选 “Add to PATH”。3) 安装完后打开普通 PowerShell，敲 `node --version`、`npm --version`，看到类似 `v22.8.0`、`10.2.0` 就说明成功。2. 放宽 PowerShell 执行策略因为 OpenClaw 的一键脚本是通过 `iwr` 下载后直接执行的，默认策略会拦截。用管理员 PowerShell 执行：```powershell Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force ```这一步只改当前用户，不会影响系统安全。以后想恢复可以把策略改回 `Restricted`。3. 一键安装 OpenClaw在同一个管理员 PowerShell 窗口里粘贴并回车：```powershell iwr -useb https://raw.githubusercontent.com/openclaw/openclaw/main/install.ps1 | iex ```> 这行命令会自动把 Node、OpenClaw 本体、以及默认的配置向导全装好。整个过程大约需要 3–5 分钟，期间别关闭窗口。如果弹出安全提示，一律点 “是”。4. 让网关服务随系统启动OpenClaw 的核心是 **Gateway**，负责把浏览器、IM、HTTP 请求转发给内部的 AI Agent。我们希望它能在电脑开机后自行启动。- **首选：计划任务**（如果系统允许）```powershell openclaw gateway install ```脚本会尝试创建一个计划任务 `OpenClaw Gateway`，配置为系统启动时运行。如果任务创建被拒（比如公司电脑禁用了计划任务），脚本会自动回退到用户 Startup 文件夹。- **回退方案：Startup 文件夹**```powershell # 查看回退路径 openclaw gateway status --json ```如果看到 `fallback` 字段指向 `C:\Users\\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup`，说明已经把快捷方式放进去。下次登录后 Gateway 会自行启动。5. 验证安装是否成功打开任意 PowerShell（不必管理员），依次执行：```powershell openclaw doctor # 自动检测常见配置问题 openclaw gateway status # 看是否显示 Running openclaw dashboard # 会自动打开浏览器，访问 http://127.0.0.1:18789 ```如果浏览器里出现 OpenClaw 的控制面板，恭喜你已经跑通了！四、常见坑与实战应对1. 命令找不到：‘openclaw’ 不是内部或外部命令原因通常是 npm 全局目录没有加入系统 PATH。解决办法：- 在 PowerShell 中运行 `npm prefix -g`，记下输出路径（比如 `C:\Users\you\AppData\Roaming\npm`）。 - 把这条路径加进环境变量（系统属性 → 高级 → 环境变量 → Path → 新建），保存后重启 PowerShell。2. 端口被占用默认 Gateway 使用 18789 端口。如果出现 `port already in use`，可以改端口再启动：```powershell openclaw gateway --port 18888 ```随后在浏览器访问 `http://127.0.0.1:18888` 即可。3. 防火墙拦截Windows Defender 默认会询问是否允许打开网络端口，点 “允许”。如果在企业环境里被统一防火墙阻断，找 IT 同事放行 `TCP 18789`（或你自定义的端口）。4. 安装时网络卡住大多数情况下是 GitHub 被墙导致下载慢。可以先把 npm 源切到国内镜像，再执行：```powershell npm config set registry https://registry.npmmirror.com ```或者直接把一键脚本的 URL 换成国内镜像（有社区维护的镜像站点），把 `https://raw.githubusercontent.com/...` 改成 `https://gitee.com/...` 再执行。5. “Gateway auth is set to token, but no token is configured”OpenClaw 默认开启 token 鉴权，必须在 `~\.openclaw\.env`（Windows 下是 `%USERPROFILE%\.openclaw\.env`）里写入 `OPENCLAW_GATEWAY_TOKEN=xxxx`。如果不想手动写，可以在配置向导里直接输入一个随机字符串，系统会自动保存。五、让 OpenClaw 真正“干活”——接入大模型OpenClaw 本身不提供推理能力，需要外部的大语言模型作为“大脑”。下面给几种常见的接入方式做个概览。1. OpenAI（ChatGPT）- 通过 https://platform.openai.com/account/api-keys 生成 `sk-...` 的密钥。- 在 PowerShell 中运行 `openclaw onboard`，向导里选择 “OpenAI”，粘贴密钥，接着挑选模型（如 `gpt-4o-mini`），一路回车即可。2. 国内模型（Kimi、MiniMax、DeepSeek）这些服务在国内网络里几乎不需要翻墙，体验更流畅。获取方式类似：登录对应平台→创建 API Key→复制。3. 本地 Ollama（离线模型）如果你不想把数据上传公网，先在 Windows 安装 Ollama（官方提供 exe），拉取本地模型（比如 `qwen2.5:7b`），然后在 OpenClaw 向导里选 “Custom Provider”，填写 `http://127.0.0.1:11434/v1` 作为 Base URL，任意字符串填进 API Key，即可本地跑。注意本地模型的上下文窗口要 ≥ 16k，必要时自行编写 `Modelfile` 扩展 `num_ctx`。六、把 OpenClaw 融入日常工具1. 桌面快捷入口安装完后可以创建一个桌面快捷方式，目标指向 `powershell.exe -NoProfile -Command "openclaw dashboard"`。这样双击图标就能直接打开浏览器面板，像打开常用软件一样自然。2. 与飞书 / 微信聊天- **飞书**：在飞书开放平台创建企业自建应用，获取 App ID、App Secret。回到 OpenClaw 控制台，进入 Channels → Feishu，填入这些信息并保存，随后在飞书中添加机器人即可。- **微信**：使用开源的 `wechaty` 插件，步骤类似：在 OpenClaw 插件库里执行 `openclaw plugins install @openclaw/wechaty`，按照提示完成公众号或企业微信的扫码认证。3. 自动化脚本有了 OpenClaw 的 API（默认 `http://127.0.0.1:18789/api`），可以在 PowerShell、批处理甚至 Excel VBA 里调用它，实现如“每天自动生成日报”“一键把文件压成 zip 并发到钉钉”的小功能。这样一来，电脑真的成了你的“全能秘书”。七、维护与升级- **检查新版本**：`openclaw update --channel stable`（或 `dev`）可以直接拉取最新版。- **日志查看**：`openclaw logs follow` 实时打印日志，95% 的问题都能在这里找到根源。- **备份配置**：整个配置都保存在 `%USERPROFILE%\.openclaw` 目录，定期拷贝到云盘或 U 盘，以防系统崩溃需要恢复。八、使用感受：从“装了一个玩具”到“每天必备的同事”最初装完 OpenClaw，大家往往会把它当成一个聊天机器人，只用来问天气、翻译之类的闲聊。实际上，当你把它接入工作流后，它会变成一个“会动手的同事”。- **文件归档**：只要在聊天框说 “把去年四季度的销售报表归档到 D:\Archive”，OpenClaw 自动在后台跑 PowerShell 脚本搬文件、压缩、上传到网盘。- **日程提醒**：对着它说 “提醒我明天上午十点参加产品评审”，它会自动写入 Windows 日历，甚至提前 15 分钟弹出弹窗。- **代码审查**：在开发团队里，把 OpenClaw 当作代码审查小助手，只需要给它提交 PR 链接，它会跑一遍 lint、单测并把结果回报。这些场景的背后都是同一个核心：**把繁琐的点子交给机器，让脑力专注在创意上**。当你真的把 OpenClaw 当作助理使用时，才会体会到“一键自动化”带来的轻松与成就感。九、总结：一步到位的装机指南1. **准备管理员 PowerShell** → 放宽执行策略。2. **装 Node.js** → 确认版本 ≥22。3. **运行一键脚本** → 自动下载并安装 OpenClaw。4. **注册 Gateway 服务** → 计划任务或 Startup 自动启动。5. **接入模型** → OpenAI、国内模型或本地 Ollama任选。6. **配置渠道** → 飞书、微信、Telegram 任意组合。7. **开启日常使用** → 浏览器面板或聊天窗口直接交互。8. **定期更新&备份** → 确保安全和最新功能。只要按部就班，一般电脑 10–15 分钟就能完成，从零到拥有一个 24/7 在线的 AI 助手。以后再也不用手动打开 Word、复制粘贴文件，直接对着 OpenClaw 说“帮我把这份报告发到部门”，它会自行完成所有步骤。这样的小帮手，让日常工作真的变得轻松又有温度，值得每个想提升效率的朋友尝试。祝大家玩得开心，也欢迎在评论区分享你们的使用案例，看看 OpenClaw 能帮你实现哪些“疯狂想法”。 😊