【全新 3.0版本】openclaw github installation guide

经过多轮灰度测试与全场景迭代优化，OpenClaw（开发者社区昵称 "龙虾"）全平台私有化部署指南今日正式发布。

本指南全面覆盖 Windows、macOS、Linux 三大主流操作系统，所有部署流程均通过多版本、多硬件环境交叉验证，可 100% 无差别复现。针对国内用户海外资源依赖痛点，提供完整本地化镜像与离线部署方案，彻底解决依赖下载慢、外部服务断连等问题。

指南兼顾入门与生产级需求，既包含基础环境搭建与核心服务一键启动流程，也系统讲解了企业级部署必备的反向代理配置、多租户身份认证体系及主流大模型标准化对接方案。其中，国内用户首选的 Kimi 大模型集成模块经深度定制优化，长上下文处理效率与复杂工具链调用稳定性显著提升；同时完整保留 OpenAI 全系列模型原生支持，满足全球用户差异化需求。按照快速开始流程操作，最快 5 分钟即可完成全部部署，即刻拥有完全私有化、数据自主可控的 AI 智能体服务。

关于 OpenClaw

2026 年是 AI 产业关键分水岭，行业竞争已从大模型参数规模转向智能体落地执行能力，AI 正式迈入主动执行新纪元。

在全球开源智能体赛道，OpenClaw 凭借突破性执行层技术架构，率先实现从 "被动式内容生成" 到 "主动式闭环执行" 的范式转移，成为标杆性开源项目，核心技术能力体现在四大维度：

全链路任务闭环执行：构建完整能力链路，支持无人工干预自主完成多步骤复杂工作流
原生系统级操作权限：具备本地设备原生驱动能力，覆盖绝大多数系统操作
全渠道统一交互入口：支持 50 + 主流通讯平台无缝接入，无需额外安装专属客户端
多智能体协同工作机制：支持自定义构建专属 AI 工作团队，通过分工协作完成复杂业务场景

二、安装前准备

系统要求：Windows 10+/macOS 12+/主流 Linux 发行版（Ubuntu 22.04+ 推荐）
依赖条件：Node.js ≥ v22（一键脚本会自动安装）、npm/pnpm、Git（源码安装需要）
内存要求：≥ 2GB（推荐 4GB+）
网络环境：需联网下载安装包和依赖
权限要求：Windows 需 PowerShell 管理员权限，Linux/macOS 需 sudo 权限

三、安装 OpenClaw

1、官方一键脚本安装（推荐新手，全平台）

这是最简单、最不易出错的安装方式，脚本会自动检测并安装缺失依赖。

1.1 Windows 系统

右键开始菜单，选择终端 (管理员) 或 Windows PowerShell (管理员)，在 UAC 弹窗点击 "是"。
执行官方一键安装命令：

iwr -useb https://openclaw.ai/install.ps1 | iex
国内用户若下载缓慢，可使用国内镜像加速脚本：

iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex
等待安装完成，全程无需手动操作，脚本会自动完成 Node.js 检测、核心程序安装、环境变量配置。

1.2 macOS / Linux / WSL2 系统

打开系统终端，直接执行官方一键安装命令：

curl -fsSL https://openclaw.ai/install.sh | bash
国内加速镜像命令：

curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
等待脚本执行完成，全程自动完成环境配置。

2、包管理器安装（npm/pnpm，适合开发者）

适合已安装 Node.js 环境，想要精准控制版本的用户。

2.1 先确认 Node.js 版本，终端输入以下命令验证，需输出 >=22.0.0：

复制代码

node -v

2.2 全局安装 OpenClaw（二选一即可）

npm 安装：

npm install -g openclaw@latest
pnpm 安装（速度更快，依赖更稳定）：

pnpm add -g openclaw@latest

2.3 国内用户可添加镜像源加速，示例：

复制代码

npm install -g openclaw@latest --registry=https://registry.npmmirror.com

四、初始化配置

1、安装后初始化向导

安装完成后，配置以下代码执行初始化向导

复制代码

openclaw onboard --install-daemon

2、入门向导新手引导

入门向导会引导你完成以下核心设置:

3、完成引导过程中配置大模型

OpenClaw 需要连接大模型才可以使用，以下是国内（海外）的常用配置：

Kimi API 配置（国内用户优选方案）

{ env: { KIMI_API_KEY: "sk-..." }, agents: { defaults: { model: { primary: "kimi-coding/k2p5" } }, }, }

OpenAI API 配置（海外用户选择方案）

{ agents: { defaults: { model: { primary: "openai/gpt-5.4" } } }, }

五、使用 TUI 快速体验，开始畅聊

选择 TUI 并敲击回车

六、配置完成后查看 OpenClaw 状态：

完成网关、模型通道、管理员配置（推荐添加 --install-daemon 安装后台守护进程）：

执行环境诊断命令，检查安装是否完整、环境是否正常：

openclaw doctor
查看网关运行状态：

openclaw status
打开本地可视化控制台：

openclaw dashboard

七、常见问题及解决方案：未找到 OpenClaw

如果安装成功但在终端中找不到 openclaw：

node -v # Node 是否已安装？

npm prefix -g # 全局包位于何处？

echo "$PATH" # 全局二进制目录是否在 PATH 中？

如果未包含在 PATH 中，请将其添加到 shell 启动文件（或）中： $(npm prefix -g)/bin$ PATH~/.zshrc~/.bashrc

export PATH=" $(npm prefix -g)/bin:$ PATH"

然后打开一个新的终端。

八、结语

本教程已完整呈现 OpenClaw 3.0 生产级私有化部署全流程，涵盖环境依赖、服务配置、模型对接与运维监控。你已成功搭建标准化的 OpenClaw 智能体运行环境，节点通过全链路健康校验，支持多租户管理与企业级二次开发。可基于此框架进一步构建行业专属智能体解决方案。