Win安装OpenClaw

注：该文档讲解的是windows本地部署OpenClaw，并使用第三方模型提供方的API

1、下载安装Node.js

前往NodeJs官网下载并安装，官方网址：https://nodejs.org/zh-cn

随后一路点击下一部安装即可

注意：NodeJs的版本一定要>=22，如果本地已安装，需要查看一下版本，若小于22版本，需要到官网下载安装最新版，安装程序会自动覆盖旧版本，无需卸载原有版本
查看node的版本：同时按下windows键+r,输入cmd，点击确定打开cmd，执行node --version

2、安装OpenClaw

在安装之前，退出360等杀毒软件，否则下载的部分文件可能被拦截
同时按下windows键+r，输入powershell，同时按住Ctrl+Shift+Enter，打开powershell
同时按住Ctrl+Shift+Enter是用管理员身份打开powershell，注意，一定要以管理员身份打开！否则后面会出问题！！

执行安装命令：iwr -useb https://openclaw.ai/install.ps1 | iex
等待安装完成

3、基础配置

安装完成后，会弹出cmd，里面有网关的一些信息，先最小化，不管他

powershell显示这些风险提示，说明已经安装好了，官方说最好在WSL2上部署，我实际测试直接部署并没有发现问题。输入 y 继续

选择快速启动：QuickStart，回车

Config handling 配置处理，选择 Reset ，回车

Reset scope 痕迹清理程度，选择：Full reset(config + creds + sessions + workspace)

Model/auth provider 选择 Skip for now，回车
先跳过，最后直接在配置文件中设置

Filter models by provider(选择模型提供方)，选择第一个 All providers ，回车

出现这个，再按一下回车

Select channel(QuickStart) 选择通讯渠道，选择 Skip for now ，回车

Configure skills now?(recommended) 配置技能，输入 n ，回车

Enable hooks? 配置自动化钩子，移到 Skip for now，先按空格，再按回车

Gateway service already installed 网关服务后台处理，选择 Reinstall ，回车

如果弹出cmd，里面是网关的信息，恭喜，基础配置已完成

Control UI中的 Web UI 参数，是打开前端页面的端口，复制到浏览器中即可打开

How do you want to hatch your bot? 如何使用服务？选择 Open the Web UI，这一步和打开浏览器复制端口是一样的

4、配置第三方端点，密钥和默认模型

打开Openclaw.json文件
文件位置一般在 C:\Users\Administrator.openclaw

在 openclaw.json 配置文件的根节点（最外层的大括号）内，新增一段 "models" 配置块：
这个意思就是创建了一个自己的模型提供方，命名为custom-1
id和name可添加多个，但id一定要和模型中的模型名保持一致
注意：apiKey要填成你自己创建的密钥

"models": {
    "providers": {
      "custom-1": {
        "baseUrl": "https://www.moxin.studio/",
        "apiKey": "sk-ec1sAvDoLEPHitEwwWU9iKOvNC60pVF65HQwSq2eRJWJkX1",
        "auth": "api-key",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "gemini-2.5-pro",
            "name": "Gemini 2.5 Pro"
          }
        ]
      }
    }
  },

在agents---defaults中添加两个配置块，将刚创建的模型提供方配置为默认：
如果要更换模型，需要把模型先添加到根节点的models中，再在下方替换

"model": {
        "primary": "custom-1/gemini-2.5-pro"
      },
      "models": {
        "custom-1/gemini-2.5-pro": {}
      },

配置的时候可以在cmd中查看日志，分辨是否配置成功：黄字错，蓝字对

完整的openclaw.json参考：

{
  "wizard": {
    "lastRunAt": "2026-02-24T08:34:59.805Z",
    "lastRunVersion": "2026.2.23",
    "lastRunCommand": "onboard",
    "lastRunMode": "local"
  },
  "models": {
    "providers": {
      "custom-1": {
        "baseUrl": "https://www.moxin.studio/",
        "apiKey": "sk-ec1sAvDoLEPHitEwwWU9iKOvNC60pVF65HQwSq2eRJWJkX1T",
        "auth": "api-key",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "gemini-2.5-pro",
            "name": "Gemini 2.5 Pro"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "custom-1/gemini-2.5-pro"
      },
      "models": {
        "custom-1/gemini-2.5-pro": {}
      },
      "workspace": "C:\\Users\\Administrator\\.openclaw\\workspace"
    }
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto",
    "restart": true,
    "ownerDisplay": "raw"
  },
  "session": {
    "dmScope": "per-channel-peer"
  },
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": "ba151c032ba18b98a2490940e339055141567c5c9a611d90"
    },
    "tailscale": {
      "mode": "off",
      "resetOnExit": false
    },
    "nodes": {
      "denyCommands": [
        "camera.snap",
        "camera.clip",
        "screen.record",
        "calendar.add",
        "contacts.add",
        "reminders.add"
      ]
    }
  },
  "meta": {
    "lastTouchedVersion": "2026.2.23",
    "lastTouchedAt": "2026-02-24T08:34:59.811Z"
  }
}