windows本地部署openclaw

🚀 Windows本地部署OpenClaw保姆级教程

2026全网最详细指南 - 两种部署方式 × 两种模型接入

📋 目录

1、什么是OpenClaw？

2、准备工作

3、方法一：PowerShell原生部署（推荐）

4、方法二：WSL2部署

5、接入本地大模型（Ollama）

6、接入API Key（MiniMax/OpenAI等）

7、启动与验证

8、常见问题解答

一、什么是OpenClaw？

📢 说明：本文介绍的OpenClaw是AI Agent智能体框架，不是那个经典游戏《船长克劳》的开源复刻引擎，请不要混淆。

OpenClaw 是一款本地优先的开源AI智能体框架，可以帮你：

🤖 通过自然语言指令操作电脑（文件管理、程序控制）
🌐 自动化浏览器操作
📱 接入飞书、钉钉、Telegram等通讯工具
🔒 数据完全本地存储，隐私性强

💡 OpenClaw的核心优势：不仅是一个AI助手，更是一个能"干活"的数字员工！

二、准备工作

2.1 硬件要求

配置	最低要求	推荐配置
系统	Windows 10/11 64位	Windows 11
内存	8GB	16GB+
显卡	可选	NVIDIA 8GB+显存
存储	20GB	50GB+ SSD

2.2 软件要求

Node.js ≥ 18
（推荐22+，后面会详细说）
Git
WSL2
（仅方法二需要）

⚠️ 重要提醒：Node.js版本非常关键！建议使用22.x版本，18.x可能存在兼容性问题。

三、方法一：PowerShell原生部署（推荐）

这种方式直接在Windows上运行，不需要Linux子系统，最简单最推荐。

3.1 安装Node.js

访问 nodejs.org 下载 LTS版本
安装时务必勾选 "Add to PATH"
验证安装：

node -vnpm -v

3.2 安装Git（如果没有）

下载 Git for Windows
安装时勾选 "Add Git to PATH"
验证：

git --version

3.3 设置PowerShell执行策略

以管理员身份打开PowerShell，执行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser -Force

3.4 配置npm国内镜像（加快下载速度）

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

3.5 安装OpenClaw

在PowerShell中执行以下任意一种方式：

方式A（推荐）：使用官方安装脚本

iwr -useb https://openclaw.ai/install.ps1 | iex

方式B：直接使用npm安装

npm install -g openclaw

⚠️ 如果遇到编译错误，尝试：

npm install -g openclaw --ignore-scripts --no-optional --force

3.6 验证安装

openclaw --version

✅ 看到版本号就说明安装成功了！

四、方法二：WSL2部署

WSL2是Windows自带的Linux子系统，兼容性更好，推荐给需要更多控制的用户。

⚠️ 注意：WSL2会占用较多内存，建议16GB+内存的机器使用。

4.1 启用WSL2

以管理员身份打开PowerShell
执行：

wsl --install

系统会提示重启，重启电脑
重启后设置Ubuntu的用户名和密码

4.2 进入WSL并更新系统

wsl  # 进入Ubuntusudo apt update && sudo apt upgrade -y

4.3 安装Node.js 22+

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -sudo apt install -y nodejsnode -vnpm -v

4.4 配置npm国内镜像

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

4.5 安装OpenClaw

curl -fsSL https://openclaw.ai/install.sh | bash

或者：

npm install -g openclaw

4.6 验证安装

openclaw --version

✅ WSL2方式安装完成！

4.7 访问Dashboard（重要！）

由于WSL2有独立IP地址，你需要：

获取WSL的IP地址：

hostname -I | awk '{print $1}'

在Windows浏览器中访问：http://WSL的IP地址:18789

💡 小技巧：可以设置WSL端口转发，直接用 http://127.0.0.1:18789 访问

# 在PowerShell中执行（管理员）netsh interface portproxy add v4tov4 listenport=18789 connectport=18789 connectaddress=127.0.0.1

五、接入本地大模型（Ollama）

如果你有NVIDIA显卡，推荐使用Ollama运行本地大模型，响应快且免费。

5.1 安装Ollama

访问 ollama.com 下载Windows版本
或者使用PowerShell安装（需要代理）：

# 先设置代理（如需要）$env:http_proxy="http://127.0.0.1:7890"$env:https_proxy="http://127.0.0.1:7890"# 安装Ollamairm https://ollama.com/install.ps1 | iex

5.2 拉取大模型

推荐以下模型（根据显卡显存选择）：

模型	最低显存	推荐显存
qwen2.5:7b	8GB	8GB
qwen2.5:14b	16GB	16GB
qwen3:8b	8GB	16GB
llama3.1:8b	8GB	16GB

ollama pull qwen2.5:7b

5.3 扩展上下文窗口（重要！）

OpenClaw需要较大的上下文窗口，建议创建扩展模型：

# 创建Modelfile@"FROM qwen2.5:7bPARAMETER num_ctx 32768"@ | Out-File -Encoding ascii Modelfile# 创建新模型ollama create qwen2.5:7b-32k -f Modelfile

5.4 配置OpenClaw连接Ollama

运行配置向导：

openclaw onboard

按以下参数配置：

选项	值
Model/auth provider	Custom Provider
API Base URL	http://127.0.0.1:11434/v1
API Key	任意非空值（如 `ollama`）
Endpoint compatibility	OpenAI-compatible
Model ID	qwen2.5:7b-32k

✅ 完成！后续选项可以选择 Skip for now

5.5 解决上下文窗口错误

如果遇到上下文相关报错，手动修改配置文件：

配置文件路径：C:\Users\你的用户名\.openclaw\agents\main\agent\models.json
将 contextWindow 和 maxTokens 的值改为 32768

{  "contextWindow": 32768,  "maxTokens": 32768}

然后重启OpenClaw：

openclaw gateway restart

六、接入API Key（MiniMax/OpenAI等）

如果没有显卡，也可以使用API Key接入云端大模型。

6.1 MiniMax API接入（推荐国内用户）

访问 MiniMax开放平台
注册账号并完成实名认证
进入「API Keys」页面创建新的Key
复制并保存Key
（仅显示一次！）

6.2 OpenClaw配置MiniMax

openclaw onboard --install-daemon

配置参数：

选项	值
工作区路径	直接回车（默认）
AI模型提供商	选择 MiniMax
API Key	粘贴你复制的Key
网关端口	默认 18789，直接回车
聊天平台	选择 Skip 跳过
安装守护进程	输入 `Y`

6.3 OpenAI API接入

如果你有OpenAI API Key或其他OpenAI兼容接口（如SiliconFlow、DeepSeek等）：

方式一：通过配置向导

openclaw onboard

选择：

选项	值
Model/auth provider	Custom Provider
API Base URL	你的API地址（如 https://api.siliconflow.cn/v1）
API Key	你的API Key
Model ID	你的模型名

方式二：手动配置文件

编辑配置文件：

openclaw config

或在 ~/.openclaw/openclaw.json 中添加：

{  "models": {    "providers": {      "custom": {        "baseUrl": "https://api.siliconflow.cn/v1",        "apiKey": "你的API-Key",        "api": "openai-completions",        "models": [          {            "id": "Qwen/Qwen2.5-7B-Instruct",            "name": "SiliconFlow Qwen",            "contextWindow": 128000,            "maxTokens": 8192          }        ]      }    }  },  "agents": {    "defaults": {      "model": {        "primary": "custom/Qwen/Qwen2.5-7B-Instruct"      }    }  }}

⚠️ 常见API平台：

平台	Base URL
SiliconFlow	https://api.siliconflow.cn/v1
DeepSeek	https://api.deepseek.com/v1
OpenAI官方	https://api.openai.com/v1
MiniMax	https://api.minimax.chat/v1

七、启动与验证

7.1 启动Gateway

openclaw gateway

或者指定端口：

openclaw gateway --port 18789

7.2 打开Dashboard

浏览器访问：

http://127.0.0.1:18789

如果需要Token，运行：

openclaw dashboard --no-open

查看输出中的Token，然后访问：

http://127.0.0.1:18789/?token=你的Token

7.3 启动TUI交互模式

openclaw tui

🎉 发送测试指令，例如：

"你好"
"帮我打开记事本"
"创建一个hello.txt文件，写入Hello World"

7.4 常用命令一览

命令	功能
`openclaw --version`	查看版本
`openclaw status`	查看服务状态
`openclaw config`	编辑配置文件
`openclaw doctor`	诊断问题
`openclaw logs`	查看日志
`openclaw gateway restart`	重启服务

八、常见问题解答

Q1: 安装太慢怎么办？

使用国内镜像：npm config set registry https://registry.npmmirror.com/
跳过编译：npm install -g openclaw --ignore-scripts

Q2: Dashboard打不开？

检查服务状态：openclaw status
检查端口占用：netstat -ano | findstr 18789
尝试更换端口：openclaw gateway --port 18790

Q3: 回答很慢或回答错误？

检查Ollama是否正在运行：ollama list
确认上下文窗口配置正确
尝试使用更小的模型

Q4: WSL2访问不到Dashboard？

设置端口转发（PowerShell管理员）：

netsh interface portproxy add v4tov4 listenport=18789 connectport=18789 connectaddress=127.0.0.1

Q5: 如何卸载OpenClaw？

npm uninstall -g openclaw

Q6: 飞书/钉钉怎么接入？

💡 飞书接入示例：

# 安装飞书插件openclaw plugins install @openclaw/feishu# 配置飞书参数openclaw config set channels.feishu.appId "你的AppID"openclaw config set channels.feishu.appSecret "你的AppSecret"openclaw config set channels.feishu.enabled trueopenclaw gateway restart

希望这篇教程能帮你顺利完成OpenClaw的本地部署！如果觉得有用，欢迎收藏并转发给需要的朋友。