OpenClaw从入门到精通:小白一键本地部署教程

作者:技术拾光时间:2026-06-11 06:27:02浏览:370

部署OpenClaw不宜用主电脑,推荐通过Windows的WSL安装Ubuntu24.04,再运行官方一键脚本。安装成功后需配置模型,填入API密钥并保存,即可完成环境部署。

再次强调,千万不要使用主电脑进行部署,权限过高,风险较大。

OpenClaw从入门到精通:小白一键本地部署教程

可以选择 Mac Mini 或者闲置主机来完成部署。

先介绍一下 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”
  }
}

配置完成后,点击右上角的 Sa ve 保存配置,再点击 Update。

至此,“第一步:环境部署”完成。接下来可以进入“第二步:配置模型”。