本教程基于 Windows 11 64位 原生环境，采用官方一键脚本+中文社区适配方案，全程可复现、可验证，无需复杂环境配置。
一、部署前准备（必做）
1. 系统与硬件要求
系统：Windows 11 64位专业版/家庭版（32位不支持）
内存：≥ 4GB（推荐8GB+）
磁盘：预留 ≥20GB 空间（含依赖、缓存）
网络：可正常访问外网（下载依赖、调用AI模型）
权限：全程使用 管理员权限 操作（否则安装失败）
2. 关闭干扰项（可选但推荐）
临时关闭360、腾讯电脑管家、Windows Defender实时防护（避免拦截脚本/安装）
关闭VPN/代理（防止下载依赖失败）
二、一键安装OpenClaw（核心步骤）
步骤1：以管理员身份打开PowerShell
按 Win + X 组合键，选择 终端(管理员)（Windows 11）或 Windows PowerShell(管理员)（Windows 10）
弹出「用户账户控制」时，点击 是，进入管理员命令窗口
步骤2：允许PowerShell执行脚本（必做）
复制以下命令，粘贴到PowerShell并回车：
提示「是否要更改执行策略」时，输入 Y 并回车（仅当前用户生效，安全无风险）
步骤3：执行中文社区一键安装脚本（推荐）
复制以下命令，粘贴到PowerShell并回车（全程不要关闭窗口）：
说明：此为中文社区定制脚本，自动适配国内网络、安装Node.js 22+、Git、OpenClaw并配置环境变量
步骤4：等待安装完成（5-10分钟）
脚本自动执行以下操作：
检查PowerShell版本（≥5.0）
自动安装 Node.js 22+（OpenClaw强制要求）
自动安装 Git for Windows
全局安装OpenClaw
配置系统环境变量
执行 openclaw doctor 诊断安装状态
安装成功后，PowerShell会提示：OpenClaw安装完成！
三、初始化配置（激活中文AI能力）
步骤1：启动配置向导
安装完成后，重启PowerShell（管理员），执行以下命令启动交互式配置：
提示「安全风险确认」：输入 Yes 并回车（确认AI可操作本地文件）
配置模式选择：输入 QuickStart（快速开始，新手推荐）
步骤2：配置中文AI模型（核心）
国内优先选择 阿里云百炼 或 智谱AI（适配中文、稳定），以下以阿里云百炼为例：
选择模型：输入 Alibaba Bailian 并回车
获取API Key：
打开 阿里云百炼控制台，注册/登录
进入「API密钥管理」，创建 新的API Key（复制 API Key 和 Secret Key）
粘贴密钥：
终端提示输入 Bailian API Key：粘贴复制的API Key（输入不可见），回车
提示输入 Bailian Secret Key：粘贴Secret Key，回车
备选：选择 Z.AI（智谱AI），前往 智谱AI开放平台 创建API Key并粘贴
步骤3：跳过渠道配置（新手）
提示「配置渠道（如微信/飞书）」时，输入 Skip for now 并回车（后续可单独配置）
步骤4：完成配置
向导自动保存配置，提示 配置完成！ 即成功激活AI能力。
四、启动服务与验证（确保可用）
1. 启动OpenClaw网关服务
在管理员PowerShell中执行：
成功标志：终端显示 OpenClaw server started on http://0.0.0.0:18989（默认端口18989）
2. 验证部署（3种方式，全部通过才算成功）
方式1：命令行验证（基础）
执行以下命令，显示版本号即成功：
示例输出：openclaw v2026.1.30（版本号随更新变化）
方式2：诊断验证（全面）
执行诊断命令，所有项显示 ✅ 即正常：
检查项：Node.js版本、环境变量、依赖、网关状态等
方式3：网页+对话验证（最终）
打开浏览器，访问：http://127.0.0.1:18989（本地管理界面）
成功：进入OpenClaw中文管理后台，可查看服务状态、配置模型
启动终端对话（TUI）：
成功：进入交互式对话界面，输入中文问题（如「你好」），AI正常回复即部署完成
五、常见问题与解决（避坑）
1. 提示「openclaw不是内部或外部命令」
解决：关闭当前PowerShell，重新以管理员身份打开，执行：
刷新环境变量后即可识别命令
2. 安装脚本下载失败/超时
解决：切换网络（手机热点），或手动安装Node.js 22+后，执行：
再重新配置
3. AI模型调用失败（无回复）
解决：检查API Key是否正确、无空格；确认阿里云百炼/智谱AI账号已开通服务、余额充足；重启网关：
4. 端口18989被占用
解决：修改默认端口，执行：
浏览器访问 http://127.0.0.1:18990 即可
六、常用命令（日常使用）
七、部署完成总结
环境：Windows 11 64位 + Node.js 22+
安装：中文社区一键脚本 iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex
配置：对接阿里云百炼/智谱AI中文模型
验证：openclaw –version + 访问 http://127.0.0.1:18989 + openclaw tui 对话
本教程所有步骤已在Windows 11 22H2/23H2版本验证，可直接复制命令执行，无需额外修改。
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容，请联系我们，一经查实，本站将立刻删除。
如需转载请保留出处：https://51itzy.com/kjqy/274832.html