OpenClaw本地私有化部署教程

1.准备工作：检查你的电脑

动手之前，咱们先把“地基”打牢。想让OpenClaw在你的Windows电脑上顺利跑起来，先得确认几项硬指标是否达标。

操作系统: Windows 10或11都行，当然，Windows 11是更优的选择。

内存: 16GB是起步线，不能再低了。

显卡 (GPU): 如果你有一块显存不少于8GB的NVIDIA显卡，那体验会流畅不少。实在没有也没关系，用CPU同样能运行，只是速度上会打个折扣。

硬盘: 准备好至少20GB的可用空间。

基础软件: 需要安装Node.js，版本要在18.0.0以上。直接从官网下载LTS版本（https://nodejs.org/zh-cn），安装过程中有个关键动作：记得勾选“Add to PATH”选项。

2. 部署Ollama：为OpenClaw装上“大脑”

OpenClaw需要一个“大脑”来思考，这个大脑就是大语言模型。Ollama这个工具，能让你在本地轻松管理和运行各种模型。

安装Ollama: 访问Ollama官网，找到Windows版本的下载链接，下载并完成安装。安装成功后，Ollama服务会在后台自动运行起来。

下载模型: 以管理员身份打开PowerShell。考虑到中文支持，通义千问系列模型是个不错的选择。根据你显卡显存的大小，在PowerShell中执行对应的命令来拉取模型：

# 显存≥8GB，推荐 qwen2.5:7b（约4.7GB）：

ollama pull qwen2.5:7b

# 显存≥10GB，可选 qwen3:8b（约5GB）：

ollama pull qwen3:8b

# 显存4GB左右，可选 qwen2.5:4b：

ollama pull qwen2.5:4b

关键步骤：扩展模型“内存”: 这里有个细节需要注意：OpenClaw要求模型的上下文窗口（你可以理解为模型的“短期记忆”容量）至少达到16000个tokens。但默认下载的模型通常只有4096。所以，我们需要手动给它“扩容”。

在PowerShell中，依次执行下面这组命令：

# 切换到你的用户目录（请将 <你的用户名> 替换为实际的）

cd C:\Users\<你的用户名>

# 创建一个配置文件 Modelfile

@“
FROM qwen2.5:7b
PARAMETER num_ctx 32768
“@ | Out-File -Encoding ascii Modelfile

# 基于这个配置文件，创建一个名为 qwen2.5:7b-32k 的新模型

ollama create qwen2.5:7b-32k -f Modelfile

# 验证自定义模型是否创建成功

ollama list

如果 ollama list 命令的输出列表里出现了 qwen2.5:7b-32k，那么恭喜你，模型定制成功了。

3.安装并配置OpenClaw（有些电脑这一步操作命令在PowerShell无法识别，可改用CMD终端）

安装OpenClaw

#在管理员PowerShell中执行npm全局安装命令：

npm install -g openclaw

#安装完成后，验证一下：

openclaw --version

顺利显示出版本号，就表示安装成功了。

可能的报错与解决: 安装OpenClaw时，如果遇到报错，别慌。通常是因为系统里缺少Git。这时，你需要访问 Git 官网下载页面（https://git-scm.com/download/win），下载并安装 Git。

关键步骤: 安装Git的过程中，到了 “Adjusting your PATH environment” 这个界面时，务必选择 “Git from the command line and also from 3rd-party software”（这是推荐选项）或者 “Use Git and optional Unix tools from the Command Prompt”。这个操作会将Git添加到系统PATH环境变量，让后续的npm命令能顺利找到它。（如果安装时忘选了，后续也能手动添加，但强烈建议一步到位。）其他选项保持默认，一路点击“Next”完成安装。

验证 Git 是否安装成功

为了确保环境变量生效，请重新打开一个管理员权限的PowerShell窗口。

#输入以下命令并回车：

git --version

如果显示了类似 git version 2.45.0.windows.1 的版本信息，说明Git已经正确安装且PATH配置无误。

4.配置OpenClaw对接Ollama（核心步骤）

接下来，我们要让OpenClaw认识并使用刚刚创建好的本地模型。通过运行配置向导来完成这个“牵线搭桥”的工作。

#在命令窗口中输入以下命令：

openclaw onboard

随后会出现交互式配置界面，根据提示选择YES并完成后续步骤。

5.启动服务并验证

#在管理员PowerShell中执行以下命令启动网关服务：

openclaw gateway --port 18789 --verbose

命令执行后，服务就开始在后台运行了。现在，打开你的浏览器，在地址栏输入：http://127.0.0.1:18789/?token=你刚才保存的Token（请将“你刚才保存的Token”替换为你实际复制的那一串字符）。

要找到这个Token，OpenClaw在首次启动或完成配置后，会自动生成并保存到主配置文件中。

打开配置文件: 使用文件资源管理器或记事本等文本编辑器，打开这个路径的文件：C:\Users\<你的用户名>\.openclaw\openclaw.json

查找 Token: 在文件内容里找到 gateway.auth.token 这个字段，它后面跟着的那一长串随机字符就是你要的Token。文件内容大致如下图：

如果浏览器能正常加载并显示出OpenClaw的对话界面，那么，你的本地私有化部署就宣告大功告成了！