OpenClaw部署配置windows

Windows系统部署OpenClaw完整教程：从零配置到启动运行

想在Windows电脑上安装强大的AI编程助手OpenClaw吗？本指南将为你提供详细的OpenClaw安装步骤和配置方法，手把手教你完成本地环境搭建。无论你是开发者还是技术爱好者，都能按照这份Windows版OpenClaw部署指南快速上手，避开常见安装问题，高效启动你的AI编程助手。

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

第一步：安装Node.js运行环境

Node.js是OpenClaw运行的基础环境。访问Node.js官方网站下载页面（https://nodejs.org/en/download），选择Windows安装包进行下载。运行安装程序并按提示完成安装后，打开命令提示符或PowerShell，输入 node -v 和 npm -v 检查版本，确认安装成功。

第二步：准备Git版本管理工具

虽然OpenClaw安装不强制要求Git，但作为开发工具，建议提前安装Git以便进行版本控制和依赖管理。确保系统已安装Git客户端，这对后续的OpenClaw配置和使用都有帮助。

第三步：安装OpenClaw核心程序

这是关键步骤。请务必使用管理员身份运行Windows PowerShell，以确保有足够权限进行全局安装。在打开的PowerShell窗口中，输入以下安装命令：

npm install -g openclaw@latest

此命令将从npm仓库下载最新版OpenClaw并进行全局安装。请耐心等待安装过程完成，网络状况会影响下载速度。

第四步：运行OpenClaw初始化配置

安装完成后，需要进行初始化设置。继续在管理员权限的PowerShell中执行：

openclaw onboard

这个命令会启动交互式配置向导，引导你完成基础设置。

4-1：确认部署风险提示

系统首先显示部署风险提示，直接选择 YES 并按回车键确认即可继续。

4-2：选择配置模式

接下来选择配置模式。为快速开始，建议选择 QuickStart 快速启动模式，然后按回车。

4-3：选择AI模型供应商

向导会列出可用的模型供应商，如“火山引擎”等。使用键盘方向键选择你计划使用的供应商（本示例选择“火山引擎”），按回车确认选择。

4-4：简化初始配置

对于后续的对话工具（对话工具 (skip for now)）和技能（Skills (no)）配置选项，初次使用时建议选择跳过或“否”，以简化OpenClaw配置流程，后续可根据需要再添加。

第五步：启动网关服务并访问控制台

完成初始化后，必须启动OpenClaw网关服务才能正常使用Web控制台。打开一个新的PowerShell窗口（无需管理员权限），执行以下操作：

5-1：启动本地网关服务

openclaw gateway run

执行后，该窗口将显示网关运行日志，请保持此窗口开启，这是OpenClaw正常运行的关键。

5-2：获取控制台访问地址

再打开一个新的PowerShell终端，运行：

openclaw dashboard

运行后通常会自动在浏览器中打开带认证令牌的OpenClaw仪表盘。如未自动打开，命令行会显示访问URL，手动复制到浏览器即可打开OpenClaw控制台界面。

第六步：配置模型参数与工作空间

要让OpenClaw连接你的AI模型，需要编辑配置文件。该文件通常位于用户目录下的 .openclaw 文件夹中（如 C:\Users\[你的用户名]\.openclaw\），文件名为 openclaw.json。

使用文本编辑器打开此文件，根据你的模型服务信息进行配置。以下是配置示例，包含模型端点、API密钥（示例中已用占位符替代）和工作空间路径等关键参数：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "qwen35122b/qwen3.5:122b "
      },
      "models": {
        "ollama/qwen3-coder:30b": {}
      },
      "workspace": "C:\\Users\\dell\\.openclaw\\workspace"
    }
  },
  "gateway": {
    "mode": "local",
    "auth": {
      "mode": "token",
      "token": "ddda7c106535bd009537b753b2507e9b2375b75619035846"
    },
    "port": 18789,
    "bind": "loopback",
    "tailscale": {
      "mode": "off",
      "resetOnExit": false
    },
    "controlUi": {
      "allowInsecureAuth": true
    },
    "nodes": {
      "denyCommands": ["camera.snap", "camera.clip", "screen.record", "contacts.add", "calendar.add", "reminders.add", "sms.send", "sms.search"]
    }
  },
  "session": {
    "dmScope": "per-channel-peer"
  },
  "tools": {
    "profile": "coding"
  },
  "models": {
    "mode": "merge",
    "providers": {
      "gpt-oss120b": {
        "api": "openai-completions",
        "apiKey": "111",
        "baseUrl": "http://192.168.11.24:11434/v1",
        "models": [{
          "id": "gpt-oss:120b",
          "input": ["text"],
          "name": "gpt-oss:120b"
        }]
      },
      "qwen35122b": {
        "api": "openai-completions",
        "apiKey": "11",
        "baseUrl": "http://192.168.11.240:11434/v1",
        "models": [{
          "id": "qwen3.5:122b",
          "input": ["text"],
          "name": "qwen3.5:122b"
        }]
      }
    }
  },
  "auth": {
    "profiles": {
      "ollama:default": {
        "provider": "ollama",
        "mode": "api_key"
      }
    }
  },
  "hooks": {
    "internal": {
      "enabled": true,
      "entries": {
        "session-memory": {
          "enabled": true
        }
      }
    }
  },
  "wizard": {
    "lastRunAt": "2026-04-02T06:21:53.021Z",
    "lastRunVersion": "2026.4.1",
    "lastRunCommand": "onboard",
    "lastRunMode": "local"
  },
  "meta": {
    "lastTouchedVersion": "2026.4.1",
    "lastTouchedAt": "2026-04-02T06:21:53.033Z"
  }
}

重要提示：请将示例中的 apiKey、baseUrl、workspace 路径及模型ID等参数，替换为你自己的实际配置信息，确保OpenClaw能正确连接到你的模型服务。

6-1：使用图形界面配置模型

除了手动编辑配置文件，OpenClaw还提供了更便捷的图形化配置方式。在Web控制台中，你可以通过cc-switch工具轻松切换和配置模型，操作界面如下：

至此，OpenClaw在Windows上的安装配置全部完成。现在你可以返回浏览器中的OpenClaw控制台，开始体验AI辅助编程的强大功能。如遇问题，首先检查网关服务是否正常运行，其次确认配置文件中的模型地址和密钥是否正确配置。