再次郑重提醒:切记!切记!切勿使用主力电脑进行部署,因为管理员权限过高,存在较大安全风险。

推荐使用 Mac Mini 或闲置主机来完成 OpenClaw 的部署工作,这样更为安全稳妥。
下面先介绍 Windows 电脑下的部署情况。
在 Windows 系统上安装 OpenClaw,通常有两种方式:一种是在 Windows 原生环境中直接安装,另一种是通过 Windows 自带的 Linux 子系统(WSL)进行安装。
直接给出结论:请务必避开第一种方法。直接在 Windows 上安装 OpenClaw 会遇到无数故障,让人束手无策。选择 WSL 方式才是正确路径,同时也是官方推荐的安装方案。
接下来,我们进入详细的部署步骤。
第一步
按下键盘上的“Win”键,在搜索框中输入“PowerShell”,右键点击结果并选择“以管理员身份运行”。
如果 PowerShell 无法打开,也可以使用 CMD(命令提示符),同样需要以管理员身份运行。
然后输入以下命令:
wsl --install
该命令用于安装 WSL。安装完毕后,系统会提示重启电脑,请按要求重启。
第二步
重启完成后,再次打开 PowerShell 或 CMD,输入如下命令:
wsl --install ubuntu-24.04
此命令将安装 Ubuntu 24.04 Linux 发行版。下载完成后,需要设置一个用户名和密码(可根据个人习惯自行设定)。
设置完毕后,屏幕上将显示带有颜色的命令行界面,表明已成功进入 Linux 系统。后续所有操作都必须在此环境中执行。若不小心退出,只需重新打开 PowerShell 或 CMD,输入 wsl 并回车即可重新进入。
第三步
在 Linux 系统界面中,输入以下命令以下载 OpenClaw:
curl -fsSL https://openclaw.ai/install.sh | bash
该命令是官方提供的一键安装脚本,其优势在于会自动处理所有环境依赖。例如,若检测到系统未安装 Node.js,脚本会自动完成安装。
这里有两处需要特别留意:
1. 输入命令后,需输入之前设置的用户密码。
2. 如果电脑长时间没有响应且无任何输出,请不必惊慌。观察屏幕是否出现“Installing”字样,这表示正在安装中,此期间无输出是完全正常的情况,请耐心等待片刻。
当欢迎界面弹出时,即表示安装成功。
随后 OpenClaw 控制台会自动弹出。若未自动弹出,可复制提示中的网址,在浏览器中手动打开。
依次点击 Setting(设置)→ Config(配置)→ Authentication,然后点击菜单下方的 Raw 选项。
复制以下配置信息,替换掉原文中的 “agents”: {…}, 部分,并将 baseUrl 和 apiKey 修改为你自己的参数。
{
“models”: {
“mode”: “merge”,
“providers”: {
“bailian”: {
“baseUrl”: “https://coding.dashscope.aliyuncs.com/v1”,
“apiKey”: “YOUR_API_KEY”,
“api”: “openai-completions”,
“models”: [
{
“id”: “MiniMax-M2.5”,
“name”: “MiniMax-M2.5”,
“reasoning”: false,
“input”: [“text”],
“cost”: {
“input”: 0,
“output”: 0,
“cacheRead”: 0,
“cacheWrite”: 0
},
“contextWindow”: 196608,
“maxTokens”: 32768
}
]
}
}
},
“agents”: {
“defaults”: {
“model”: {
“primary”: “bailian/MiniMax-M2.5”
}
}
},
“gateway”: {
“mode”: “local”
}
}
配置完成后,点击右上角的 Save 保存配置,再点击 Update。
至此,“第一步:环境部署”顺利结束。接下来即可进入“第二步:配置模型”阶段。
