OpenClaw安装前必须配置五大依赖：一、Python 3.8–3.11运行时；二、CUDA Toolkit（GPU加速可选）；三、系统级FFmpeg路径；四、libusb与udev规则（Linux设备直连必需）；五、CMake 3.16+及构建工具链。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您计划安装OpenClaw工具，但系统缺少必要的运行支撑组件，则可能在初始化或执行阶段报错退出。以下是完成OpenClaw安装前必须配置的依赖环境步骤：
一、安装Python 3.8–3.11运行时
OpenClaw基于Python开发，仅兼容CPython 3.8至3.11版本，不支持3.12及以上或PyPy等替代实现。需确保系统中存在满足版本范围的解释器且已加入PATH。
1、访问python.org/downloads，下载对应操作系统的Python 3.8–3.11安装包。
2、Windows用户勾选“Add Python to PATH”后完成安装；Linux/macOS用户执行./configure --enable-optimizations && make -j$(nproc) && sudo make altinstall避免覆盖系统默认Python。
3、终端输入python3 --version验证输出为3.8.x至3.11.x之间的版本号。
二、安装CUDA Toolkit（GPU加速可选依赖）
若需启用OpenClaw的GPU加速功能，必须安装与显卡驱动兼容的CUDA Toolkit。CPU模式下此步可跳过，但部分模块将无法加载。
1、运行nvidia-smi查看当前驱动支持的最高CUDA版本（右上角“CUDA Version”字段）。
2、前往CUDA Toolkit Archive，下载该版本对应的完整安装包（非patch版本）。
3、Linux用户执行sudo sh cuda_<em>version</em>_linux.run --silent --override；Windows用户运行exe安装程序并勾选CUDA toolkit与cuDNN（如需）。
4、验证安装：nvcc --version应返回匹配的编译器版本。
三、配置FFmpeg系统级可执行路径
OpenClaw依赖FFmpeg处理音视频流，要求ffmpeg命令可在任意目录下直接调用，而非仅通过Python包内嵌副本。
1、从ffmpeg.org/download获取静态编译版二进制文件（ffmpeg、ffprobe、ffplay）。
2、将解压后的ffmpeg可执行文件所在目录添加至系统PATH环境变量：Windows在“系统属性→高级→环境变量”中编辑Path；Linux/macOS在~/.bashrc或~/.zshrc末尾追加export PATH="/path/to/ffmpeg:$PATH"并执行source。
3、终端执行ffmpeg -version，确认输出含“ffmpeg version”且无“command not found”提示。
四、安装libusb与udev规则（Linux设备直连必需）
当OpenClaw需直接访问USB设备（如硬件抓包器、定制探针）时，必须安装libusb库并配置udev权限规则，否则设备打开失败。
1、Ubuntu/Debian系执行：sudo apt update && sudo apt install libusb-1.0-0-dev libudev-dev。
2、CentOS/RHEL系执行：sudo yum install libusbx-devel systemd-devel或sudo dnf install libusb1-devel systemd-devel。
3、创建udev规则文件：sudo nano /etc/udev/rules.d/99-openclaw.rules，写入SUBSYSTEM=="usb", MODE="0664", GROUP="plugdev"（若无plugdev组则先sudo groupadd plugdev并sudo usermod -aG plugdev $USER）。
4、重载规则：sudo udevadm control --reload-rules && sudo udevadm trigger，拔插设备后检查lsusb是否可见且无权限拒绝提示。
五、安装CMake 3.16+与构建工具链
OpenClaw部分扩展模块（如自定义协议解析器）需本地编译，依赖CMake生成构建系统及底层编译器支持。
1、Windows用户下载CMake官方安装包，勾选“Add CMake to system PATH”选项。
2、macOS用户执行：brew install cmake（需提前安装Homebrew）。
3、Linux用户从源码编译：下载cmake-version.tar.gz，解压后进入目录执行./bootstrap && make -j$(nproc) && sudo make install。
4、验证：cmake --version输出不低于3.16；同时确保gcc --version或clang --version可用（Ubuntu需sudo apt install build-essential）。
