OpenClaw本地私有化部署教程

2026-05-06阅读 0热度 0
养龙虾

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的对话界面,那么,你的本地私有化部署就宣告大功告成了!

免责声明

本网站新闻资讯均来自公开渠道,力求准确但不保证绝对无误,内容观点仅代表作者本人,与本站无关。若涉及侵权,请联系我们处理。本站保留对声明的修改权,最终解释权归本站所有。

相关阅读

更多
欢迎回来 登录或注册后,可保存提示词和历史记录
登录后可同步收藏、历史记录和常用模板
注册即表示同意服务条款与隐私政策