大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



Windows 系统安装 OpenClaw（小龙虾）的核心难点在于适配 Redis/MySQL 服务和 Python 环境兼容性，我会为你提供Windows 原生环境下的完整安装步骤（无需 WSL），步骤更贴合 Windows 操作习惯，全程可落地。

OpenClaw 对 Python 版本敏感，建议安装 Python 3.8.x（3.7~3.9 均可，3.10+ 易出依赖问题）：

• 下载地址：https://www.python.org/downloads/release/python-3810/
• 安装时务必勾选 Add Python 3.8 to PATH（自动配置环境变量）；
• 验证安装：打开「命令提示符（CMD）」或「PowerShell」，输入 python –version，显示 Python 3.8.10 则成功。

Redis 官方不提供 Windows 安装包，使用微软维护的版本：

1. 下载地址：https://github.com/microsoftarchive/redis/releases/tag/win-3.0.504
2. 下载 Redis-x64-3.0.504.zip，解压到 D:\Redis（自定义路径，建议无中文 / 空格）；
3. 启动 Redis： 进入解压目录，双击 redis-server.exe（前台启动，保持窗口打开）； 可选：创建批处理文件 start-redis.bat，内容为 D:\Redis\redis-server.exe D:\Redis\redis.windows.conf，双击启动更方便。

1. 下载 MySQL Installer：https://dev.mysql.com/downloads/installer/（选择「MySQL Installer for Windows」）；
2. 安装时选择「Custom」，勾选「MySQL Server 8.0.x」（兼容 OpenClaw），一路下一步： 设置 root 密码（如 ，务必记住）； 端口保持 3306，服务名默认 MySQL80；
3. 验证安装：打开「MySQL Command Line Client」，输入密码后能进入 MySQL 命令行则成功。

• 方式 1（推荐）：安装 Git（https://git-scm.com/download/win），然后在 CMD 中执行：
• bash
• 运行
• git clone https://github.com/OpenClaw/OpenClaw.git cd OpenClaw
• 方式 2：直接下载源码包：https://github.com/OpenClaw/OpenClaw/archive/refs/heads/master.zip，解压到 D:\OpenClaw。

bash

运行

# 安装虚拟环境工具 pip install virtualenv

进入 OpenClaw 目录（替换为你的解压路径）

cd D:\OpenClaw

创建虚拟环境（命名为 claw-env）

virtualenv claw-env

激活虚拟环境（Windows 专属命令）

claw-env\Scripts\activate

激活成功后，命令行前缀会显示 (claw-env)，表示进入虚拟环境。

Windows 安装依赖易出问题，优先用国内源 + 指定版本：

bash

运行

# 更换国内 PyPI 源（提速+解决下载失败） pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

先安装基础依赖（解决 cryptography 等编译问题）

pip install wheel pywin32

安装 OpenClaw 核心依赖

pip install -r requirements.txt

若出现 “error: Microsoft Visual C++ 14.0 or greater is required” 报错：

下载并安装 Visual C++ 构建工具：https://visualstudio.microsoft.com/visual-cpp-build-tools/

安装时勾选「Desktop development with C++」，完成后重新执行 pip install -r requirements.txt

1. 复制 config.example.py 并重命名为 config.py（直接在文件夹中复制粘贴，改名字即可）；
2. 用记事本 / VS Code 打开 config.py，修改核心配置：

python

运行

# 数据库配置（替换为你的 MySQL 密码） SQLALCHEMY_DATABASE_URI = ‘mysql+pymysql://root:@127.0.0.1:3306/openclaw?charset=utf8mb4’

Redis 配置（Windows 无需密码，默认端口 6379）

REDIS_HOST = ‘127.0.0.1’ REDIS_PORT = 6379 REDIS_PASSWORD = “ # 留空 REDIS_DB = 0

服务端口（默认 5000，避免被占用）

PORT = 5000 DEBUG = False # 生产环境关闭

1. 打开 MySQL 命令行，创建数据库：
2. sql
3. CREATE DATABASE IF NOT EXISTS openclaw DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; exit;
4. 回到 OpenClaw 目录（已激活虚拟环境），执行数据库初始化：
5. bash
6. 运行
7. # 方式 1：执行初始化脚本 python init_db.py # 方式 2：手动初始化（备用） python >>> from app import db >>> db.create_all() >>> exit()

确保 Redis（redis-server.exe 窗口）和 MySQL 服务已启动，然后在虚拟环境中执行：

bash

运行

# 测试启动（简单易用，适合新手） python run.py 

启动成功会显示：* Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)。

打开浏览器，输入 http://127.0.0.1:5000：

• 默认账号：admin
• 默认密码：
• 登录后建议立即修改密码（进入「系统设置」→「用户管理」）。

1. Redis 启动报错「端口被占用」：
2. 打开 CMD，执行 netstat -ano | findstr :6379，查看占用进程 PID；
3. 打开「任务管理器」→「详细信息」，结束对应 PID 的进程，重新启动 Redis。
4. MySQL 连接失败「Access denied」：
5. 进入 MySQL 命令行，执行：
6. sql
7. GRANT ALL PRIVILEGES ON openclaw.* TO ‘root’@‘localhost’ IDENTIFIED BY ‘’; FLUSH PRIVILEGES;
8. 检查 config.py 中密码是否与 MySQL root 密码一致。
9. 启动 run.py 提示「缺少模块」：
10. 确认虚拟环境已激活（命令行有 (claw-env) 前缀）；
11. 重新执行 pip install -r requirements.txt，确保所有依赖安装完成。
12. 浏览器无法访问 127.0.0.1:5000：
13. 检查 Windows 防火墙是否拦截 5000 端口，临时关闭防火墙测试；
14. 确认 run.py 启动窗口无报错，且显示「Running on http://127.0.0.1:5000/」。

1. Windows 安装核心是适配 Redis/MySQL 的 Windows 版本，且必须保证 Python 版本为 3.7~3.9；
2. 关键步骤：安装基础服务（Python/Redis/MySQL）→ 配置数据库连接 → 初始化表结构 → 启动服务；
3. 启动前务必确认 Redis（前台窗口）和 MySQL 服务已运行，虚拟环境激活后再执行启动命令。

如果遇到具体报错（如依赖安装失败、端口占用），可以在评论区告诉我完整的错误信息，我会帮你针对性解决。