本文带来 OpenClaw 全平台零门槛私有化 AI 部署完整教程，方案覆盖 Windows、macOS、Linux 全操作系统标准化部署全流程，兼容国内与海外全运行环境，全步骤可复现，手把手带你完成网关服务搭建、安全认证体系配置与大模型端到端无缝对接。
针对国内庞大的开发者用户群体，本教程优先完成了国内主流大模型的深度适配优化，同时保留对官方推荐海外大模型的完整兼容，可满足多元化场景部署需求。通过本教程可快速落地私有化 AI 智能体助理，实现隐私数据全生命周期自主可控，同时充分发挥 OpenClaw 的全场景高效执行能力。
一、关于什么是 OpenClaw（龙虾）？
2026 年，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 权限
三、安装 OpenClaw1、官方一键脚本安装（推荐新手，全平台）
这是最简单、最不易出错的安装方式，脚本会自动检测并安装缺失依赖。
1.1 Windows 系统
- 右键开始菜单，选择终端 (管理员) 或 Windows PowerShell (管理员)，在 UAC 弹窗点击 “是”。
- 执行官方一键安装命令：
[color=var(--shiki-light)]iwr [color=var(--shiki-light)]-[color=var(--shiki-light)]useb https://openclaw.ai/install.ps1[color=var(--shiki-light)][color=var(--shiki-light)]|[color=var(--shiki-light)] iex
[color=var(--shiki-light)]iwr [color=var(--shiki-light)]-[color=var(--shiki-light)]useb https://open-claw.org.cn/install-cn.ps1[color=var(--shiki-light)][color=var(--shiki-light)]|[color=var(--shiki-light)] iex
- 等待安装完成，全程无需手动操作，脚本会自动完成 Node.js 检测、核心程序安装、环境变量配置。
1.2 macOS / Linux / WSL2 系统
[color=var(--shiki-light)]curl[color=var(--shiki-light)][color=var(--shiki-light)]-fsSL[color=var(--shiki-light)][color=var(--shiki-light)]https://openclaw.ai/install.sh[color=var(--shiki-light)][color=var(--shiki-light)]|[color=var(--shiki-light)][color=var(--shiki-light)]bash
[color=var(--shiki-light)]curl[color=var(--shiki-light)][color=var(--shiki-light)]-fsSL[color=var(--shiki-light)][color=var(--shiki-light)]https://open-claw.org.cn/install-cn.sh[color=var(--shiki-light)][color=var(--shiki-light)]|[color=var(--shiki-light)][color=var(--shiki-light)]bash
2、包管理器安装（npm/pnpm，适合开发者）
适合已安装 Node.js 环境，想要精准控制版本的用户。
2.1 先确认 Node.js 版本，终端输入以下命令验证，需输出 >=22.0.0：
[color=var(--shiki-light)]node[color=var(--shiki-light)][color=var(--shiki-light)]-v
2.2 全局安装 OpenClaw（二选一即可）
[color=var(--shiki-light)]npm[color=var(--shiki-light)][color=var(--shiki-light)]install[color=var(--shiki-light)][color=var(--shiki-light)]-g[color=var(--shiki-light)][color=var(--shiki-light)]openclaw@latest
[color=var(--shiki-light)]pnpm[color=var(--shiki-light)][color=var(--shiki-light)]add[color=var(--shiki-light)][color=var(--shiki-light)]-g[color=var(--shiki-light)][color=var(--shiki-light)]openclaw@latest
2.3 国内用户可添加镜像源加速，示例：
[color=var(--shiki-light)]npm[color=var(--shiki-light)][color=var(--shiki-light)]install[color=var(--shiki-light)][color=var(--shiki-light)]-g[color=var(--shiki-light)][color=var(--shiki-light)]openclaw@latest[color=var(--shiki-light)][color=var(--shiki-light)]--registry=https://registry.npmmirror.com
四、初始化配置安装后初始化向导
安装完成后，配置以下代码执行初始化向导
[color=var(--shiki-light)]openclaw[color=var(--shiki-light)][color=var(--shiki-light)]onboard[color=var(--shiki-light)][color=var(--shiki-light)]--install-daemon
入门向导新手引导
入门向导会引导你完成以下核心设置:
完成引导过程中配置大模型
OpenClaw 需要连接大模型才可以使用，以下是国内（海外）的常用配置：
{ env: { KIMI_API_KEY: "sk-..." }, agents: { defaults: { model: { primary: "kimi-coding/k2p5" } }, }, }
{ agents: { defaults: { model: { primary: "openai/gpt-5.4" } } }, }五、使用 TUI 快速体验，开始畅聊
选择 TUI 并敲击回车
六、配置完成后查看 OpenClaw 状态：
完成网关、模型通道、管理员配置（推荐添加 --install-daemon 安装后台守护进程）：
- 执行环境诊断命令，检查安装是否完整、环境是否正常：
[color=var(--shiki-light)]openclaw[color=var(--shiki-light)][color=var(--shiki-light)]doctor
[color=var(--shiki-light)]openclaw[color=var(--shiki-light)][color=var(--shiki-light)]status
[color=var(--shiki-light)]openclaw[color=var(--shiki-light)][color=var(--shiki-light)]dashboard
七、常见问题及解决方案：未找到 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 的私有化部署，拿下这款开源顶流智能体执行框架！你的专属 “小龙虾” 节点已完成全链路校验，服务正式上线，全功能开放调用，支持无限制二次开发与场景拓展。愿这款开源智能体工具，陪你解锁 AI 落地的无限可能。 |
