OpenClaw(小龙虾)本地部署保姆级教程 | 小白快速上手指南(2026)

0 阅读3分钟

本文为 2026 年 4 月最新版 OpenClaw 本地部署教程,全程无夸大表述,严格遵循平台规范,新手可在 10 分钟内完成部署。

📌 前言

OpenClaw(业内昵称 “小龙虾 AI”)是奥地利开发者 Peter Steinberger 于 2025 年 11 月推出的开源 AI 项目,因轻量化、易扩展的特性,成为 2026 年开发者关注的本地部署工具。本文聚焦小白友好的本地部署流程,覆盖环境准备、一键安装、初始化配置及常见问题解决,全程无广告、无推广,纯技术干货分享。

⚙️ 部署前准备

1. 系统与硬件要求

表格

项目最低配置推荐配置
操作系统Windows 10+/macOS 12+/Linux(Ubuntu 22.04+)同左,优先 Linux/macOS 获更稳定体验
内存≥ 2GB4GB+ 避免卡顿
网络稳定联网带宽≥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 分钟,具体耗时取决于网络速度。

第三步:初始化配置

安装完成后,执行以下命令完成初始化,按提示操作即可(新手可直接默认回车):

  1. 输入初始化命令

bash

运行

openclawonboard

  1. 按终端提示完成 3 项配置

    • 设置管理员密码(务必记录,后续登录使用)
    • 选择 AI 服务(新手推荐 “云端 API”,无需本地部署模型)
    • 配置端口(默认 18789,直接回车)

第四步:启动服务与访问

  1. 启动网关服务(终端请勿关闭,关闭将导致服务停止)

bash

运行

openclawgateway --port 18789

  1. 打开操作控制台

bash

运行

openclawdashboard

  1. 浏览器自动跳转至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