OpenClaw的安装（纯Windows，纯国内+本地模型）

OpenClaw 是 2026 年最火的本地 AI 智能体框架，能帮你自动处理文件、执行命令、操控浏览器、接入飞书/微信，关键是数据完全本地存储，隐私安全拉满。本教程专为纯 Windows 环境 + 纯国内网络 + 本地模型用户设计，全程无需翻墙、无需 API Key、无需付费，跟着做就能成功。

一、安装前准备

1.1 系统与硬件要求

组件 最低要求 推荐配置

操作系统 Windows 10 21H2+ Windows 11

内存 ≥8GB ≥16GB（本地跑模型更流畅）

硬盘空间 ≥20GB ≥50GB

CPU 支持虚拟化 开启 BIOS 虚拟化

GPU 可选 NVIDIA 4GB+ 显存更佳

1.2 必装基础软件

（1）Node.js 22+（核心运行环境）

下载 LTS 版本 22.x

官网：https://nodejs.org/

安装时务必勾选 "Add to PATH"

验证安装：

node -v # 输出 v22.x.x 说明成功

npm -v # 输出对应版本号

（2）开启 WSL2（推荐，兼容性最好）

管理员 PowerShell 执行

wsl --install

重启电脑后设置 Ubuntu 用户名和密码

wsl -l -v # 验证 VERSION 为 2

（3）解锁 PowerShell 执行权限

管理员 PowerShell

Set-ExecutionPolicy Bypass -Scope Process -Force

或

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

二、OpenClaw 安装（3 种方法任选）

方法 1：PowerShell 一键安装（新手首选）

官方脚本（需联网）

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

国内镜像脚本（网络受限时用）

iwr -useb https://clawd.org.cn/install.ps1 | iex

验证安装

openclaw --version # 输出版本号即成功

方法 2：npm 全局安装

npm install -g openclaw@latest

openclaw --help # 看到命令列表即成功

方法 3：WSL2 内安装（兼容性最佳）

进入 WSL2

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

三、本地模型配置（Ollama + Qwen）

3.1 安装 Ollama

下载 OllamaSetup.exe

官网：https://ollama.com/download

自定义安装到 D 盘（可选）

.OllamaSetup.exe /DIR="D:Ollama"

3.2 配置模型存储路径

创建模型目录

New-Item -ItemType Directory -Path "D:OllamaModels" -Force

设置环境变量（永久）

右键"此电脑"→属性→高级系统设置→环境变量

用户变量新建：

变量名：OLLAMA_MODELS

变量值：D:OllamaModels

3.3 拉取适合本地运行的模型

启动 Ollama 服务（保持窗口开着）

ollama serve

拉取模型（根据显存选择）

ollama pull qwen2.5:3b # 2GB 左右，测试用

ollama pull qwen2.5:7b # 主力推荐，中文最强

ollama pull qwen2.5:7b-q5_K_M # 更高量化，质量更好

⚠️ 下载卡住解决办法：用手机热点/VPN（Cloudflare WARP/ProtonVPN）或手动从 Hugging Face 下载 gguf 文件

3.4 创建 32K 上下文版本（关键！）

下载完模型后必须执行，否则 OpenClaw 无法正常使用

ollama create qwen3.5-35b-32k -f Modelfile

四、OpenClaw 配置文件（openclaw.json）

4.1 配置文件位置

C:Users{用户名}.openclawopenclaw.json

4.2 完整配置参考（适配 Qwen3.5:35B + 本地 Ollama）

{

"models": {

"mode": "merge",

"providers": {

"custom-127-0-0-1-11434": {

"baseUrl": "http://127.0.0.1:11434/v1",

"apiKey": "ollama",

"api": "openai-completions",

"models": [

{

"id": "qwen3.5-35b-32k",

"name": "Qwen3.5 35B 32K (Local)",

"reasoning": false,

"input": ["text"],

"cost": {

"input": 0,

"output": 0,

"cacheRead": 0,

"cacheWrite": 0

},

"contextWindow": 32768,

"maxTokens": 8192

}

]

}

}

},

"agents": {

"defaults": {

"model": {

"primary": "custom-127-0-0-1-11434/qwen3.5-35b-32k"

},

"workspace": "C:Users{用户名}clawd",

"compaction": {

"mode": "safeguard"

},

"maxConcurrent": 4,

"subagents": {

"maxConcurrent": 8

}

}

},

"gateway": {

"port": 18789,

"mode": "local",

"bind": "loopback",

"auth": {

"mode": "token"

}

}

}

4.3 配置修复命令

自动清理无效字段

openclaw doctor --fix

备份原文件

Copy-Item "C:Users{用户名}.openclawopenclaw.json" "C:Users{用户名}.openclawopenclaw.json.bak"

五、启动与访问

5.1 配置 Gateway 模式

设置本地模式

openclaw config set gateway.mode local

安装 Gateway 服务（开机自启）

openclaw gateway install

启动服务

openclaw gateway start

验证状态

openclaw gateway status # 输出"Running"即成功

5.2 访问 Web 控制台

浏览器打开：

http://127.0.0.1:18789

出现登录界面即部署完成！

六、必装技能推荐

办公助手

openclaw skills install @openclaw/office

代码工具

openclaw skills install @openclaw/code

文件管理

openclaw skills install @openclaw/file

系统优化

openclaw skills install @openclaw/system

七、常见问题排查

问题 原因 解决方案

npm.ps1 cannot be loaded PowerShell 禁止脚本执行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

llama.cpp 编译失败 缺少 C++ 编译链 安装 VS Build Tools + Desktop C++ Workload

Gateway 无法访问 服务未启动/端口占用 openclaw gateway start 或更换端口

模型对接失败 Ollama 服务未运行 保持 ollama serve 窗口开启

配置文件报错 无效字段导致 openclaw doctor --fix 或手动替换配置

下载慢/中断 网络问题 切换热点/VPN，脚本支持断点续传

八、安全加固

深度安全审计

openclaw security audit --deep

九、总结

完成以上步骤后，你拥有了：

特性 说明

✅ 完全本地 数据不出本机，隐私安全

✅ 完全免费 无需任何 API 费用

✅ 断网可用 不依赖外部服务

✅ 32K 上下文 可处理长文档、复杂任务

✅ 可扩展 支持 Skills 技能插件生态

下一步探索

- 访问 ClawHub 安装更多社区 Skills

- 配置飞书/Telegram Bot 实现手机端随时对话

- 设置定时任务实现自动化工作流

文档版本：2026 年 3 月

官方文档：https://openclaw.ai

适用系统：Windows 10/11 + 纯国内网络 + 本地 Ollama 模型