夜雨聆风这是一份针对 Windows 11 系统的 OpenClaw 本地部署保姆级教程（2026年4月最新版）。OpenClaw 是一个开源的 AI 自动化代理框架，能让 AI 助手在你的电脑上直接执行文件操作、脚本运行等真实任务。
环境准备与依赖检查
部署前请确保你的电脑满足以下条件，并准备好大模型 API Key。
硬件与系统要求
系统：Windows 11 (21H2 及以上)，或使用 WSL2 (推荐)。
硬件：内存 ≥ 4GB (推荐 8GB)，磁盘空间 ≥ 20GB。
依赖：必须安装 Node.js v22 或更高版本。在 PowerShell 输入 node -v 检查，若版本过低请去官网下载安装。
获取大模型 API Key
OpenClaw 本身是“大脑”，需要接入大模型才能工作。请提前申请以下任一模型的 API Key 并保存好：
国内推荐：阿里云百炼 (Qwen)、MiniMax、硅基流动。
国际：OpenAI (需自备网络环境)。
部署步骤（Windows 11 方案）
方案 A：PowerShell 一键安装（新手首选）
这是最快捷的方式，脚本会自动处理环境依赖。
以管理员身份打开 PowerShell。
执行一键安装命令：
等待脚本自动安装 Node.js、Git 及 OpenClaw 本体。
方案 B：NPM 手动安装（已有环境）
如果你已配置好 Node.js 环境，可直接使用 npm 安装：
安装后验证：openclaw --version，应输出类似 2026.3.x 的版本号。
初始化配置与启动
运行 Onboard 向导
安装完成后，执行以下命令进行初始化：
向导配置要点：
风险提示：输入 Yes 确认授权。
模式选择：新手选 QuickStart。
模型配置：选择你的模型厂商（如 bailian 对应阿里云百炼），并粘贴准备好的 API Key。
渠道与技能：渠道先选 Skip for now（后续再加钉钉/飞书）；技能建议选 Yes 安装基础包。
启动方式：选择 Open the Web UI，向导会自动启动服务并打开浏览器。
手动管理服务
如果向导未自动启动，可使用以下命令管理：
验证与基础使用
访问控制台：浏览器打开 http://localhost:18789 (或 http://127.0.0.1:18789)。
健康检查：在终端运行 openclaw doctor，所有项显示绿色即表示部署成功。
首次对话：在 WebUI 中输入简单指令测试，如“帮我列出当前目录下的文件”，如果 AI 能正确执行并返回结果，说明部署完全正常。
安全与避坑指南
数据隐私：本地部署的数据默认存储在本地（`C:\Users\你的用户名.openclaw`），不会上传至第三方服务器，适合处理敏感文件。
端口安全：默认端口 18789 仅绑定在本地 (127.0.0.1)，外部无法访问。切勿随意修改绑定地址为 0.0.0.0 且不做鉴权，否则可能导致 API Key 泄露。
常见报错：
端口占用：修改 ~/.openclaw/openclaw.json 中的 port 字段，并重启服务。
安装失败：尝试配置 npm 国内镜像：npm config set registry https://registry.npmmirror.com。
完成以上步骤，你就拥有了一个运行在本地的 AI 自动化助手。接下来可以在 WebUI 的 Settings 中配置更多技能 (Skills) 或接入钉钉/企业微信等消息渠道。
