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

方案二：一键安装脚本

为了简化流程，可以使用 PowerShell 脚本自动完成上述步骤。使用前请仔细阅读脚本内容。

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

# 1. 检查 Python
if (-not (Get-Command python -ErrorAction SilentlyContinue)) {
    Write-Host "未检测到 Python，正在尝试安装..."
    # 此处省略具体下载逻辑，实际使用时请指向稳定版安装包 URL
    exit
}

# 2. 创建目录与虚拟环境
$projectDir = "C:\OpenClawProjects"
New-Item -Path $projectDir -ItemType Directory -Force | Out-Null
Set-Location $projectDir

if (-not (Test-Path "openclaw-env")) {
    python -m venv openclaw-env
}

# 3. 激活并安装
Write-Host "激活虚拟环境..."
.\openclaw-env\Scripts\Activate.ps1
Write-Host "正在安装 OpenClaw..."
pip install [OpenClaw-Package-Name]

Write-Host "安装完成！请使用 'openclaw --version' 验证。"

macOS 安装指南

方案一：手动安装

1. 安装 Homebrew

Homebrew 是 macOS 的必备包管理器。在终端执行：

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

安装完成后，按提示将 Homebrew 添加到环境变量（通常会自动处理）。

2. 安装 Python 3

macOS 默认可能带有旧版 Python，建议使用 Homebrew 安装最新版：

brew install python

3. 配置虚拟环境

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

4. 安装与验证

pip install [OpenClaw-Package-Name]
openclaw --version

方案二：一键安装脚本

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

#!/bin/bash
# install_openclaw_mac.sh

# 检查 Homebrew
if ! command -v brew &> /dev/null; then
    echo "正在安装 Homebrew..."
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
fi

# 检查 Python
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

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
./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

CentOS 用户请参考对应文档安装 epel-release 并使用 yum 或 dnf。

2. 配置环境

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

3. 安装与验证

pip install [OpenClaw-Package-Name]
openclaw --version

方案二：一键安装脚本

适用于 Ubuntu/Debian 的 Bash 脚本：

#!/bin/bash
# install_openclaw_linux.sh

# 更新系统
sudo apt update && sudo apt upgrade -y

# 安装依赖
sudo apt install python3 python3-venv python3-pip -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 --upgrade pip
pip install [OpenClaw-Package-Name]

echo "安装完成！"

通用配置与故障排除

无论使用哪种平台，安装后的通用维护步骤如下：

1. 虚拟环境管理：每次使用 OpenClaw 前，记得进入项目目录并激活虚拟环境 (source ... 或 .\Scripts\Activate.ps1)。
2. 配置文件：根据官方文档，在项目根目录创建 config.yml 或 .env 文件，配置 API 密钥等敏感信息。切勿将密钥硬编码到代码中。
3. 常见问题：
   • 依赖安装失败：通常是缺少系统级开发库（如 libssl-dev），请根据报错信息使用系统包管理器补充。
   • 命令未找到：检查虚拟环境是否激活，确认 bin 或 Scripts 目录是否在 PATH 中。
   • 版本冲突：虚拟环境的主要作用就是隔离依赖，新建环境通常能解决大部分问题。

安全最佳实践

• 谨慎使用 sudo：仅在必要时提权，运行脚本前务必检查内容。
• 凭证保护：敏感信息使用环境变量或密钥管理服务，不要提交到公共仓库。
• 定期更新：保持系统和依赖包的更新，及时修复安全漏洞。

通过本指南，你应该已经成功搭建了 OpenClaw 的运行环境。接下来可以查阅官方文档探索更多高级功能。如果在过程中遇到具体问题，建议优先查看错误日志或社区 Issue 列表。