Windows 原生 & WSL 安装教程

🚀 Windows 原生安装（推荐新手）

环境准备：确保系统为 Windows 10 及以上，并开启开发者模式。

一键安装：

以管理员身份打开 PowerShell。

执行命令： iwr -useb https://openclaw.ai/install.ps1 | iex  

初始化：安装完成后，执行  openclaw onboard  进行首次配置。

🐧 Windows WSL2 安装（推荐开发者）

启用 WSL：在 PowerShell 中执行  wsl --install ，安装 Ubuntu 发行版。

进入 WSL：打开 Ubuntu 终端。

安装 OpenClaw：

执行命令： curl -fsSL https://openclaw.ai/install.sh | bash  

验证：执行  openclaw --version  查看版本。

⚠️ Windows 常见故障排查

错误：无法执行脚本

原因：PowerShell 执行策略限制。

解决：执行  Set-ExecutionPolicy RemoteSigned -Scope CurrentUser ，输入  Y  确认 。

错误：端口被占用

解决：执行  openclaw gateway restart  重启服务 。

macOS & Linux 安装教程

🍎 macOS 安装

安装 Homebrew（如果未安装）：

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

安装 OpenClaw：

执行： curl -fsSL https://openclaw.ai/install.sh | bash  

验证： openclaw --version 

🐧 Linux 安装（Ubuntu/Debian）

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

安装依赖： sudo apt install -y curl 

安装 OpenClaw：

执行： curl -fsSL https://openclaw.ai/install.sh | bash  

验证： openclaw --version 

⚠️ 常见故障排查

错误：sharp 编译失败

原因：缺少 libvips 依赖。

解决：

macOS： brew install vips 

Linux： sudo apt-get install -y libvips-dev  

阿里云服务器部署教程

☁️ 云服务器环境准备

购买服务器：选择阿里云 ECS，系统建议选择 Ubuntu 22.04 LTS。

安全组配置：开放 18789 端口（Web UI）和 8080 端口（钉钉回调）。

连接服务器：使用 SSH 工具连接。

🚀 一键部署

安装 Docker（推荐容器化部署）：

curl -fsSL https://get.docker.com | bash 

拉取镜像：

docker pull ghcr.io/phioranex/openclaw-docker:latest  

运行容器：

docker run -d --name openclaw -p 18789:18789 ghcr.io/phioranex/openclaw-docker:latest 

⚠️ 云服务器常见故障

错误：外网无法访问 Web UI

解决：检查阿里云安全组是否放行 18789 端口 。

错误：钉钉回调失败

解决：检查服务器公网 IP 是否配置正确，并确保 8080 端口开放 。

Android 安装教程

📱 Android 安装（通过 Termux）

安装 Termux：从 Google Play 或 F-Droid 下载安装。

安装依赖：在 Termux 中执行：

pkg update && pkg upgrade 

pkg install nodejs git 

安装 OpenClaw：

npm install -g openclaw@latest  

启动： openclaw gateway start 

⚠️ Android 注意事项

性能限制：Android 设备性能有限，建议仅用于轻量级任务。

后台保活：需配置 Termux 后台保活，防止进程被系统杀死。