前言

OpenClaw提供两种安装方式：WSL2（稳定但需配置子系统）、原生Windows（上手快但对终端环境挑剔）。本文只讲原生Windows安装，也是官方推荐的快速上手方案，全程无需复杂配置，适合普通用户。

一、安装前必备工具（3个，一键安装）

OpenClaw基于Node.js 开发，需要提前准备3个基础工具，全程默认安装即可：

Node.js：程序运行核心环境，必须选LTS长期支持版（推荐22.x版本）
Git：用于拉取源码、执行Shell脚本，Windows默认没有bash环境，全靠Git
pnpm：项目依赖包管理工具，比npm更快，官方指定使用

二、原生Windows安装全步骤（大白话版）

第1步：安装Node.js

打开Node.js中文官网：https://nodejs.org/zh-cn/download/
下载Windows .msi安装包，选择LTS长期版，别选测试版
双击安装包，全程点下一步，无需修改任何配置
验证安装：打开PowerShell，输入node --version和npm --version，能显示版本号就成功

第2步：安装Git

下载Git Windows安装包，双击运行
全程默认安装，安装完成后，文件夹右键会出现Git Bash Here选项
这一步是关键！后续构建项目全靠Git自带的bash工具

第3步：安装pnpm并配置国内镜像

在任意空文件夹右键 → Git Bash Here，打开Git终端
安装pnpm：npm install -g pnpm
配置国内镜像（解决依赖下载慢/失败）：pnpm config set registry https://registry.npmmirror.com/

第4步：拉取源码并安装依赖

找一个空文件夹，右键打开Git Bash，拉取中国版源码：
git clone https://gitee.com/OpenClaw-CN/openclaw-cn.git
进入项目目录：cd openclaw-cn
安装项目依赖：pnpm install（等待加载完成，不要关闭终端）

第5步：构建项目（核心步骤）

先构建UI界面：pnpm ui:build
整体项目构建：pnpm build

第6步：启动安装向导（必须用PowerShell）

官方特别提醒：Git Bash无法操作交互式菜单，上下键会失灵，必须切换到PowerShell

以管理员身份打开Windows PowerShell
进入项目目录（我的路径：cd D:\OpenClaw，替换成你的路径）
启动向导：pnpm openclaw onboard --install-daemon

第7步：向导快速配置（一路选就行）

安全提示输入yes确认
选择QuickStart快速开始
选择AI模型（如DeepSeek），输入你的API Key
沟通通道选Skip for now（后续再配置飞书/微信）
最后选择Open the Web UI，自动打开浏览器界面即安装成功

官方常见问题汇总（提前避坑）

权限不足：全程用管理员身份运行PowerShell，否则安装失败
端口冲突：默认端口18789被占用，用netstat -ano | findstr 18789查看占用程序并关闭
杀毒软件拦截：暂时关闭360、电脑管家、Windows防火墙，安装完成后再开启
Git Bash按键失效：启动向导绝对不用Git Bash，只能用PowerShell

安装成功验证

打开浏览器访问：127.0.0.1:18789/chat，能看到OpenClaw的Web UI 界面，可正常和AI对话，就是彻底安装成功了！

后续基础配置（让AI真正用起来）

1. 配置AI大脑

在Web UI中绑定DeepSeek、GLM等大模型 API Key，让AI具备思考能力

2. 配置飞书机器人（可选）

飞书开放平台创建企业自建应用，启用机器人权限
获取App ID、App Secret，填回OpenClaw后台
配置事件监听，发布应用后即可在飞书和AI对话

调用本地模型看这里

ollama为例

安装ollama
1.下载模型 ollama pull deepseek-r1:1.5b
2.进入目录创建定制模型（扩大上下文）

12345678
# 1.进入用户目录
cd C:\Users\<你的用户名>
# 2.创建文件
echo "FROM deepseek-r1:1.5b" > Modelfile
echo "PARAMETER num_ctx 32768" >> Modelfile
# 3. 检查文件内容是否正确
Get-Content Modelfile

3.应该看到输出：

123
FROM deepseek-r1:1.5b
PARAMETER num_ctx 32768

4.然后运行：

12
ollama create deepseek-r1:1.5b-32k -f Modelfile

OpenClaw启动向导后到选择ai的时候
根据选项列表，选择 Custom Provider 即可。

这个选项通常位于列表的最底部，在 Cloudflare AI Gateway 之后，Skip for now 之前。

选择 Custom Provider 后，系统会提示你输入后续的三个关键信息：

API Base URL: http://127.0.0.1:11434/v1

API Key: 随便输入一些字符（例如 ollama 或 123）

Model ID: 你在 Ollama 中创建的模型名称（例如 deepseek-r1:1.5b-32k）

特别注意：列表中的 OpenAI 选项虽然也能通过配置实现连接，但它可能会强制使用 OpenAI 的格式规则。对于 Ollama 本地部署，选择 Custom Provider 并手动填写地址是最稳妥、最简单的方法。

安装插件让ai更智能

12345678910
# 1. 全局安装 clawhub CLI（推荐使用 npm）
npm install -g clawhub

# 如果 npm 安装慢，可以先用国内镜像
npm config set registry https://registry.npmmirror.com/
npm install -g clawhub

# 2. 验证安装是否成功
clawhub --version

安装完成后，再执行登录和安装

现在 clawhub 命令可用了，按标准流程走：

123456789
# 1. 登录 ClawHub（会打开浏览器授权）
clawhub login

# 2. 登录成功后，搜索确认 computer-use 技能
clawhub search computer-use

# 3. 安装技能
clawhub install computer-use

重启 OpenClaw

123
# 先按 Ctrl+C 停止服务，然后
pnpm openclaw gateway

测试技能

在网页端输入：

12
用浏览器打开 example.com