一、环境准备与安装
1. 手动安装【Python、Node、Git】
1.1 安装 Python
下载并安装 Python 3.11.x 版本。安装时勾选 "Add python.exe to PATH"。
验证安装：
py --version
注意：Windows 自带的「Python 快捷方式」可能拦截命令。建议使用
py命令替代，后续所有 Python 命令均使用py执行。
1.2 克隆项目
git clone https://github.com/TencentOpen/OpenClaw.git
若网络受限，可能需要配置代理或镜像。
2. 一键脚本安装【PowerShell】
适合 Windows 用户，脚本可自动处理依赖、镜像及权限问题。
2.1 清理残留（可选）
若之前安装失败，建议先清理缓存和进程：
# 强制停止相关进程
taskkill /f /im node.exe 2>$null
taskkill /f /im openclaw-cn.exe 2>$null
# 卸载旧版本
npm uninstall -g openclaw 2>$null
npm uninstall -g clawd 2>$null
# 清理全局缓存
npm cache clean --force
npm cache verify
# 删除本地残留配置
Remove-Item -Path "$env:USERPROFILE\.openclaw" -Recurse -Force -ErrorAction SilentlyContinue
Remove-Item -Path "$env:USERPROFILE\AppData\Roaming\npm\node_modules\openclaw" -Recurse -Force -ErrorAction SilentlyContinue
Write-Host "✅ 所有旧缓存、残留、失败安装包 已全部清空！"
2.2 执行安装
运行官方提供的 PowerShell 脚本：
$ProgressPreference = 'Continue'
iwr -useb https://clawd.org.cn/install.ps1 | iex
执行后需等待下载完成，时间视网络情况而定。
二、模型配置与环境初始化
安装完成后，需完善本地配置以启动服务。
1. AI 模型配置
需要获取以下信息：API Key、API 地址、模型 ID。确保四者同时满足且可用。
2. 初始化向导
重新执行或继续运行以下命令进入配置页面：
openclaw-cn onboard
按提示完成以下步骤：
- 确认安全风险并继续。
- 完成初始化配置（运行模式、模型设置、网关配置）。
- 生成配置文件。
- 启动网关。
- 验证启动状态。
三、常见问题排查
1. 网关异常
重启后网关异常关闭，或无法在浏览器中检测。
- 检查端口占用情况。
- 查看日志输出是否有报错信息。
2. 模型未配置
浏览器与 AI 对话无响应，数据源缺失。
- 确认模型 API 配置是否正确。
