覆盖 Windows、macOS、Linux 三大系统，国内海外网络环境全适配，每一步都踩过坑、反复验证过，照着做绝对能跑通！手把手带你搞定网关搭建、安全配置，再无缝对接主流大模型，一站式解决私有化部署所有难题。
重点划好：国内用户闭眼冲Kimi 大模型，长上下文和工具调用能力和 OpenClaw 简直是天作之合；海外用户直接用 OpenAI 全家桶，体验官方原生丝滑感。
跟着教程走，你也能拥有一只完全私有化的 AI 小龙虾，数据 100% 自己掌控，同时解锁它全场景自动干活的超强能力！
一、关于什么是OpenClaw（龙虾）？
之前大家都在卷谁的模型参数更大、谁的聊天更像人，现在风向一转，能真正动手干活的智能体，才是真的王炸。而在全球开源智能体里，最先跑通 “从动口到动手” 的，就是这只被全网吹爆的 “AI 小龙虾” OpenClaw。
它到底有多能打？以下为核心优势：
- 全流程自己搞定：从听懂你的需求，到拆分成步骤、找工具干活、检查结果，全程不用你插手，真正做到 “一句话交办，坐等收成果”
- 直接操作你的电脑：整理文件、敲代码、发邮件、排日程、自动刷网页…… 你手动能做的事，它几乎都能替你干
- 在哪都能使唤它：支持50 + 常用软件，不用装新 APP，日常聊天框就能发指令
- 一人顶一个团队：可以自定义多个不同角色的 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
四、初始化配置
- 安装后初始化向导
安装完成后，配置以下代码执行初始化向导
openclaw onboard --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 安装后台守护进程）：
- 执行环境诊断命令，检查安装是否完整、环境是否正常：
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 全链路本地化部署教程到此圆满结束。从最基础的环境配置，到最终的服务启动，你一步一步亲手搭建起了完全属于自己的 AI 智能体。
现在，你的小龙虾已经整装待发，所有功能全部开放。它不再是别人的工具，而是你专属的数字分身。你可以随心所欲地改造它、定制它，让它成为你工作和生活中最得力的助手。
尽情发挥你的想象力，用它去创造无限可能吧！
