OpenClaw 全平台安装详解：Windows/macOS/Linux 及一键脚本

OpenClaw 全平台安装详解：Windows/macOS/Linux 及一键脚本 | 极客日志

安装 Python (如果尚未安装)：
- 访问 Python 官网下载适用于 Windows 的最新稳定版 Python 3.x 安装程序。
- 运行安装程序。至关重要：在安装向导的第一个页面，务必勾选 Add Python 3.x to PATH 选项。
- 点击 Install Now 开始安装。安装完成后，关闭并重新打开终端（PowerShell 或 CMD）。
验证 Python 安装：
- 打开 PowerShell (以管理员身份运行)。
- 输入以下命令并回车：
```
python --version
pip --version
```
- 如果看到类似 Python 3.10.6 的输出，说明 Python 已正确安装并添加到 PATH。

(可选但推荐) 安装 Chocolatey：

在管理员 PowerShell 中运行以下命令安装 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'))

验证：choco -v

创建项目目录和虚拟环境：
- 创建一个专门存放 OpenClaw 项目的文件夹，例如：
```
mkdir C:\OpenClawProjects
cd C:\OpenClawProjects
```
- 创建虚拟环境 (例如命名为 openclaw-env)：
```
python -m venv openclaw-env
```
激活虚拟环境：
- 在项目目录下，运行：
```
.\openclaw-env\Scripts\Activate.ps1
```
- 激活后，命令提示符前会出现 (openclaw-env) 字样。
安装 OpenClaw：
- 确保虚拟环境已激活。
- 使用 pip 安装 OpenClaw (请替换 [OpenClaw-Package-Name] 为实际的 PyPI 包名或 Git 仓库 URL)：
```
pip install [OpenClaw-Package-Name]
```
验证安装：
- 尝试运行 OpenClaw 的命令行工具：
```
openclaw --version
```
- 如果看到版本号输出，则说明 OpenClaw 已成功安装。
退出虚拟环境：
- 当不再需要在此环境中工作时，运行：
```
deactivate
```

# 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

# 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 (替换为实际的包名或 Git URL)
Write-Host "Installing OpenClaw..."
pip install [OpenClaw-Package-Name]

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

安装 Homebrew (如果尚未安装)：
- 打开 Terminal。
- 粘贴并运行以下命令：
```
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```
- 按照提示完成安装。保存文件使更改生效。
安装 Python (如果尚未安装或版本过低)：
- 使用 Homebrew 安装最新 Python 3：
```
brew install python
```
- 建议将 Homebrew 添加到 PATH（如果安装提示里有说明，按提示操作）。通常需要将以下行添加到 ~/.zshrc 或 ~/.bash_profile 文件末尾：
```
export PATH=/usr/local/bin:$PATH
```

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

mkdir ~/OpenClawProjects
cd ~/OpenClawProjects
python3 -m venv openclaw-env

激活虚拟环境：
```
source openclaw-env/bin/activate
```
激活后，命令提示符前会出现 (openclaw-env) 字样。
安装 OpenClaw：
```
pip install [OpenClaw-Package-Name]
```
验证安装：
```
openclaw --version
```
退出虚拟环境：
```
deactivate
```

#!/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-Package-Name]

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

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

更新系统包索引：
```
sudo apt update && sudo apt upgrade -y
```
安装 Python 3 和 pip：
- 确保已安装 python3-venv 和 python3-pip：
```
sudo apt install python3 python3-venv python3-pip -y
```
安装其他系统依赖：
- 根据 OpenClaw 的要求，可能需要安装开发库。例如：
```
sudo apt install build-essential libssl-dev libffi-dev -y
```
CentOS 差异：
- 更新系统：sudo yum update -y 或 sudo dnf update -y。
- 安装 Python 3：sudo yum install epel-release -y && sudo yum install python3 python3-pip -y。
- 安装开发工具：sudo yum groupinstall "Development Tools" -y。

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

mkdir ~/OpenClawProjects
cd ~/OpenClawProjects
python3 -m venv openclaw-env

激活虚拟环境：
```
source openclaw-env/bin/activate
```
安装 OpenClaw：
```
pip install [OpenClaw-Package-Name]
```
验证安装：
```
openclaw --version
```
退出虚拟环境：
```
deactivate
```

#!/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-Package-Name]

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

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

依赖管理：
- 冻结依赖：在项目开发稳定后，可以生成一个 requirements.txt 文件记录当前所有依赖的精确版本：
```
pip freeze > requirements.txt
```
- 从文件安装：在其他地方重建相同环境时，可以使用：
```
pip install -r requirements.txt
```
更新 OpenClaw：当 OpenClaw 发布新版本时，在激活的虚拟环境中运行：
```
pip install --upgrade [OpenClaw-Package-Name]
```
使用 Docker (可选)：对于更复杂的部署或希望环境完全一致的情况，可以考虑使用 Docker 容器化运行 OpenClaw。这需要编写 Dockerfile。此部分超出本基础安装教程范围，请参考 Docker 文档和 OpenClaw 社区是否有现成的 Docker 镜像。
集成与扩展：探索如何编写自定义模块、插件，或者如何将 OpenClaw 集成到你的 CI/CD 流程、与其他系统交互。

OpenClaw 全平台安装详解：Windows/macOS/Linux 及一键脚本

OpenClaw 全平台安装详解

引言

重要提示与准备工作

第一部分：Windows 10/11 安装指南

方法一：手动安装

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

第二部分：macOS 安装指南

方法一：手动安装

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

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

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

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

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

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

第六部分：安全最佳实践

结语

更多推荐文章

相关免费在线工具

OpenClaw 全平台安装详解：Windows/macOS/Linux 及一键脚本

OpenClaw 全平台安装详解

引言

重要提示与准备工作

第一部分：Windows 10/11 安装指南

方法一：手动安装

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

第二部分：macOS 安装指南

方法一：手动安装

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

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

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

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

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

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

第六部分：安全最佳实践

结语

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具