A光明1. 项目概述
OpenClaw作为一款开源的机械臂控制框架，正在工业自动化和机器人研究领域获得越来越多的关注。最近我在一个仓储分拣项目中首次接触这个框架，发现它的模块化设计和跨平台特性确实能大幅降低机械臂开发的门槛。不过在实际部署过程中，环境配置这个"第一步"就让我踩了不少坑。
今天这篇教程，我会结合自己三次不同环境下的安装经验，详细拆解OpenClaw的环境准备全过程。不同于官方文档的简洁说明，这里会包含我在Windows 10、Ubuntu 20.04以及树莓派系统上实测可用的配置方案，特别是那些容易忽略的依赖项和版本冲突问题。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 核心依赖解析
2.1 系统环境要求
OpenClaw对运行环境有较强的版本敏感性。经过测试验证：
- Windows系统：必须使用Windows 10 1903及以上版本（早期版本缺少关键API支持），建议分配至少20GB磁盘空间
- Linux系统：推荐Ubuntu 20.04 LTS，内核版本5.4+，需要预留15GB空间
- 树莓派：仅支持Raspberry Pi 4B（4GB内存版），需使用64位Raspbian系统
特别注意：在Windows系统上，必须开启"开发者模式"（设置→更新与安全→开发者选项），否则会导致后续的符号链接创建失败。
2.2 基础软件栈
以下是经过验证的必备组件及版本组合：
| 组件名称 | Windows版本 | Linux版本 | 树莓派版本 |
|---|---|---|---|
| Python | 3.8.10 (64-bit) | 3.8.5 (系统自带) | 3.9.2 (手动编译) |
| CMake | 3.22.1 | 3.16.3 | 3.18.4 |
| Git | 2.35.1 | 2.25.1 | 2.30.2 |
| VS B |