OpenClaw安装教程：Windows11本地模型部署指南

2026-06-17阅读 0热度 0

人工智能

先说下我这边的测试环境：Dell Inspiron 14 Plus 7430（i7-13620H + 16G + 1T），双显卡 Intel + Nvidia RTX 4050 6G，系统是 Windows 11，网络环境就是纯国内网络，没有任何科学上网手段。整篇教程完全基于这个环境展开，所有步骤都亲自跑过，确保可行。

准备好了吗？下面一步步来。

第一步：安装 Node.js

Node.js 是整个 OpenClaw 的基础依赖，装起来很简单：

1. 打开 Node.js 官网 https://nodejs.org/en/download，选择 v22.22.0 (LTS) 版本，Windows x64 的 Windows Installer (.msi) 下载。

2. 下载后一路 Next，除了可以改一下安装位置（建议保持默认），其他全部默认，直到安装完成。

3. 验证是否装成功：以管理员模式打开 Windows PowerShell，输入：

node -v
npm -v

能分别显示版本号就说明搞定了。如果遇到 npm : 无法加载文件 C:Program Files\nodejs\npm.ps1，因为在此系统上禁止运行脚本。 这个经典错误，别慌，先输入一行命令解除限制：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

这个命令是授予当前用户执行本地脚本的权限，不会影响安全性。至于 PowerShell 的几种执行策略，简单说就是：Restricted（禁止所有脚本）、AllSigned（只运行有签名的）、RemoteSigned（本地脚本随意，网络下载的需签名）、Unrestricted（全允许但会提示）、Bypass（全允许且不提示）。我们这里改成 RemoteSigned 就够了。

可以用 Get-ExecutionPolicy 查看当前策略是否已生效。

第二步：切换国内镜像源

npm 默认源在国外，下载慢还容易超时。在刚才的 PowerShell 终端输入：

npm config set registry https://registry.npmmirror.com
npm config get registry   # 显示 https://registry.npmmirror.com 即为成功

也可以直接用 npm config list 查看 registry 是否已切换到阿里云镜像。

第三步：安装生成工具

OpenClaw 安装过程中需要用到 Git、Python 和 C++ 构建工具，一起装好。

3.1 安装 Git

到 https://git-scm.com/download/win 下载 Windows x64 安装包，一路默认安装。然后打开管理员模式的 PowerShell，执行两条配置命令，把 git 协议强制转为 https 协议，避免拉取依赖时卡住：

git config --global url."https://github.com/".insteadOf git@github.com:
git config --global url."https://".insteadOf git://

第一条把所有 git@github.com: 开头的 URL 替换成 https://github.com/，第二条把 git:// 协议也转成 https://，防止某些依赖用了这个协议。

3.2 安装 Python

到 https://www.python.org/downloads/ 下载，建议选 3.11.7（64位）。安装时切记勾选 Add python.exe to PATH，然后点安装。

3.3 安装 Windows Build Tools

到 https://visualstudio.microsoft.com/zh-hans/visual-cpp-build-tools/ 下载。安装时选择 "Desktop development with C++" 工作负载，并且确保 Windows 10/11 SDK 被选中。这一步是为了后面编译原生模块准备的。

第四步：一键安装 OpenClaw 并初步配置

重新打开一个管理员模式的 PowerShell 终端（注意是新的窗口），输入以下命令开始安装：

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

如果不想安装在默认位置（默认是你的用户主目录下的 .openclaw），可以在运行安装命令之前先设置环境变量。例如我想装到 D:\ai\openclaw，就提前执行：

New-Item -ItemType Directory -Path 'D:\ai\openclaw' -Force
[Environment]::SetEnvironmentVariable("OPENCLAW_HOME", "D:\ai\openclaw", "User")
[Environment]::GetEnvironmentVariable("OPENCLAW_HOME", "User")   # 确认一下

设置好之后再运行安装命令。安装过程会下载依赖，耐心等待即可，万一出错了，可以截图丢给 DeepSeek 或者搜一下。

安装成功后，会自动进入首次配置界面（OpenClaw onboarding）。这里选 Yes 才能继续。接着选 Quickstart 快速配置，然后会问大模型提供商。如果你有 Z.AI 账号可以直接选 Z.AI，没有的话可以先跳过，后续再配；本地模型（Ollama）也先跳过，后面会专门讲。Channel 和 Skills 也先跳过，飞书后面再配，技能以后再说。

之后就是自动安装网关和自动配置，完成时打开浏览器输入地址就能看到控制台了。如果一次没打开，关掉终端重新打开，输入 openclaw gateway start 启动网关。首次访问控制台记得带上 ?token=xxx（安装成功时终端会给出 token）。

第五步：配置飞书（OpenClaw 端）

飞书那边的应用创建流程网络上很多，这里只讲 OpenClaw 这一侧。OpenClaw 已经内置了飞书插件，不用额外下载。先列出插件看状态：

openclaw plugins list

看到 feishu 是 disabled 状态，启用它：

openclaw plugins enable feishu

然后添加飞书渠道：

openclaw channels add

按提示选飞书，填入 App ID、App Secret 等（这些从飞书开放平台获取），完成后退出。启动飞书客户端，添加机器人后随便发条消息，机器人会返回一个配对码。把这个配对码复制到终端，运行批准命令（提示会给出），看到成功提示后，那个新账号就可以和机器人正常对话了。

第六步：配置本地大模型

线上模型太烧 token 了，而且最近阿里千问在 Hugging Face 和 ModelScope 开源了 Qwen3.5 小尺寸系列（0.8B、2B、4B、9B），原生多模态训练，混合架构，很适合本地部署。本地推理工具有很多，这里推荐 LM Studio，它提供零代码图形界面，全离线运行，直接访问 Hugging Face 的模型市场，硬件自动适配，非常省心。

操作步骤：

1. 到 https://lmstudio.ai/ 下载 Windows 版本，一路 Next 安装。

2. 打开 LM Studio，在搜索框搜 qwen3.5-9B，选择具体版本（推荐 Qwen3.5-9B 或相应变体），下载。

3. 下载完成后，在模型列表中点击加载（Load），立即就可以对话测试了。这个模型还支持图像输入。

4. 设置服务器模式：点击左下方的开发模式图标（图1处），进入开发模式；然后点“本地服务”（图2处），点击“运行服务器”（图3处），再点击“载入模型”（图4处）。

5. 接着点击服务器设置（图1处），可以更改端口（我改成了 4321），也可以开启并设置 API Key（虽然不是必须，但仪式感还是要有的）。

6. 加载模型时注意上下文长度（Load 处的参数），建议设置大一点，比如 8192，防止对话长度不够。

第七步：对接 OpenClaw

打开管理员模式的 PowerShell 终端，输入 openclaw config 开始配置：

选择 Local (this machine)
选择 Model
选择 Custom Provider
API Base URL：填入 http://127.0.0.1:4321/v1（如果你没改端口就是 1234，这里按实际填）
API Key：如果 LM Studio 里设置了就填，没设就留空
Endpoint compatibility：选 OpenAI-compatible
Model ID：填你下载的模型名称，比如 qwen3.5-9B
执行 Verification 测试连接是否成功
Endpoint ID：随便写一个（不改也行）
Model alias：可以给模型起个别名，方便以后调用

完成配置后，重启 OpenClaw 网关：openclaw gateway restart，就可以在对话中使用本地模型了。试试看能不能正常回复。

附加：两个实用技巧

1. OpenClaw 无法执行读写文件操作

如果你遇到 Agent 无法读写文件、运行代码的情况，先检查工具权限：

openclaw config get tools.profile

如果返回 messaging，那说明工具权限被限制得太死（只有消息相关工具可用）。可以用内置的 profile 快速调整：

# 设置成 coding 模式，自动启用文件系统、运行时等核心工具
openclaw config set tools.profile "coding"
# 或者设置为 full（无限制，本地开发推荐）
openclaw config set tools.profile "full"

各 profile 的区别：

minimal：仅 session_status
coding：包含文件读写、编辑、执行进程等
messaging：仅消息相关工具（默认可能就是这个坑）
full：全部工具可用

2. 安装技能管理工具 clawhub

clawhub 是 OpenClaw 官方推荐的 Skills 安装工具，支持命令行和 WebUI 两种方式。建议用命令行安装，更稳定：

npm install -g clawhub
clawhub --version   # 验证安装成功，看到版本号就行

安装后就可以通过 clawhub install 技能名称 来安装各类技能了，非常方便。