OpenClaw 全平台安装指南：Windows/macOS/Linux 一键脚本

• 打开 PowerShell (以管理员身份运行)。
• 输入以下命令并回车：

  python --version
  pip --version
  

• 如果看到类似 Python 3.10.6 的输出，说明 Python 已正确安装并添加到 PATH。

方法二：一键安装脚本 (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
    [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072
    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 # 安装常用 VC++ 运行库

# 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."

使用方法：

1. 将上面的脚本代码保存到一个文本文件中，命名为 install_openclaw_win.ps1。
2. 右键点击该文件，选择 使用 PowerShell 运行。
3. 如果系统提示执行策略，请按提示允许脚本运行。
4. 脚本将自动执行上述手动步骤。注意：脚本中可能需要你重启终端一次（在安装 Python 后），然后再次运行脚本完成剩余步骤。

第二部分：macOS 安装指南

方法一：手动安装 (详细步骤)

1. 安装 Homebrew (如果尚未安装)：
   • Homebrew 是 macOS 不可或缺的包管理器。打开 Terminal。
   • 粘贴并运行以下命令：

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

   • 按照提示完成安装（可能需要输入登录密码）。
   • 安装完成后，运行 brew doctor 检查状态。
   • 保存文件使更改生效，通常需要将以下行添加到 ~/.zshrc 或 ~/.bash_profile 文件末尾：

     export PATH=/usr/local/bin:$PATH
     

2. 安装 Python (如果尚未安装或版本过低)：
   • 使用 Homebrew 安装最新 Python 3：

     brew install python
     

   • 验证：

     python3 --version
     pip3 --version
     

3. 创建项目目录和虚拟环境：
   • 创建目录并进入：

     mkdir ~/OpenClawProjects
     cd ~/OpenClawProjects
     

   • 创建虚拟环境：

     python3 -m venv openclaw-env
     

   • 激活虚拟环境：

     source openclaw-env/bin/activate
     

   • 激活后，命令提示符前会出现 (openclaw-env) 字样。
4. 安装 OpenClaw：
   • 确保虚拟环境已激活。
   • 使用 pip 安装 OpenClaw：

     pip install openclaw
     

5. 验证安装：
   • 尝试运行：

     openclaw --version
     

6. 退出虚拟环境：
   • 当不再需要在此环境中工作时，运行：

     deactivate
     

方法二：一键安装脚本 (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."

使用方法：

1. 将上面的脚本代码保存到一个文本文件中，命名为 install_openclaw_mac.sh。
2. 给脚本添加执行权限：

   chmod +x install_openclaw_mac.sh
   

3. 在终端中，导航到脚本所在目录并运行：

   ./install_openclaw_mac.sh
   

4. 仔细阅读脚本中的输出信息。可能需要输入密码授权 Homebrew 安装。

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

方法一：手动安装 (详细步骤 - 以 Ubuntu 为例)

1. 更新系统包索引：

   sudo apt update && sudo apt upgrade -y
   

2. 安装 Python 3 和 pip：
   • 确保已安装 python3-venv 和 python3-pip：

     sudo apt install python3 python3-venv python3-pip -y
     

   • 验证：

     python3 --version
     pip3 --version
     

3. 安装其他系统依赖：根据 OpenClaw 的要求，可能需要安装开发库。例如：

   sudo apt install build-essential libssl-dev libffi-dev -y
   

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

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

5. 安装 OpenClaw：

   pip install openclaw
   

6. 验证安装：

   openclaw --version
   

7. 退出虚拟环境：

   deactivate
   

CentOS 差异：

• 更新系统：sudo yum update -y 或 sudo dnf update -y (CentOS 8+)。
• 安装 Python 3：
  • CentOS 8: sudo dnf install python3 python3-pip -y
• 安装开发工具：sudo yum groupinstall "Development Tools" -y 或 sudo dnf groupinstall "Development Tools" -y。安装 openssl-devel, libffi-devel。
• CentOS 7: 默认 Python 2.7。需安装 Python 3:

  sudo yum install epel-release -y
  sudo yum install python3 python3-pip -y
  

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

以下是 Bash 脚本 (install_openclaw_linux.sh)，适用于 Ubuntu/Debian。CentOS 用户需要修改包管理命令 (apt 换成 yum 或 dnf) 和包名。

#!/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."

使用方法：

1. 将脚本保存为 install_openclaw_linux.sh。
2. 赋予执行权限：chmod +x install_openclaw_linux.sh
3. 运行脚本：./install_openclaw_linux.sh
4. 仔细阅读输出信息，可能需要输入 sudo 密码。

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

无论使用哪种方法或平台安装，以下是一些通用的后续步骤和验证方法：

1. 理解虚拟环境：每次想要使用 OpenClaw 时，都需要先导航到你的项目目录 (~/OpenClawProjects 或 C:\OpenClawProjects)，并激活虚拟环境 (source openclaw-env/bin/activate 或 .\\openclaw-env\\Scripts\\Activate.ps1)。退出时用 deactivate。这确保了你的 OpenClaw 环境是隔离的。
2. 配置文件 (如果有)：OpenClaw 可能需要一个配置文件 (如 config.yml, .env 文件) 来设置 API 密钥、数据库连接、代理等参数。请查阅 OpenClaw 的官方文档，了解如何配置。通常这个文件会放在项目根目录下。
3. 运行示例/测试：
   • 查阅 OpenClaw 的文档或示例库，找一个简单的示例脚本或任务。
   • 在激活的虚拟环境中运行它，观察输出是否符合预期。
   • 例如：openclaw run example_task.yaml (假设 OpenClaw 有这样的命令)。
4. 故障排除：
   • 依赖安装失败：最常见的问题是缺少系统级开发库（如 Linux 上的 libssl-dev）。查看 pip install 的错误信息，它通常会提示缺少哪个头文件或库。根据提示使用系统的包管理器安装对应的开发包。
   • 命令未找到 (openclaw: command not found)：
     • 确保虚拟环境已正确激活（提示符前有 (openclaw-env)）。
     • 尝试在激活的环境中使用 pip show openclaw 查看安装路径，确认可执行文件是否在 bin (或 Scripts) 目录下。
   • 版本冲突：虚拟环境的主要目的就是解决这个问题。如果在一个项目中出现冲突，尝试创建一个新的干净虚拟环境重新安装。
   • 检查日志：OpenClaw 运行出错时，查看其生成的日志文件（位置通常在文档中有说明）以获取更详细的错误信息。

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

1. 依赖管理：
   • 冻结依赖：在项目开发稳定后，可以生成一个 requirements.txt 文件记录当前所有依赖的精确版本：

     pip freeze > requirements.txt
     

   • 从文件安装：在其他地方重建相同环境时，可以使用：

     pip install -r requirements.txt
     

2. 使用 Docker (可选)：对于更复杂的部署或希望环境完全一致的情况，可以考虑使用 Docker 容器化运行 OpenClaw。这需要编写 Dockerfile。此部分超出本基础安装教程范围，请参考 Docker 文档和 OpenClaw 社区是否有现成的 Docker 镜像。
3. 集成与扩展：OpenClaw 的强大之处在于其可扩展性。探索如何编写自定义模块、插件，或者如何将 OpenClaw 集成到你的 CI/CD 流程、与其他系统（如消息队列、数据库）交互。
4. 更新 OpenClaw：当 OpenClaw 发布新版本时，在激活的虚拟环境中运行：

   pip install --upgrade openclaw
   

第六部分：安全最佳实践

1. 谨慎使用 sudo：仅在必要时使用 sudo，尤其是在运行来源不明的脚本时。理解脚本中每一条 sudo 命令的作用。
2. 检查脚本：运行任何一键脚本前，请务必打开并检查其内容，确保没有恶意操作。本教程提供的脚本是示例，实际操作前请确认其安全性和适用性。
3. 保护凭证：配置文件中的 API 密钥、数据库密码等敏感信息，绝不要直接硬编码或提交到公开的代码仓库。使用环境变量或安全的密钥管理服务。
4. 定期更新：保持操作系统、Python、OpenClaw 及其依赖项的更新，以获取安全补丁和新功能。

结语

通过本教程，您应该已经成功地在 Windows 10/11、macOS 或 Linux 系统上安装了 OpenClaw，并掌握了使用虚拟环境管理项目依赖的基本方法。附带的一键脚本旨在为新手提供便利，但理解其背后的手动步骤对于深入理解和故障排除至关重要。现在，您可以开始探索 OpenClaw 的强大功能了！请务必参考其官方文档和社区资源以获取更深入的使用指南和示例。如果在安装或使用过程中遇到问题，请检查错误信息、查阅文档，或在相关的社区论坛（如 GitHub Issues, Discord, Stack Overflow 等）寻求帮助。祝您使用愉快！