OpenClaw实战04：一键安装脚本快速部署（官方推荐）

原创 于 2026-07-02 17:19:24 发布 · 268 阅读 · 1 ·
本内容遵循CC 4.0 BY-SA版权协议
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
GEO检测
收录于
OpenClaw实战

当前文章被收录于：

OpenClaw实战
5 篇文章 0 人学习

本专栏聚焦开源本地 AI 助手 OpenClaw，以 “龙虾精神” 为主线，用 80 篇系统化内容，带你从入门到实战。涵盖部署、架构、技能开发、多渠道接入、记忆安全、自动化运维等核心模块。全程实操、可直接复用，帮助开发者快速搭建私有、安全、可扩展的本地 AI 智能体，掌握下一代 AI 自动化技术。

订阅专栏 查看详情

AI 时代程序员必备技能

Codex、Claude Code、Cursor、Hermes Agent、OpenClaw等工程化实战专栏 ，讲透 AI 如何接管脏活累活

一键订阅

提示：“奔跑吧邓邓子” 的 OpenClaw 实战专栏聚焦开源本地 AI 助手 OpenClaw，以 “龙虾精神” 为主线，用 80 篇系统化内容，带你从入门到实战。涵盖部署、架构、技能开发、多渠道接入、记忆安全、自动化运维等核心模块。全程实操、可直接复用，帮助开发者快速搭建私有、安全、可扩展的本地 AI 智能体，掌握下一代 AI 自动化技术。

目录

大家好，欢迎继续阅读 OpenClaw 从入门到实战 专栏。
在前三篇内容里，我们依次了解了 OpenClaw 龙虾设计理念、四层核心底层架构，并且完成 Node.js 22+、pnpm 环境搭建与安装前全套自检。环境准备工作全部就绪后，本篇进入正式部署环节。
OpenClaw 官方提供两种部署方案：一键脚本快速部署（新手首选）、源码手动编译部署（深度二次开发使用）。一键脚本会自动处理仓库拉取、依赖下载、全局命令注册、后台网关常驻配置，全程无需手动操作复杂构建流程，契合龙虾 “极简、开箱即用” 的设计思想。本篇完整拆解一键部署全流程，解决安装日志看不懂、初始化配置踩坑、部署完成无法访问控制台等高频问题。

一、官方一键安装命令

官方一键脚本会自动检测当前操作系统、校验 Node.js 版本、配置国内镜像加速、注册全局openclaw命令，屏蔽底层复杂操作，不同平台执行命令存在区分，Windows 原生环境暂不支持一键脚本，仅可通过 WSL2 子系统执行。

1.1 macOS/Linux 一键安装

macOS（Intel/Apple Silicon）、Ubuntu、Debian、树莓派 Linux 等类 Unix 系统共用同一条安装脚本，打开终端直接复制执行：

curl -fsSL https://install.openclaw.dev | pnpm exec node -

脚本执行逻辑：

  1. 远程拉取官方安装脚本并本地临时运行；
  2. 自动校验node -v是否≥v22.0.0，版本不达标直接终止并提示升级；
  3. 自动配置 npmmirror 国内镜像，加速依赖下载；
  4. 克隆 OpenClaw 主仓库至用户目录，自动执行依赖安装；
  5. 注册全局openclaw系统命令，写入环境变量；
  6. 生成默认~/.openclaw配置目录模板。

若服务器无法访问外网 curl 地址，可手动下载脚本文件本地执行，官方文档提供离线脚本包。

1.2 Windows WSL2 部署流程

Windows 系统原生 CMD/PowerShell 不兼容一键脚本，官方推荐搭配 WSL2 Linux 子系统部署，完整流程如下：

  1. 提前开启 WSL2，安装 Ubuntu 发行版，完成前文 Node.js 22+、pnpm 环境配置；
  2. 打开 WSL2 终端，执行和 Linux 完全一致的一键安装命令；
  3. WSL2 内部部署完成后，18789 端口支持 Windows 本机浏览器直接访问127.0.0.1:18789，无需额外端口转发；
  4. 如需开机自启网关，在 WSL2 内配置开机执行openclaw start即可。

注意事项：不要混用 Windows 原生 Node 与 WSL2 内 Node，环境隔离会导致全局命令失效、端口监听异常。

1.3 安装过程日志与关键提示解读

执行一键脚本后终端会滚动输出大量日志，很多新手看不懂报错与关键提示，这里划分三类核心日志做解读：
1. 版本校验日志

Check Node.js version: v22.14.0 ✅

绿色对勾代表版本合规；若输出红色报错Node version too low，说明环境未按第三篇要求安装 Node22+，需退出脚本重新配置环境。
2. 依赖下载日志

Using mirror: https://registry.npmmirror.com

代表国内镜像配置生效，下载速度提升；若出现ETIMEDOUT超时，检查网络或重新执行脚本。
3. 安装成功收尾提示

OpenClaw install complete!
Global command: openclaw
Data dir: ~/.openclaw
Default gateway port: 18789
Run `openclaw init` to start onboarding setup

出现该段文字代表部署主体流程完成，终端会提示执行初始化引导命令，是进入配置流程的入口。
若日志出现权限相关EACCES报错，回到第三篇权限自检章节，使用普通用户操作，避免 root/sudo 全局安装。

二、安装后初始化：onboarding 流程

一键安装仅完成程序文件部署，首次使用必须走完官方 onboarding 初始化引导，生成安全令牌、绑定模型接口、登录 Web 控制台，缺少该步骤网关服务无法正常调度 Agent 与 Skills。执行初始化命令：

openclaw init

2.1 网关令牌生成与保存

初始化第一步自动生成全局网关访问令牌，用于 Web 控制台、API 接口鉴权，遵循龙虾 “最小权限、安全可控” 原则：

  1. 脚本随机生成 32 位加密字符串，仅本地可见，不会上传任何云端；
  2. 终端明确提示：请复制令牌保存至本地记事本，丢失后只能重置配置目录重新生成；
  3. 令牌作用：访问 18789 控制台、第三方渠道接入、远程 API 调用鉴权，无令牌无法操作网关；
  4. 安全机制：令牌存储在~/.openclaw/config/custom.yaml，文件默认仅当前用户可读，禁止共享。

2.2 模型 API 密钥配置

初始化第二步引导配置大模型接口密钥，支持 OpenAI、Claude、本地 Ollama 等多类模型：

  1. 选择模型类型：云端 API 模型 / 本地离线模型；
  2. 粘贴对应平台 API Key、填写接口代理地址、自定义模型名称；
  3. 配置完成自动写入全局配置文件，Agent 执行任务时自动读取密钥；
  4. 隐私保障：密钥仅本地文件加密存储，OpenClaw 无任何密钥上传行为，贴合本地优先设计理念。

暂时没有 API 密钥可选择跳过，后续通过控制台配置页面随时补充修改。

2.3 控制台访问与首次登录

初始化最后一步给出 Web 控制台访问地址与登录指引：

  1. 启动网关服务命令：openclaw start，常驻后台运行 Gateway 进程；
  2. 打开浏览器输入本地地址http://127.0.0.1:18789；
  3. 登录页面输入上一步保存的网关令牌，完成身份校验进入后台；
  4. 首次登录会弹出龙虾欢迎引导弹窗，简单介绍控制台功能分区：渠道管理、技能插件、Agent 调度、日志监控。

三、安装验证与龙虾欢迎页

走完初始化流程后，通过三层校验确认部署完全可用，排查隐藏安装缺陷，避免后续使用出现隐性故障。

3.1 openclaw status 健康检查

网关启动后，终端执行健康检测命令，一键查看全组件运行状态：

openclaw status

输出信息包含四大核心模块状态：

  • Gateway 进程：running（运行中）/stopped（已停止）
  • 配置目录：~/.openclaw读写权限正常
  • 端口 18789：监听正常、无占用
  • 加载 Skills 插件数量、已配置模型列表、渠道连接状态

任意一项状态异常会标红提示，并给出对应修复方案，例如端口占用、配置文件缺失、权限不足等，快速定位部署问题。

3.2 Web 控制台访问（127.0.0.1:18789）

健康检测无异常后验证网页端可用性：

  1. 本地浏览器访问 http://127.0.0.1:18789；
  2. 输入网关令牌登录，成功进入龙虾主题欢迎首页；
  3. 欢迎页展示项目龙虾 LOGO、架构简图、本地数据存储说明、快捷功能入口；
  4. 无法访问排查方向：网关未启动、防火墙拦截 18789 端口、WSL2 端口转发异常，对照第三篇自检清单处理。

3.3 基础命令测试与功能校验

通过多条内置基础指令，完整校验全局命令、Agent、记忆模块可用性：

  1. 查看版本：openclaw -v，输出版本号即全局命令注册成功；
  2. 快速对话测试：openclaw chat “你好，介绍一下龙虾OpenClaw”，直接唤起本地 Agent 执行对话；
  3. 查看本地存储：openclaw memory list，校验记忆持久化模块正常读写；
  4. 停止 / 重启网关：openclaw stop、openclaw restart，验证进程常驻管理能力。

全部指令无报错、正常输出内容，代表一键部署完整生效，可以正常使用多渠道 AI 助手、自定义技能等全部核心能力。

四、本篇总结与下节预告

本篇完整落地官方推荐一键脚本部署方案，覆盖全平台安装命令、初始化引导流程、三层部署校验手段，核心要点回顾：

  1. macOS/Linux/WSL2 支持一键脚本，自动处理环境校验、依赖安装、全局命令注册；
  2. onboarding 初始化必须完成令牌保存、模型密钥配置，是控制台登录前置条件；
  3. 通过openclaw status、网页控制台、终端指令三重验证，确保部署无隐性故障；
  4. 一键部署轻量化、上手快，适合绝大多数普通本地用户。

下一篇预告：专栏第 5 篇《多平台手动部署（源码编译）》，讲解 GitHub 源码克隆、本地构建、全局链接流程，分平台配置系统后台自启服务，同时梳理手动部署专属排错方案，面向需要修改源码、深度自定义开发的进阶开发者。

专栏持续更新纯干货实战教程，欢迎点赞、收藏、关注，跟进全套 OpenClaw 落地与二次开发教程！

专栏系列文章链接

1. OpenClaw 实战开篇 —— 本地 AI 助手，从龙虾精神开始

OpenClaw 实战开篇 —— 本地 AI 助手，从龙虾精神开始

2. OpenClaw实战02：OpenClaw核心架构与龙虾设计理念

OpenClaw实战02：OpenClaw核心架构与龙虾设计理念

3. OpenClaw实战03：前置依赖与环境准备（Node.js 22+）

OpenClaw实战03：前置依赖与环境准备（Node.js 22+）

AI 时代程序员必备技能

Codex、Claude Code、Cursor、Hermes Agent、OpenClaw等工程化实战专栏 ，讲透 AI 如何接管脏活累活

一键订阅
标签
#OpenClaw #实战 #部署
3 分钟快速安装 OpenClaw：官方脚本一键搞定技术指南
一键难忘的博客
03-08 1131
本文提供了OpenClaw在Windows、macOS和Linux系统上的快速安装指南，通过官方一键脚本可在3分钟内完成安装。文章详细介绍了各系统的安装方法，包括PowerShell脚本、命令行一键安装和包管理器（Chocolatey/Homebrew/APT/YUM）三种方式。安装前需满足系统要求（64位处理器、4GB内存、10GB磁盘空间），并提供了环境检测流程图确保安装环境准备就绪。安装完成后可通过openclaw --version命令验证安装是否成功。
OpenClaw官方一键脚本使用指南，告别复杂配置
一键难忘的博客
02-15 1220
OpenClaw官方一键脚本提供全自动部署方案，支持x86_64和ARM64架构，最低配置仅需1.5GHz单核CPU、1GB内存和5GB存储空间。脚本智能检测系统环境，自动安装Python、Node.js、Redis等依赖，并配置开机自启服务。支持Ubuntu、Debian、CentOS等主流Linux发行版，通过简单命令即可完成安装和配置。脚本还提供完善的错误处理和卸载功能，适合各类用户快速部署OpenClaw服务。
在 Ubuntu 上快速部署 OpenClaw 完整教程
热门推荐
qq_40600379的博客
02-27 2万+
本文详细介绍了在Ubuntu 22.04服务器上部署OpenClaw的完整流程。首先更新系统并安装Node.js环境，配置淘宝镜像加速。然后通过官方安装脚本一键部署OpenClaw，包含完整的安装日志输出。最后强调OpenClaw仍处于测试阶段，提供了重要的安全警告和使用建议，包括隔离会话、最小权限原则等安全实践。文章记录了从环境准备到成功安装的全过程，并特别提醒用户注意该工具的安全风险和使用限制。
在Ubuntu上安装OpenClaw主要有两种主流且官方推荐的方式：一键脚本安装（适合新手和快速部署）和 Docker 安装（适合需要环境隔离和生产环境部署）
03-09 5127
（适合新手和快速部署）和（适合需要环境隔离和生产环境部署）。此外，对于开发者或需要特定版本的用户，也可以选择。以下是针对Ubuntu系统的详细操作步骤分解。
实测｜WSL2 从零部署 OpenClaw AI 助手：安装配置与实战运行教程
m0_73982863的博客
02-13 7285
想在 Windows 上跑本地 AI 助手，却被复杂的 Linux 环境劝退？这篇实测教程帮你一键搞定！ 本文详细拆解 WSL2 部署 OpenClaw AI 助手的全流程：从 WSL2 与 Ubuntu 环境搭建，到 Node.js 配置，再到三种安装方式任选，最后完成服务启动与访问。全程附命令行实操与避坑提示，让你在 Windows 上也能丝滑运行本地 AI 服务。
Windows环境OpenClaw部署教程-安装篇
baotangyin的博客
03-12 5524
用于源码拉取、自定义技能开发，官网链接（https://github.com/git-for-windows/git/releases/download/v2.53.0.windows.2/Git-2.53.0.2-64-bit.exe）下载安装，全程默认下一步即可，安装后在PowerShell/CMD终端输入。下载地址：官网（https://aka.ms/vs/stable/vs_BuildTools.exe），下载后手动安装，注意安装选项选择：使用C++的桌面开发，右侧选项选择见下图，然后点击安装。
【工具】OpenClaw 一键部署工具
xfxuezhang.cn
02-16 3950
部署门槛不断降低
OpenClaw 安装全流程（Windows + Ubuntu + macOS）一键部署 + 源码编译 + Docker
小李同学_LSH的博客
04-20 1498
OpenClaw 作为轻量、高效的开源个人 AI 助手，安装流程简单，支持多系统、多安装方式，新手可通过一键脚本5分钟完成部署，开发者可通过源码编译自定义功能。 本文涵盖了 Windows、Ubuntu、macOS 三大系统的完整安装流程，新增了多类对比表格、详细命令注释、常见坑解决方案，全程可复制粘贴，确保零基础也能顺利完成安装。 安装完成后，可在web面板中配置模型、绑定聊天渠道（WhatsApp、Telegram等），实现“清邮箱、发邮件、管日历、值机”等实操功能，真正打造属于自己的个人 AI 助手。
一键脚本安装OpenClaw：5分钟跑起来
weixin_45495161的博客
03-19 1128
下载脚本后修改vim install.sh # 修改配置一键脚本真的省心，我现在重装系统5分钟就搞定了。新手强烈推荐用这个，省心省力。有问题评论区问，看到了都会回。下期预告下一期讲讲微信接入配置，让OpenClaw成为你的微信AI助手。敬请期待！往期文章Windows Docker安装OpenClawLinux服务器Docker部署OpenClawVPS云端部署OpenClaw+公网访问Docker Compose集群部署OpenClaw参考资料。
OpenClaw 本地部署完全指南：从安装到实战
Adrian 博客
02-13 4062
OpenClaw作为一款开源、自托管的AI智能体平台，通过本地部署可以完全掌控数据与工作流。环境准备：确保Node.js ≥ 22，选择适合的操作系统安装方式：推荐使用一键脚本，简单快捷配置向导：重点配置AI模型和聊天平台安全实践：务必在隔离环境中运行，注意权限控制持续学习：利用丰富的社区资源提升使用技巧通过本指南，你应该能够成功搭建并运行自己的OpenClaw AI助手，实现从简单对话到复杂任务自动化的跨越。
OpenClaw 一键安装部署脚本
jacky choise
03-12 492
OpenClaw 跨平台一键安装脚本 该脚本支持 Windows、Linux 和 macOS 平台，提供自动化安装部署方案。主要功能包括： 自动检测操作系统类型和架构 检查并安装 Node.js 22 版本（Windows 使用 MSI 安装包，Linux/macOS 通过包管理器） 详细日志记录功能，每次运行生成新的日志文件 自动创建项目目录结构 Windows 使用 PowerShell 脚本(install.ps1)，Linux/macOS 使用 Bash 脚本(install.sh)。脚本提供分步安
新手秒变高手：使用一键脚本快速安装OpenClaw并完成初始化配置
一键难忘的博客
03-13 286
一键脚本是一种自动化工具，可以帮助用户快速完成软件的安装和配置过程，无需手动执行繁琐的命令。OpenClaw提供了官方的一键安装脚本，让新手用户也能轻松部署OpenClaw。
【部署】Ubuntu 24.04.4虚拟机下部署OpenClaw
海兰
02-27 1万+
OpenClaw是一款基于AI的智能助手工具，本文详细介绍了在Ubuntu 24.04.4系统上的三种安装方法。推荐使用一键安装脚本（curl -fsSL https://openclaw.ai/install.sh | bash），自动完成Node.js检测、CLI安装和引导配置。对于开发者，提供了从源码构建的详细步骤，包括环境准备、依赖安装和构建流程。文章还包含常见问题解决方案（如sharp构建错误处理）以及后续维护建议（更新、配置检查和日志查看）。安装完成后，用户可通过终端TUI或Web UI进行初始
Ubuntu 22.04 OpenClaw安装部署
weixin_57938624的博客
03-09 1463
这条命令会返回一个独一无二的 Token，请把它保存到你的记事本里，它是你进入 UI 界的唯一钥匙。搭建 Node.js v22 核心基座。，如果看到一串命令列表，说明安装成功。三、一键全局安装 OpenClaw。四、配置守护进程 (Daemon)六、远程访问 Dashboard。1、使用Xshell连接服务器。2、在弹框中输入刚才保存的。：看到输出中有高亮绿色的。一、连接服务器并更新环境。打开你本地电脑的浏览器。1、安装 NVM 脚本。
5分钟极速部署OpenClaw教程，新手也能一次成功
一键难忘的博客
02-15 1807
5分钟极速部署OpenClaw教程摘要 本教程提供新手友好的OpenClaw一键部署方案，5分钟内完成安装。支持x86/ARM架构，最低配置仅需1.5GHz单核CPU+1GB内存。推荐使用Ubuntu 22.04系统，通过官方脚本自动完成环境检测、依赖安装和服务配置。实测显示待机功耗3-5W，CPU占用2-5%，运行稳定安静。脚本内置错误恢复机制，支持自动回滚和卸载。常见问题包括网络连接失败，可通过代理或手动下载解决。部署完成后自动配置开机自启和防休眠，适合各类Linux用户快速体验OpenClaw功能。（
Ubuntu 22.04 安装部署 OpenClaw 完整教程
m0_55834564的博客
03-18 5309
本文详细介绍在 Ubuntu 22.04 LTS 系统上从零开始安装、配置、部署 OpenClaw AI 助手框架的完整流程，包含环境准备、安装步骤、服务配置、故障排查等内容。
快速部署！2026 OpenClaw Windows 一键安装，稳定不卡顿
最新发布
d188927的博客
06-19 222
2026 OpenClaw 一键安装教程，提供 Windows/macOS/Linux 全平台部署方案。推荐使用虾壳云在线部署（5分钟完成），支持零配置开箱即用。本地安装提供多种方式：Windows 支持图形化安装/PowerShell/Chocolatey；macOS 推荐 Homebrew 或 Docker；Linux 提供通用脚本和 CentOS 专属方案。安装后需配置 API Key（支持 Claude 和 OpenAI），并可扩展安装电商客服、微信机器人等技能。提供完整的验证方法和卸载指南，确保部
【四月底最新教程】OpenClaw一键部署安装包以及使用方式
2603_95764454的博客
04-25 756
适配平台：Windows 10/11（64 位）｜小白友好｜全程可视化操作｜无技术门槛后续更新 OpenClaw 技能扩展、本地大模型接入、聊天工具联动教程，手把手教你把 “小龙虾” 调教成全能助手！
OpenClaw Windows 一键安装部署详细教程
2602_95623716的博客
04-14 838
OpenClaw 一键安装包｜可视化部署教程，简化环境配置流程 适配系统：Windows10/11 64 位当前版本：v2.6.2 核心优势：全程可视化操作，无需命令行、无需手动配置 Python/Node.js，内置全部运行依赖，短时间内完成部署，新手可快速上手。
在云服务器上安装 OpenClaw(官方一键安装脚本)
全栈测试
05-08 599
model deepseek/deepseek-v4-flash # 切换到指定模型。官方推荐的方式，脚本会自动检测并安装 Node.js 和所有依赖，无需手动配置环境。source ~/.bashrc # 或 source ~/.zshrc。/temp 0.7 # 调整温度参数（0-1）/agent code # 切换到代码助手模式。/agent chat # 切换到对话模式。# 在 TUI 中输入以下命令（注意要以 / 开头）
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

奔跑吧邓邓子

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值