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

macOS 安装方案

方法一：手动安装

1. 安装 Homebrew 打开终端执行：

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

   按提示完成安装后，刷新环境变量：

   source ~/.zshrc
   

2. 安装 Python 3

   brew install python
   

3. 配置虚拟环境

   mkdir ~/OpenClawProjects
   

cd ~/OpenClawProjects python3 -m venv openclaw-env source openclaw-env/bin/activate

4.  **安装与验证**
    ```bash
    pip install [OpenClaw-Package-Name]
    openclaw --version
    ```

#### 方法二：一键安装脚本

将以下内容保存为 `install_openclaw_mac.sh`，赋予执行权限后运行：

```bash
#!/bin/bash
# install_openclaw_mac.sh

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
    echo "正在安装 Python 3..."
    brew install python
fi

project_dir="$HOME/OpenClawProjects"
mkdir -p "$project_dir"
cd "$project_dir" || exit

python3 -m venv openclaw-env
source openclaw-env/bin/activate
pip install --upgrade pip
pip install [OpenClaw-Package-Name]
echo "安装完成！"

Linux (Ubuntu/CentOS) 安装方案

方法一：手动安装

以 Ubuntu 为例，CentOS 用户需注意包管理器差异（apt vs yum/dnf）。

1. 更新系统与依赖

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

2. 创建环境与安装

   mkdir ~/OpenClawProjects
   

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

3.  **验证**
    ```bash
    openclaw --version
    ```

#### 方法二：一键安装脚本

适用于 Ubuntu/Debian 的 Bash 脚本 `install_openclaw_linux.sh`：

```bash
#!/bin/bash
# install_openclaw_linux.sh

echo "更新系统包索引..."
sudo apt update && sudo apt upgrade -y

echo "安装 Python 及开发依赖..."
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

python3 -m venv openclaw-env
source openclaw-env/bin/activate
pip install --upgrade pip
pip install [OpenClaw-Package-Name]

echo "安装完成！"

通用维护与安全建议

无论使用何种平台，以下习惯能显著提升稳定性：

1. 虚拟环境管理：每次使用前先激活环境 (source ... 或 .\Scripts\Activate)，不再使用时运行 deactivate。这能有效隔离不同项目的依赖冲突。
2. 配置文件安全：API 密钥、数据库密码等敏感信息严禁硬编码。请使用环境变量或专门的配置中心管理。
3. 依赖冻结：项目稳定后，生成 requirements.txt 以便复现环境：

   pip freeze > requirements.txt
   

4. 故障排查：
   • 若遇 command not found，检查虚拟环境是否激活。
   • 若 pip install 报错缺少库，通常需安装系统级开发包（如 libssl-dev）。
   • 查看日志文件获取详细错误堆栈。

通过上述步骤，你应该能在任意主流系统上顺利运行 OpenClaw。遇到具体问题，建议优先查阅官方文档或社区 Issue 列表。