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

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

为了简化流程，提供 PowerShell 脚本 install_openclaw_win.ps1。使用前请仔细阅读代码内容。

# install_openclaw_win.ps1
# 请以管理员身份运行此 PowerShell 脚本

# 1. 检查并安装 Python (如果未安装)
if (-not (Get-Command python -ErrorAction SilentlyContinue)) {
    Write-Host "Python not found. Installing Python 3.10..."
    $pythonInstaller = "https://www.python.org/ftp/python/3.10.11/python-3.10.11-amd64.exe"
    $installerPath = "$env:TEMP\python_installer.exe"
    Invoke-WebRequest -Uri $pythonInstaller -OutFile $installerPath
    Start-Process -FilePath $installerPath -ArgumentList "/quiet InstallAllUsers=1 PrependPath=1" -Wait
    Remove-Item -Path $installerPath
    Write-Host "Python installed. Please restart your terminal and run the script again." -ForegroundColor Yellow
    exit
}

# 2. 检查并安装 Chocolatey (如果未安装)
if (-not (Get-Command choco -ErrorAction SilentlyContinue)) {
    Write-Host "Installing Chocolatey..."
    Set-ExecutionPolicy Bypass -Scope Process -Force
    iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
    Write-Host "Chocolatey installed."
}

# 3. 安装常用依赖
Write-Host "Installing common dependencies via Chocolatey..."
choco install git -y
choco install vcredist-all -y

# 4. 创建项目目录
$projectDir = "C:\OpenClawProjects"
if (-not (Test-Path $projectDir)) { New-Item -Path $projectDir -ItemType Directory }
Set-Location $projectDir

# 5. 创建并激活虚拟环境
$venvName = "openclaw-env"
if (-not (Test-Path "$projectDir\$venvName")) { python -m venv $venvName }
Write-Host "Activating virtual environment..."
.\$venvName\Scripts\Activate.ps1

# 6. 安装 OpenClaw
Write-Host "Installing OpenClaw..."
pip install openclaw

# 7. 验证安装
Write-Host "Verifying installation..."
openclaw --version

# 8. 提示
Write-Host "OpenClaw installation completed successfully!" -ForegroundColor Green
Write-Host "Virtual environment '$venvName' is active. Use 'deactivate' to exit."

使用方法：保存为 .ps1 文件，右键选择'使用 PowerShell 运行'。如遇执行策略限制，可临时运行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser。

第二部分：macOS 安装指南

方法一：手动安装

1. 安装 Homebrew：

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

   安装完成后，按提示将 Homebrew 添加到 PATH（通常编辑 ~/.zshrc 或 ~/.bash_profile）。

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)

以下是 Bash 脚本 install_openclaw_mac.sh：

#!/bin/bash
# install_openclaw_mac.sh

# 1. 检查并安装 Homebrew
if ! command -v brew &> /dev/null; then
    echo "Installing Homebrew..."
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
    echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
    eval "$(/opt/homebrew/bin/brew shellenv)"
fi

# 2. 检查并安装 Python 3
if ! command -v python3 &> /dev/null; then
    echo "Installing Python 3 via Homebrew..."
    brew install python
fi

# 3. 创建项目目录
project_dir="$HOME/OpenClawProjects"
mkdir -p "$project_dir"
cd "$project_dir" || exit

# 4. 创建并激活虚拟环境
venv_name="openclaw-env"
if [ ! -d "$venv_name" ]; then
    python3 -m venv "$venv_name"
fi
echo "Activating virtual environment..."
source "$venv_name/bin/activate"

# 5. 安装 OpenClaw
echo "Installing OpenClaw..."
pip install openclaw

# 6. 验证安装
echo "Verifying installation..."
openclaw --version

# 7. 提示
echo "OpenClaw installation completed successfully!"
echo "Virtual environment '$venv_name' is active. Use 'deactivate' to exit."

使用方法：赋予执行权限 chmod +x install_openclaw_mac.sh 后运行 ./install_openclaw_mac.sh。

第三部分：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
   

CentOS 差异：

• CentOS 7 默认 Python 2.7，需安装 Python 3：sudo yum install epel-release -y && sudo yum install python3 python3-pip -y。
• CentOS 8+ 使用 dnf：sudo dnf install python3 python3-pip -y。

方法二：一键安装脚本 (Linux - Ubuntu/Debian)

#!/bin/bash
# install_openclaw_linux.sh (For Ubuntu/Debian)

# 1. 更新系统
echo "Updating system packages..."
sudo apt update && sudo apt upgrade -y

# 2. 安装 Python 3, venv, pip 和常用依赖
echo "Installing Python 3 and dependencies..."
sudo apt install python3 python3-venv python3-pip build-essential libssl-dev libffi-dev -y

# 3. 创建项目目录
project_dir="$HOME/OpenClawProjects"
mkdir -p "$project_dir"
cd "$project_dir" || exit

# 4. 创建并激活虚拟环境
venv_name="openclaw-env"
if [ ! -d "$venv_name" ]; then
    python3 -m venv "$venv_name"
fi
echo "Activating virtual environment..."
source "$venv_name/bin/activate"

# 5. 升级 pip (可选但推荐)
pip install --upgrade pip

# 6. 安装 OpenClaw
echo "Installing OpenClaw..."
pip install openclaw

# 7. 验证安装
echo "Verifying installation..."
openclaw --version

# 8. 提示
echo "OpenClaw installation completed successfully!"
echo "Virtual environment '$venv_name' is active. Use 'deactivate' to exit."

使用方法：保存为 install_openclaw_linux.sh，赋予权限 chmod +x install_openclaw_linux.sh 后运行 ./install_openclaw_linux.sh。

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

无论使用哪种方法，以下后续步骤同样适用：

1. 理解虚拟环境：每次使用 OpenClaw 前，需导航至项目目录并激活虚拟环境。退出时使用 deactivate。
2. 配置文件：OpenClaw 可能需要 config.yml 或 .env 文件来设置 API 密钥等参数，请查阅官方文档。
3. 运行示例：在激活环境中运行简单示例脚本，观察输出是否符合预期。
4. 故障排除：
   • 依赖安装失败：常见于缺少系统级开发库（如 Linux 上的 libssl-dev），根据 pip install 错误信息安装对应开发包。
   • 命令未找到：确保虚拟环境已激活，检查 pip show 查看安装路径。
   • 版本冲突：尝试创建新的干净虚拟环境重新安装。

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

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. 检查脚本：运行一键脚本前，务必打开检查内容，确保无恶意操作。
3. 保护凭证：配置文件中的敏感信息（API 密钥、密码）绝不要硬编码或提交到公开仓库，建议使用环境变量。
4. 定期更新：保持操作系统、Python 及依赖项更新，获取安全补丁。

通过本教程，您应该已经成功在目标系统上安装了 OpenClaw。现在可以开始探索其功能了！如有问题，请检查错误信息、查阅文档或在社区论坛寻求帮助。