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

第二部分：macOS 安装指南

方法一：手动安装

1. 安装 Homebrew (如果尚未安装)：

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

2. 安装 Python 3：

   brew install python
   

3. 创建项目目录和虚拟环境：

   mkdir ~/OpenClawProjects
   

cd ~/OpenClawProjects python3 -m venv openclaw-env

4. **激活虚拟环境**：
```bash
source openclaw-env/bin/activate

5. 安装 OpenClaw：

   pip install openclaw
   

6. 验证安装：

   openclaw --version
   

方法二：一键安装脚本 (macOS)

保存以下代码为 install_openclaw_mac.sh，赋予执行权限后运行。

#!/bin/bash
# install_openclaw_mac.sh
if ! command -v python3 &> /dev/null; then
    echo "Installing Python 3 via Homebrew..."
    brew install python
fi
project_dir="$HOME/OpenClawProjects"
mkdir -p "$project_dir"
cd "$project_dir" || exit
venv_name="openclaw-env"
if [ ! -d "$venv_name" ]; then python3 -m venv "$venv_name" fi
echo "Activating virtual environment..."
source "$venv_name/bin/activate"
echo "Installing OpenClaw..."
pip install openclaw
echo "Verifying installation..."
openclaw --version
echo "Installation completed successfully!"

第三部分：Linux (Ubuntu/CentOS) 安装指南

方法一：手动安装 (以 Ubuntu 为例)

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

3. **激活虚拟环境**：
```bash
source openclaw-env/bin/activate

4. 安装 OpenClaw：

   pip install openclaw
   

5. 验证安装：

   openclaw --version
   

方法二：一键安装脚本 (Linux)

保存以下代码为 install_openclaw_linux.sh，赋予执行权限后运行。

#!/bin/bash
# install_openclaw_linux.sh (For Ubuntu/Debian)
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
venv_name="openclaw-env"
if [ ! -d "$venv_name" ]; then python3 -m venv "$venv_name" fi
echo "Activating virtual environment..."
source "$venv_name/bin/activate"
pip install --upgrade pip
echo "Installing OpenClaw..."
pip install openclaw
echo "Verifying installation..."
openclaw --version
echo "Installation completed successfully!"

第四部分：通用配置与验证

1. 理解虚拟环境：每次使用 OpenClaw 时，需先导航到项目目录并激活虚拟环境 (source openclaw-env/bin/activate 或 . openclaw-env\Scripts\Activate.ps1)。退出时用 deactivate。
2. 配置文件：查阅官方文档了解如何配置 API 密钥、数据库连接等参数（如 config.yml, .env）。
3. 故障排除：
   • 依赖安装失败：查看错误信息，通常缺少系统级开发库（如 libssl-dev），使用系统包管理器安装。
   • 命令未找到：确保虚拟环境已激活，检查可执行文件是否在 bin 或 Scripts 目录下。
   • 版本冲突：尝试创建新的干净虚拟环境重新安装。

第五部分：进阶使用与维护

1. 依赖管理：
   • 生成 requirements.txt：pip freeze > requirements.txt
   • 从文件安装：pip install -r requirements.txt
2. 更新 OpenClaw：在激活的虚拟环境中运行 pip install --upgrade openclaw。
3. Docker 部署：对于复杂部署，可参考 Docker 文档编写 Dockerfile。

第六部分：安全最佳实践

1. 谨慎使用 sudo：仅在必要时使用，确保理解脚本内容。
2. 保护凭证：敏感信息（API 密钥、密码）不要硬编码，使用环境变量或密钥管理服务。
3. 定期更新：保持操作系统、Python 及依赖项更新以获取安全补丁。