一、OpenClaw 简介
OpenClaw（昵称"小龙虾"）是一款开源 AI 代理工具，定位为"AI 指挥官"，能够接收指令、调用工具并自动化处理任务。它支持对接国内外多款大模型，所有数据本地存储，兼顾实用性与安全性。本文将详细介绍在 Windows 11 系统上部署 OpenClaw 的完整流程。
二、环境准备
2.1 系统要求
- 操作系统：Windows 11 64位（Windows 10 1903+ 也适用，32位系统不支持）
- 内存：最低 2GB，推荐 4GB 以上（本地跑大模型建议 8GB+）
- 硬盘：预留至少 500MB 存储空间
- 网络：稳定联网（用于下载依赖，调用云端大模型需联网）
2.2 核心提醒
- 全程使用管理员权限操作终端，否则会出现权限不足报错
- 安装路径避免中文、空格、特殊符号（如"我的文件夹""Open Claw"）
- 安装过程不要关闭终端窗口、不要断网，耐心等待依赖下载
三、安装 OpenClaw
3.1 方式一：一键安装（推荐小白）
这是官方推荐的安装方式，专门为 Windows 小白打造，无需命令行基础，3分钟即可完成，自动配置所有环境和依赖。
步骤 1：打开管理员 PowerShell
- 点击 Windows 左下角搜索框，输入
PowerShell - 右键点击
Windows PowerShell，选择以管理员身份运行 - 弹出权限提示时点击
是
步骤 2：执行安装策略
在 PowerShell 中输入以下命令：
powershell
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser选择 A（全是）确认。
步骤 3：执行一键安装脚本
将以下命令完整复制，粘贴到 PowerShell 终端窗口，按下回车键：
powershell
iwr -useb https://openclaw.ai/install.ps1 | iex或者使用更完整的命令（包含 TLS 协议强制开启，防止下载失败）：
powershell
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://openclaw.ai/install.ps1'))3.2 方式二：手动安装（适合高级用户）
适合已有 Node.js 环境、需要自定义修改 OpenClaw 源码的用户，步骤稍繁琐，但能完全掌控安装过程。
步骤 1：安装 Node.js 22+
OpenClaw 对 Node.js 版本要求严格，必须 ≥22。
- 访问 Node.js 官网下载页：https://nodejs.org/zh-cn/download/
- 选择
Windows 安装包（64位），下载 v22.x.x 版本 - 双击安装包，关键步骤 ：勾选
Add to PATH（自动配置环境变量），其余默认下一步 - 验证：在终端输入
node -v和npm -v，能显示版本号即安装成功
步骤 2：安装 Git
- 下载地址：https://git-scm.com/downloads（选择 Windows 版本）
- 安装时默认配置即可，新手推荐勾选
Use Git from Git Bash only - 验证：终端输入
git --version，显示版本信息即成功
步骤 3：安装 OpenClaw
您有两种选择：英文版或中文版（推荐国内用户使用中文版，配置更友好）。
选项 A：安装中文版（推荐）
在 PowerShell 中运行：
powershell
pnpm add -g @qingchencloud/openclaw-zh@latest如果没有安装 pnpm，可将 pnpm 替换为 npm。
选项 B：安装国际英文版
powershell
pnpm add -g openclaw验证安装：openclaw-zh --version 或 openclaw --version。
四、初始化配置
安装完成后，需要运行向导来配置模型密钥和聊天渠道。
运行向导：
- 如果是中文版：
openclaw-zh onboard - 如果是英文版：
openclaw onboard
跟随交互式提示（使用键盘上下键选择，回车确认）：
| 步骤 | 选项 | 推荐选择 | 说明 |
|---|---|---|---|
| 1 | 安全警告 | 选择 Yes |
表示了解风险 |
| 2 | 安装模式 | 选择 QuickStart |
快速开始，适合新手 |
| 3 | 选择 AI 模型 | OpenAI GPT 或 Google Gemini | 国内网络选 Gemini 更稳定 |
| 4 | 输入 API Key | 根据提示粘贴密钥 | 去对应官网获取 API Key |
| 5 | 选择具体模型 | gpt-4o-mini 或 gemini-pro | 性价比高 |
| 6 | 选择通讯渠道 | 推荐先选 Skip for now |
稍后再配置 |
| 7 | 配置技能 | 选 No |
先基础运行，以后再加功能 |
| 8 | 安装守护进程 | 选 Yes |
这样关掉窗口也能运行 |
国内用户特别建议：
- 模型提供方选择
Qwen（通义千问），国内可直接访问 - 通讯渠道可稍后配置飞书、钉钉等国内平台
五、启动服务与验证
5.1 启动服务
配置完成后，启动 OpenClaw：
- 中文版：
openclaw-zh start - 英文版：
openclaw start
成功标志：终端会显示类似 Server running at http://localhost:3000 的信息。
5.2 验证是否成功
- 打开您配置的聊天软件（例如 Telegram）
- 向机器人发送
help或你好 - 如果机器人回复了消息，说明安装成功！
- 也可以在浏览器访问
http://localhost:3000查看管理面板（如果开启了 Web UI）
六、Windows 11 特有常见问题解决
6.1 报错：EPERM: operation not permitted 或权限拒绝
解决方法：
- 点击开始菜单，搜索
PowerShell - 右键点击，选择
以管理员身份运行 - 重新执行安装命令
6.2 报错：'openclaw' 不是内部或外部命令
解决方法：
- 完全关闭当前的 PowerShell 窗口
- 重新打开一个新的窗口
- 再次尝试运行命令
- 如果仍然不行，重启电脑
6.3 网络问题（连接 GitHub 或 npm 源超时）
解决方法 ：配置国内镜像源
在执行安装命令前，运行：
powershell
npm config set registry https://registry.npmmirror.com
pnpm config set registry https://registry.npmmirror.com6.4 如何在后台运行？
默认情况下，关闭 PowerShell 窗口服务就会停止。如果您希望它像软件一样在后台运行：
- 简单方法：保持 PowerShell 窗口最小化运行
- 进阶方法：使用 nssm（Non-Sucking Service Manager）将其注册为 Windows 服务，或者使用 Docker Desktop for Windows 进行容器化部署（适合高级用户）
七、国内适配：配置飞书通道
飞书是国内支持的官方平台，配置步骤如下：
- 创建飞书应用：前往飞书开放平台，创建"企业自建应用"
- 获取凭证：获取 App ID 和 App Secret
- 编辑配置文件 ：编辑
C:\Users\你的用户名\.openclaw\openclaw.json，添加飞书配置：
json
"channels": {
"feishu": {
"enabled": true,
"appId": "你的App ID",
"appSecret": "你的App Secret",
"connectionMode": "websocket"
}
}- 配置权限：在飞书控制台配置相应权限（参考完整权限列表）
- 重启网关 ：
openclaw gateway restart - 测试：重启后即可通过飞书与 OpenClaw 交互
八、总结
OpenClaw 在 Windows 11 上的部署虽然有一定技术门槛，但按照本文的步骤操作，大多数用户都能顺利完成安装。关键点总结：
- 环境准备是基础：确保 Node.js ≥22 版本，使用管理员权限操作
- 安装方式灵活选择：新手推荐一键安装，开发者可选手动安装
- 配置按需调整：根据网络环境选择合适的模型和通讯渠道
- 问题有解决方案：常见报错都有对应的解决方法
完成 OpenClaw 的安装只是一个起点。接下来的舞台将交给你的创意：是让它帮你处理繁琐的表格数据，还是让它成为你 24 小时在线的系统管家？在这个"人机协作"的时代，掌握自动化工具的部署，本质上是在升级你自己的效率系统。
如果在部署过程中遇到其他问题，欢迎在评论区留言交流！