windows10以上环境

在windows下有两种方式搭建

方式一:原生PowerShell原生部署,此方案由于只能使用powershall脚本兼容。所以适合不想使用WSL2的纯Windows用户。

安装Node.js 22+

一:官网下载安装

  1. 访问 https://nodejs.org/zh-cn

  2. 下载Windows安装包(LTS版本24.x)
    node-v24.14.0-x64.msi

  3. 运行安装程序,勾选「自动安装必要的工具」
    在安装的时候记得勾选

二:验证Node.js安装

# 打开PowerShell
node -v
npm -v

三:安装git

Git-2.53.0.2-64-bit.exe

  • 安装成功后在任何一个目录下,点击鼠标右键,执行「Git Bash Here」

注意:虽然有一键安装脚本,但是由于网络连接不稳定。还是切换国内安装源进行安装

安装脚本:
# 以管理员身份运行PowerShell,执行以下命令
iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex

四:安装 pnpm 并配置国内镜像源

OpenClaw 官方建议使用 pnpm 从源代码构建,在刚打开的 Git 界面执行:
npm install -g pnpm

为了保证下载速度,使用国内镜像源

# 设置淘宝/阿里云镜像

pnpm config set registry https://registry.npmmirror.com/

五:源码安装与启动

采用 OpenClaw 中国社区版维护的 openclaw-cn 版本安装,原生支持 DeepSeek,基于 OpenClaw v2026.2.2 版

git clone https://gitee.com/OpenClaw-CN/openclaw-cn.git

cd openclaw-cn 进入

pnpm install 安装依赖

pnpm ui:build 首次构建UI依赖

pnpm build 同样执行构建项目


到这里就完成了构建,之后更换power shall进行安装向导的启动

六:启动安装向导

以管理员身份运行power shall

pnpm openclaw onboard --install-daemon
默认powershall禁止运行脚本,所以需要进行策略修改

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
允许本地脚本运行,远程脚本必须签名(最常用且安全)只对当前用户生效,不影响系统其他用户
Get-ExecutionPolicy -List
查看是否生效

进入openclaw的目录下运行

pnpm openclaw onboard --install-daemon

此处注意:

首次安装完成,访问UI地址。默认为127.0.0.1:18789(网关),需要在概览中填写网关token。

token可以在C:\Users\Administrator\.openclaw\openclaw.json中的gateway参数中查看

之后启动网关都可以使用:node openclaw.mjs gateway --port 18789 --verbose

还需要安装pnpm add -g openclaw@latest
安装完成之后验证:openclaw --version

之后就能使用相关命令:

openclaw status 查看系统状态
openclaw gateway run 启动网关服务
openclaw logs 查看日志 
openclaw doctor --generate-gateway-token 重新生成令牌

linux环境下安装

一:对环境准备-安装node

输入以下命令进行安装:

# 安装长期支持版本 
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash \. "$HOME/.nvm/nvm.sh" 
nvm install 22
# 配置国内加速
npm install -g pnpm 
pnpm config set registry https://registry.npmmirror.com/

二:将项目仓库克隆

git clone https://gitee.com/OpenClaw-CN/openclaw-cn.git

注意:部分情况下由于访问限制无法克隆项目,但是可以将项目压缩包上传到服务器解压后安装

openclaw-cn-main.zip

在服务器上运行

unzip opencalw-cn.zip

cd opencalw-cn-main

三:还需要安装git

apt install git

然后再执行项目构建

构建UI和项目

cd openclaw-cn

pnpm install

pnpm ui:build

pnpm build

四:最后要安装openclaw不然无法使用相应命令

npm install -g openclaw@latest

进行验证

openclaw -version

五:至此前置条件全部安装完成,开始安装openclaw向导

pnpm openclaw onboard --install-daemon

六:安装完成之后,由于默认是只监听127.0.0.1:18789端口

如果需要在其他地方访问,要么配置NGINX要么就使用ssh链接转发端口

ssh -N -L 18789:127.0.0.1:18789 root@64.81.114.79

注意:在Linux中openclaw的配置文件在~/.openclaw/openclaw.json

七:对在外网使用

如果需要让其他用户都能访问页面需要在gateway这段配置添加以下内容

"gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "lan",
    "controlUi": {
      "allowedOrigins": [
        "http://64.81.114.79:18789/",
        "http://127.0.0.1:18789"
      ],
      "allowInsecureAuth": true,
      "dangerouslyDisableDeviceAuth": true,
      "dangerouslyAllowHostHeaderOriginFallback": true
    },

这样才能让外网访问

八:API接入

"models": {
    "mode": "replace",
    "providers": {
      "siliconflow": {
        "baseUrl": "https://api.siliconflow.cn/v1/",
        "apiKey": "API-key",
        "api": "openai-completions",
        "models": [
          {
            "id": "Pro/deepseek-ai/DeepSeek-R1",
            "name": "DeepSeek-R1",
            "reasoning": false,
            "input": [
              "text"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 128000,
            "maxTokens": 8192
          }
        ]
      }
    },
    "bedrockDiscovery": {
      "enabled": false,
      "providerFilter": [
        "custom-1"
      ]
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "siliconflow/Pro/deepseek-ai/DeepSeek-R1"
      },
      "models": {
        "siliconflow/Pro/deepseek-ai/DeepSeek-R1": {
          "alias": "deepseek",
          "streaming": false
        }
      },
      "workspace": "/root/.openclaw/workspace",
      "compaction": {
        "mode": "safeguard"
      },
      "thinkingDefault": "medium",
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },

将openclaw.json文件进行修改,按照参数填写完成后重启网关openclaw gateway restart

如果不行使用工具导入: https://dayulab.com/tools/efficiency/openclaw

参考:
https://blog.csdn.net/qq_41283356/article/details/158825522
https://open-claw.org.cn/practical/windows-native
https://clawd.org.cn/start/getting-started.html