经过多次的测试与迭代，我们终于完成了 OpenClaw 全平台私有化部署指南的最终版本。

指南核心特性

• 全平台兼容：完整覆盖 Windows、macOS、Linux 三大系统，所有步骤均在多版本环境下交叉验证，确保 100% 可复现

• 国内网络优化：提供全套本地化镜像与离线部署方案，彻底解决依赖下载慢、外部服务连接失败等问题

• 全场景覆盖：包含单节点快速启动、生产级反向代理配置、多租户权限管理、主流大模型对接等完整内容

• 模型深度适配：重点优化 Kimi 大模型集成，大幅提升长上下文处理与工具调用稳定性；同时原生支持 OpenAI 全系列模型

• 极速部署：按照快速开始流程，最快 5 分钟即可完成部署并投入使用

关于 OpenClaw

OpenClaw（社区昵称 “龙虾”）是一款面向执行层的开源智能体框架。在 AI 产业从 “对话式” 向 “执行式” 转型的关键节点，OpenClaw 凭借其独特的技术架构，成为了主动式闭环执行领域的标杆项目。

它的核心能力包括：

• 全链路任务闭环：无需人工干预，自主完成从意图理解到结果反馈的完整工作流

• 系统级原生操作：直接驱动本地设备，支持文件、命令行、浏览器、代码、邮件等几乎所有系统操作

• 全渠道交互：无缝接入 50+ 主流 IM 平台，用户无需安装新客户端即可使用

• 多智能体协同：支持自定义角色与分工，构建专属 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 全平台标准化部署流程。恭喜你完成从 0 到 1 的私有化部署，你的 "小龙虾" 智能体节点已成功启动并通过健康检查。所有核心功能已解锁，可根据需求进行自定义开发与场景适配。感谢选择 OpenClaw，开启高效智能体应用之旅。