OpenClaw 一站式安装部署教程

一、安装前准备（5 分钟）

1. 环境检查：确保设备满足基础要求 ——CPU 支持 x86/ARM 架构（如 Intel i5/Apple M1 及以上）、内存 ≥8GB（推荐 16GB+）、空闲磁盘空间 ≥20GB（用于存储模型与运行文件）。
2. 依赖安装：OpenClaw 基于 Python 运行，需先安装 Python 3.9-3.11 版本（不建议 3.12+，存在兼容性问题）：
   • Windows/macOS：访问 Python 官网 下载对应安装包，安装时勾选「Add Python to PATH」。
   • Linux：执行命令 sudo apt update && sudo apt install python3.10 python3.10-pip（Ubuntu/Debian）或 yum install python3.10 python3.10-pip（CentOS）。
3. 验证依赖：打开终端 / 命令提示符，输入 python --version（Windows）或 python3 --version（macOS/Linux），显示 3.9-3.11 版本即表示成功。

二、核心安装步骤（10 分钟）

方式 1：一键脚本安装（推荐新手）

1. 下载安装脚本：
   • Windows：打开命令提示符，执行 curl -o install_openclaw.bat https://openclaw.ai/scripts/install_win.bat/?utm_source=llbk.cn。
   • macOS/Linux：打开终端，执行 curl -o install_openclaw.sh https://openclaw.ai/scripts/install_unix.sh/?utm_source=llbk.cn && chmod +x install_openclaw.sh。
2. 运行脚本：
   • Windows：双击 install_openclaw.bat，等待自动完成环境配置、依赖下载与主程序安装。
   • macOS/Linux：执行 ./install_openclaw.sh，期间输入系统密码（Linux）即可，脚本会自动处理权限问题。
3. 验证安装：脚本运行完成后，输入 openclaw --version，显示版本号（如 v1.8.0）即表示主程序安装成功。

方式 2：手动安装（适配自定义需求）

1. 克隆代码仓库：终端 / 命令提示符执行 git clone https://github.com/openclaw/openclaw.git/?utm_source=llbk.cn，若无 Git 环境，先执行 pip install git（Windows）或 sudo apt install git（Linux）。
2. 进入项目目录：执行 cd openclaw，然后安装依赖包：pip install -r requirements.txt（Windows）或 pip3 install -r requirements.txt（macOS/Linux）。
3. 初始化配置：执行 python main.py init（Windows）或 python3 main.py init，自动生成配置文件与默认模型存储路径。

三、模型配置（关键步骤）

1. 选择模型类型：OpenClaw 支持本地模型与远程 API 调用，新手推荐先试用轻量本地模型：
   • 执行 openclaw model list 查看适配模型列表，选择「Qwen-7B-Chat」（70 亿参数，适配 8GB 内存）。
   • 执行 openclaw model download Qwen-7B-Chat，自动下载模型至默认路径（Windows：C:\Users\ 用户名.openclaw\models；macOS/Linux：~/.openclaw/models）。
2. 模型验证：下载完成后，执行 openclaw model test，显示「Model load success」即表示模型配置完成。

四、启动与验证（2 分钟）

1. 启动 OpenClaw：终端 / 命令提示符执行 openclaw start，等待 30 秒左右，界面显示「OpenClaw service running on http://127.0.0.1:8000」即启动成功。
2. 访问界面：打开浏览器，输入 http://127.0.0.1:8000，进入 OpenClaw 可视化控制台，可直接体验智能问答、代码生成等核心功能。
3. 基础测试：在控制台输入「帮我写一段 Python 求素数的代码」，若能快速返回正确代码并附带解释，说明部署完全成功。

五、常见问题解决

1. 安装失败：若提示「pip 版本过低」，执行 python -m pip install --upgrade pip 升级 pip 后重新安装。
2. 模型下载慢：可手动下载模型至指定路径，参考 OpenClaw 模型仓库 的镜像地址。
3. 启动端口被占用：执行 openclaw start --port 8080 切换端口（如 8080），访问时对应输入 http://127.0.0.1:8080。

总结