OpenClaw 全平台私有化 AI 部署标准化指南正式开源发布。我们针对 Windows、macOS、Linux 三大操作系统分别编写了经过反复验证的可复现流程，同时解决了国内外网络环境下的依赖拉取、服务访问等常见问题。

教程详细拆解了私有化部署的核心环节：包括反向代理网关配置、多租户安全认证体系搭建、以及与主流大模型 API 的标准化对接方案。考虑到国内开发者的实际需求，我们重点优化了 Kimi 大模型的集成流程，充分发挥其长上下文与工具调用优势；同时保留了对 OpenAI 系列模型的原生支持，为海外用户提供最佳体验。

按照本指南操作，开发者可在 5 分钟内完成私有化 AI 智能体的落地部署，实现企业级数据隐私保护与 OpenClaw 强大执行能力的结合。

一、关于什么是 OpenClaw（龙虾）？

2026 年，大模型技术演进的重心已从模型本身的参数规模优化，全面转向智能体的端到端执行能力构建。行业终于突破了长期以来 "能说不能做" 的瓶颈，从纯对话交互阶段迈入了任务执行阶段。在开源智能体领域，有着 "龙虾" 昵称的 OpenClaw，凭借其出色的工具调用与任务编排能力，成功实现了从自然语言理解到实际动作执行的闭环。

核心特点：

  • 全链路任务闭环：具备“意图理解 → 任务拆解 → 路径规划 → 工具调用 → 执行校验 → 结果反馈”的完整能力，无需人工二次干预，即可自主完成多步骤复杂工作流。
  • 系统级操作权限：可直接驱动本地设备，完成文件管理、命令行执行、浏览器自动化、代码编写部署、邮件收发、日程管理等几乎所有手动可执行的系统操作。
  • 多渠道统一交互：支持 50 主流通讯平台接入，用户可通过日常使用的聊天软件下达指令，无需安装额外专属客户端。
  • 多智能体协同：支持构建专属 AI 团队，多个智能体可分工协作，适配多角色、多环节的复杂工作场景。

二、安装前准备

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

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

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

1.1 Windows 系统

  1. 右键开始菜单，选择终端 (管理员) 或 Windows PowerShell (管理员)，在 UAC 弹窗点击 “是”。
  2. 执行官方一键安装命令：
iwr -useb https://openclaw.ai/install.ps1| iex
 
  1. 国内用户若下载缓慢，可使用国内镜像加速脚本：
iwr -useb https://open-claw.org.cn/install-cn.ps1| iex
 
  1. 等待安装完成，全程无需手动操作，脚本会自动完成 Node.js 检测、核心程序安装、环境变量配置。

1.2 macOS / Linux / WSL2 系统

  1. 打开系统终端，直接执行官方一键安装命令：
curl-fsSLhttps://openclaw.ai/install.sh|bash
 
  1. 国内加速镜像命令：
curl-fsSLhttps://open-claw.org.cn/install-cn.sh|bash
 
  1. 等待脚本执行完成，全程自动完成环境配置。

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

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

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

node-v
 

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

  • npm 安装：
npminstall-gopenclaw@latest
 
  • pnpm 安装（速度更快，依赖更稳定）：
pnpmadd-gopenclaw@latest
 

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

npminstall-gopenclaw@latest--registry=https://registry.npmmirror.com
 

四、初始化配置安装后初始化向导

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

openclawonboard--install-daemon
 

入门向导新手引导

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


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

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 安装后台守护进程）：

  1. 执行环境诊断命令，检查安装是否完整、环境是否正常：
openclawdoctor
 
  1. 查看网关运行状态：
 
  1. 打开本地可视化控制台：
 

七、常见问题及解决方案：未找到 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 全链路本地化部署保姆级教程已全面收官，从环境配置到服务上线的全流程教学形成完整闭环。

恭喜你成功完成 OpenClaw 从 0 到 1 的私有化部署，正式掌握这款开源社区顶流的智能体执行框架！你的专属 "小龙虾" 节点已通过全链路校验，服务正式上线运行，所有功能模块已全面开放调用，支持无限制自定义二次开发与全场景拓展。愿这款原生开源的智能体工具，助你深挖 AI 落地的无限可能，在私有化智能体的探索征程中解锁更多全新价值。