OpenClaw 跨平台安装指南：Windows、macOS 与 Linux 环境配置

macOS 安装

手动安装步骤

1. 安装 Homebrew 作为 macOS 核心包管理器，Homebrew 能简化依赖管理。若未安装，可通过终端执行官方安装脚本。

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. 配置 Python macOS 通常预装旧版 Python，建议通过 Homebrew 安装最新版。

brew install python

3. 环境与安装 后续步骤与 Windows 类似，注意激活命令使用 source。

mkdir ~/OpenClawProjects
cd ~/OpenClawProjects
python3 -m venv openclaw-env
source openclaw-env/bin/activate
pip install [OpenClaw-Package-Name]

一键安装脚本

保存为 install_openclaw_mac.sh 并赋予执行权限：

#!/bin/bash
if ! command -v brew &> /dev/null; then
    echo "正在安装 Homebrew..."
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
fi
if ! command -v python3 &> /dev/null; then
    brew install python
fi
project_dir="$HOME/OpenClawProjects"
mkdir -p "$project_dir"
cd "$project_dir" || exit
if [ ! -d "openclaw-env" ]; then
    python3 -m venv openclaw-env
fi
source openclaw-env/bin/activate
pip install [OpenClaw-Package-Name]
echo "安装成功"

运行前请执行 chmod +x install_openclaw_mac.sh。

Linux (Ubuntu/CentOS) 安装

手动安装步骤

1. 更新系统与依赖 Ubuntu/Debian 用户可使用 apt，CentOS/RHEL 用户使用 yum 或 dnf。

# Ubuntu/Debian
sudo apt update && sudo apt upgrade -y
sudo apt install python3 python3-venv python3-pip build-essential libssl-dev libffi-dev -y

# CentOS 8+
sudo dnf update -y
sudo dnf install python3 python3-pip -y

2. 创建项目与虚拟环境

mkdir ~/OpenClawProjects
cd ~/OpenClawProjects
python3 -m venv openclaw-env
source openclaw-env/bin/activate
pip install [OpenClaw-Package-Name]

一键安装脚本

适用于 Ubuntu/Debian，保存为 install_openclaw_linux.sh：

#!/bin/bash
sudo apt update && sudo apt upgrade -y
sudo apt install python3 python3-venv python3-pip build-essential libssl-dev libffi-dev -y
project_dir="$HOME/OpenClawProjects"
mkdir -p "$project_dir"
cd "$project_dir" || exit
if [ ! -d "openclaw-env" ]; then
    python3 -m venv openclaw-env
fi
source openclaw-env/bin/activate
pip install [OpenClaw-Package-Name]
echo "安装完成"

通用配置与故障排查

无论使用何种平台，以下注意事项有助于稳定运行：

• 虚拟环境管理：每次使用前需激活环境 (source ... 或 .\Scripts\Activate.ps1)，退出时使用 deactivate。这能确保依赖隔离。
• 配置文件：OpenClaw 可能依赖 config.yml 或环境变量设置密钥。请勿将敏感信息硬编码至代码中。
• 常见错误处理：
  • 依赖安装失败：通常缺少系统级开发库（如 libssl-dev）。根据报错信息补充对应包。
  • 命令未找到：检查是否激活了虚拟环境，确认 pip show [Package] 中的可执行文件路径是否在 $PATH 中。
  • 版本冲突：清理虚拟环境重新创建是解决冲突最直接的方法。

安全与维护

• 脚本审查：运行任何自动化脚本前，建议先查看其内容，确保无恶意操作。
• 定期更新：使用 pip install --upgrade [Package] 保持组件最新，及时修复安全漏洞。
• 凭证保护：API 密钥等敏感信息应通过环境变量或密钥管理服务注入，避免提交至公共仓库。

通过以上步骤，您应已完成 OpenClaw 的基础环境搭建。后续可参考官方文档探索高级功能，如自定义模块编写或 CI/CD 集成。如遇问题，优先查阅日志文件或社区 Issue 列表。