OpenClaw专栏第四篇：Windows系统保姆级安装教程（附完整截图）

DFGZXxxxf

37人浏览 · 2026-07-06 07:42:05

DFGZXxxxf · 2026-07-06 07:42:05 发布

📌 目录导航

## 一、环境准备

### 1. 本篇目标与前置要求

### 2. Python 3.11.8安装

### 3. Node.js 22.0.0安装

### 4. Git 2.40.0配置

## 二、核心部署

### 5. Docker Desktop安装

### 6. VS Code开发环境

### 7. OpenClaw核心安装

## 三、验证优化

### 8. 首次启动与验证

### 9. 常见问题解决方案

## 四、后续规划

### 10. 下期预告：Linux系统安装全攻略告

🎯 本篇目标与前置要求

✅ 学习目标

完成本篇教程后，你将能够：

✅ 在Windows系统上完整安装OpenClaw所有依赖
✅ 配置Python、Node.js、Git等核心环境
✅ 安装并配置Docker容器化环境
✅ 成功启动OpenClaw并访问WebUI
✅ 排查并解决常见安装问题

📋 前置要求

在开始之前，请确保已完成第三篇的准备工作：

✅ 硬件配置符合要求（推荐8GB内存+50GB SSD）
✅ Windows 10 2004+ 或 Windows 11系统
✅ 稳定的网络连接
✅ 管理员权限（用于安装软件）
✅ 已准备API密钥（OpenAI/Claude）

📥 第一步：Python 3.11.8完整安装

📥 下载Python安装包

访问Python官方下载页面：Download Python | Python.org
点击"Download Python 3.11.8"（或最新3.11.x版本）
保存安装包到本地（约27MB）

国内加速下载：

清华镜像：Index of /python/ | 清华大学开源软件镜像站 | Tsinghua Open Source Mirror
阿里云镜像：https://npm.taobao.org/mirrors/python/

🔧 安装步骤（图文详解）

1. 运行安装程序

双击下载的 python-3.11.8-amd64.exe，勾选以下选项：

击"Customize installation"（自定义安装）

2. 可选功能选择

在"Optional Features"页面，建议勾选：

点击"Next"（下一步）

3. 高级选项配置

在"Advanced Options"页面，配置如下：

1☑️ Install for all users
2☑️ Associate files with Python (requires the py launcher)
3☑️ Create shortcuts for installed applications
4☑️ Add Python to environment variables  ← 必须勾选
5☑️ Precompile standard library
6☐ Download debugging symbols（调试符号，可不选）
7☐ Download debug binaries（调试二进制，可不选）
8
9Installation path: C:\Python311  ← 建议修改为无空格路径

点击"Install"（安装）

4. 等待安装完成

安装过程约2-5分钟，进度条走完后点击"Close"

✅ 验证安装

打开命令提示符（Win+R → cmd → 回车），输入：

node -v

预期输出：

v22.0.0

验证npm：

npm -v

预期输出：

🔧 配置npm镜像源（国内用户必备）

npm config set registry https://registry.npmmirror.com
npm config set sass_binary_site https://npmmirror.com/mirrors/node-sass/
npm config set electron_mirror https://npmmirror.com/mirrors/electron/
npm config set puppeteer_download_host https://npmmirror.com/mirrors

验证配置：

npm config get registry

预期输出：

https://registry.npmmirror.com

🐛 常见问题解决

问题1：npm命令无法识别

解决方案：手动添加环境变量

环境变量 → Path → 新建
添加：C:\Program Files\nodejs
重启命令提示符

问题2：npm install失败

解决方案：

# 清除npm缓存
npm cache clean --force

# 重试安装
npm install

🔗 第三步：Git 2.40.0配置与SSH密钥

📥 下载Git安装包

访问Git官网：Git
点击"Download for Windows"
下载64位版本（约45MB）

国内加速下载：

清华镜像：Index of /github-release/git-for-windows/git/ | 清华大学开源软件镜像站 | Tsinghua Open Source Mirror

🔧 安装步骤（关键配置）

1. 运行安装程序

双击 Git-2.40.0-64-bit.exe，点击"Next"

2. 选择安装路径

建议保持默认：

☑️ Use WSL 2 instead of Hyper-V (recommended)

点击"OK"

3. 等待安装完成

安装过程约5-10分钟，完成后点击"Close"

4. 启动Docker Desktop

在开始菜单中找到"Docker Desktop"，点击启动

首次启动需要：

登录Docker账号（可跳过）
等待Docker引擎启动（约1-2分钟）
看到系统托盘出现鲸鱼图标

✅ 验证安装

打开命令提示符，输入：

docker --version

预期输出：

Docker version 24.0.0, build 1234567

验证Docker Compose：

docker-compose --version

预期输出：

Docker Compose version v2.20.0

🌍 配置Docker镜像加速（国内用户必备）

1. 右键系统托盘Docker图标 → Settings

2. 进入Docker Engine

在JSON配置中添加镜像源：

{
  "registry-mirrors": [
    "https://docker.mirrors.ustc.edu.cn",
    "https://registry.docker-cn.com",
    "https://hub-mirror.c.163.com"
  ]
}

3. 点击"Apply & Restart"

等待Docker重启完成。

🧪 测试Docker运行

# 拉取测试镜像
docker run hello-world

预期输出：

Hello from Docker!
This message shows that your installation appears to be working correctly.

💻 第五步：VS Code插件配置

📥 下载并安装VS Code

访问VS Code官网：Visual Studio Code - The open source AI code editor | Your home for multi-agent development
点击"Download for Windows"
运行安装程序，保持默认选项

🔌 推荐插件安装

打开VS Code，点击左侧扩展图标（或Ctrl+Shift+X），搜索并安装以下插件：

1. Python开发必备

✅ Python（Microsoft）- Python语言支持
✅ Pylance - Python语言服务器
✅ Python Indent - Python缩进优化
✅ Python Docstring Generator - 文档字符串生成
✅ autoDocstring - 自动文档字符串

2. Docker开发

2. Docker开发

3. Git工具

✅ GitLens - Git增强功能
✅ Git History - Git历史查看
✅ Git Graph - Git图形化展示

4. 代码质量

✅ ESLint - JavaScript代码检查
✅ Prettier - 代码格式化
✅ Code Runner - 代码快速运行

5. 主题与美化

✅ One Dark Pro - 经典暗色主题
✅ Material Icon Theme - 图标主题
✅ indent-rainbow - 缩进彩虹

⚙️ VS Code设置优化

按下 Ctrl+, 打开设置，搜索并配置：

基础设置

{
  "editor.fontSize": 14,
  "editor.tabSize": 4,
  "editor.insertSpaces": true,
  "editor.formatOnSave": true,
  "files.autoSave": "afterDelay",
  "workbench.colorTheme": "One Dark Pro",
  "workbench.iconTheme": "material-icon-theme"
}

Python设置

{
  "python.defaultInterpreterPath": "C:\\Python311\\python.exe",
  "python.terminal.activateEnvironment": true,
  "python.linting.enabled": true,
  "python.linting.pylintEnabled": true,
  "python.formatting.provider": "black",
  "python.autoComplete.extraPaths": []
}

第六步：OpenClaw核心安装

📥 下载OpenClaw源码

方法一：使用Git克隆（推荐）

# 创建项目目录
mkdir C:\openclaw
cd C:\openclaw

# 克隆仓库
git clone https://github.com/open-claw/open-claw.git

# 进入项目目录
cd open-claw

方法二：手动下载ZIP

访问 https://github.com/open-claw/open-claw
点击"Code" → "Download ZIP"
解压到 C:\openclaw\open-claw

🔧 安装Python依赖

# 确保在open-claw目录下
cd C:\openclaw\open-claw

# 安装依赖（使用国内镜像加速）
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

等待安装完成（约5-10分钟，取决于网络速度）

🔧 安装Node.js依赖

# 安装前端依赖
npm install --registry=https://registry.npmmirror.com

# 如果需要构建前端
npm run build

⚙️ 配置环境变量

在项目根目录创建 .env 文件：

# OpenClaw配置
PORT=7860
HOST=0.0.0.0
DEBUG=false

# OpenAI配置
OPENAI_API_KEY=sk-your-openai-api-key-here
OPENAI_MODEL=gpt-4o

# Claude配置（可选）
ANTHROPIC_API_KEY=sk-ant-your-claude-api-key-here
ANTHROPIC_MODEL=claude-3-5-sonnet-20260620

# Ollama配置（可选）
OLLAMA_HOST=http://localhost:11434
OLLAMA_MODEL=llama3

# 数据库配置
DATABASE_URL=sqlite:///data/openclaw.db

# 日志配置
LOG_LEVEL=INFO
LOG_FILE=logs/openclaw.log

重要提醒：

✅ 将 .env 添加到 .gitignore
✅ 替换API密钥为你的实际密钥
✅ 不要将 .env 文件提交到GitHub

📁 创建必要目录

# 创建数据目录
mkdir data
mkdir logs
mkdir skills
mkdir models

第七步：首次启动与验证

🎯 启动OpenClaw

方法一：直接运行（开发模式）

# 启动后端服务
python main.py

或使用uvicorn：

uvicorn app.main:app --host 0.0.0.0 --port 7860 --reload

方法二：使用Docker（生产模式）

# 构建镜像
docker build -t openclaw .

# 运行容器
docker run -d -p 7860:7860 -p 8000:8000 --name openclaw -v C:\openclaw\data:/app/data openclaw

✅ 验证启动成功

当看到以下输出时，说明启动成功：

INFO:     Started server process [1234]
INFO:     Waiting for application startup.
INFO:     Application startup complete.
INFO:     Uvicorn running on http://0.0.0.0:7860 (Press CTRL+C to quit)

🌐 访问WebUI

打开浏览器，访问：

http://localhost:7860

预期页面：

🎨 现代化Web界面
📊 仪表盘显示系统状态
🤖 模型选择下拉框
💬 聊天输入框

🧪 功能测试

1. 测试基础对话

在WebUI聊天框中输入：

你好，介绍一下你自己

预期响应：OpenClaw自我介绍

2. 测试文件操作

# 在命令行中测试
curl -X POST http://localhost:7860/api/v1/files/list -H "Content-Type: application/json" -d "{}"

3. 测试技能系统

在WebUI中：

点击"Skills"标签
查看可用技能列表
尝试启用一个技能

📊 系统状态检查

访问API端点：

# 检查健康状态
curl http://localhost:7860/api/v1/health

# 查看系统信息
curl http://localhost:7860/api/v1/system/info

常见问题解决方案

❌ 问题1：端口7860已被占用

错误信息：

OSError: [Errno 98] Address already in use

解决方案：

# 查找占用端口的进程
netstat -ano | findstr :7860

# 结束进程（替换PID为实际进程号）
taskkill /PID 1234 /F

# 或修改OpenClaw端口
# 在.env文件中修改：PORT=7861

❌ 问题2：Python依赖安装失败

错误信息：

ERROR: Could not find a version that satisfies the requirement xxx

解决方案：

# 升级pip
python -m pip install --upgrade pip

# 清理缓存
pip cache purge

# 逐个安装关键依赖
pip install fastapi uvicorn python-multipart sqlalchemy

# 再尝试完整安装
pip install -r requirements.txt

❌ 问题3：Docker容器无法启动

错误信息：

Error response from daemon: driver failed programming external connectivity

解决方案：

# 停止所有容器
docker stop $(docker ps -aq)

# 删除所有容器
docker rm $(docker ps -aq)

# 重启Docker Desktop
# 右键系统托盘Docker图标 → Restart

# 重新运行容器
docker run -d -p 7860:7860 openclaw

❌ 问题4：WebUI无法访问

排查步骤：

检查服务是否运行

curl http://localhost:7860

2.检查防火墙设置

# PowerShell中运行
New-NetFirewallRule -DisplayName "OpenClaw" -Direction Inbound -Protocol TCP -LocalPort 7860 -Action Allow

检查浏览器控制台
- 按F12打开开发者工具
- 查看Console和Network标签页的错误信息

❌ 问题5：API密钥验证失败

错误信息：

Invalid API key or insufficient permissions

解决方案：

检查 .env 文件中的API密钥是否正确
确认API密钥未过期
检查API余额是否充足
验证网络能否访问API服务器

💡 下期预告：Linux系统安装全攻略

在下一篇博客中，我们将深入Linux系统安装！内容包括：

✅ Ubuntu 22.04 LTS详细安装步骤
✅ Debian 12最小化安装配置
✅ CentOS Stream 9企业级部署
✅ WSL2（Windows Subsystem for Linux）安装指南
✅ Linux系统优化与性能调优
✅ systemd服务配置与开机自启
✅ Nginx反向代理配置

预计发布时间：2026年7月8日
难度等级：⭐⭐⭐ 进阶
适用人群：开发者、运维工程师、Linux爱好者

📝 本篇总结

表格

安装步骤	关键要点	预计时长
Python安装	勾选"Add to PATH"，配置镜像源	5分钟
Node.js安装	配置npm镜像源	3分钟
Git配置	生成SSH密钥，关联GitHub	10分钟
Docker安装	启用WSL2，配置镜像加速	10分钟
VS Code配置	安装推荐插件	5分钟
OpenClaw安装	克隆仓库，安装依赖	10分钟
首次启动	访问WebUI，功能测试	5分钟

总计：约48分钟（含下载时间）

💬 互动环节

欢迎在评论区留言讨论：

你在安装过程中遇到了什么问题？
哪个步骤最让你头疼？需要更详细的说明吗？
你成功启动OpenClaw了吗？截图分享一下！

点赞+收藏+关注，不错过每一篇保姆级教程！

龙虾开发者社区

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地，聚焦技能开发、插件实践与部署教程，为开发者提供可直接落地的方案、工具与交流平台，助力高效构建与落地 AI 应用

更多推荐

AI Agent 实战——用 LangChain + GPT-4o 从零搭一个智能代码审查助手

一、为什么要做 AI Code Review代码审查是开发流程中最耗时但也最重要的环节。一个中等规模的 PR，人工 Review 下来少则 15 分钟，多则半小时。而且人的注意力是有限的——看多了难免漏掉边界情况、空指针、日志泄露等问题。所以我用 LangChain + GPT-4o 搭了一个自动化代码审查 Agent。它能做到：对提交的代码做静态分析（风格、命名、空指针、异常处理）给出逐行的改进

龙虾开发者社区

从零到一搞懂 AI Agent：原理、工作流程、LangChain Tool Use 与实战

龙虾开发者社区

【从零到一实现一个 AI Agent 框架 · 第九篇】多 Agent 协作：从独奏到交响

从零到一实现一个 AI Agent 框架 · 第九篇🚧 项目正在积极开发中，欢迎 Star、提 Issue 和 PR 参与共建！

龙虾开发者社区

所有评论(0)

查看更多评论

DFGZXxxxf

@DFGZXxxxf

已为社区贡献2条内容

OpenClaw专栏第四篇：Windows系统保姆级安装教程（附完整截图）

DFGZXxxxf

📌 目录导航

🎯 本篇目标与前置要求

✅ 学习目标

📋 前置要求

📥 第一步：Python 3.11.8完整安装

📥 下载Python安装包

🔧 安装步骤（图文详解）

1. 运行安装程序

2. 可选功能选择

3. 高级选项配置

4. 等待安装完成

✅ 验证安装

🔧 配置npm镜像源（国内用户必备）

🐛 常见问题解决

问题1：npm命令无法识别

问题2：npm install失败

🔗 第三步：Git 2.40.0配置与SSH密钥

📥 下载Git安装包

🔧 安装步骤（关键配置）

1. 运行安装程序

2. 选择安装路径

3. 等待安装完成

4. 启动Docker Desktop

✅ 验证安装

🌍 配置Docker镜像加速（国内用户必备）

1. 右键系统托盘Docker图标 → Settings

2. 进入Docker Engine

3. 点击"Apply & Restart"

🧪 测试Docker运行

💻 第五步：VS Code插件配置

📥 下载并安装VS Code

🔌 推荐插件安装

1. Python开发必备

2. Docker开发

3. Git工具

4. 代码质量

5. 主题与美化

⚙️ VS Code设置优化

基础设置

Python设置

第六步：OpenClaw核心安装

📥 下载OpenClaw源码

方法一：使用Git克隆（推荐）

方法二：手动下载ZIP

🔧 安装Python依赖

🔧 安装Node.js依赖

⚙️ 配置环境变量

📁 创建必要目录

第七步：首次启动与验证

🎯 启动OpenClaw

方法一：直接运行（开发模式）

方法二：使用Docker（生产模式）

✅ 验证启动成功

🌐 访问WebUI

🧪 功能测试

1. 测试基础对话

2. 测试文件操作

3. 测试技能系统

📊 系统状态检查

常见问题解决方案

❌ 问题1：端口7860已被占用

❌ 问题2：Python依赖安装失败

❌ 问题3：Docker容器无法启动

❌ 问题4：WebUI无法访问

❌ 问题5：API密钥验证失败

💡 下期预告：Linux系统安装全攻略

📝 本篇总结

💬 互动环节

所有评论(0)

温馨提示：您尚未绑定手机号

DFGZXxxxf