【全新 3.0版本】openclaw github installation guide

经过多轮灰度测试与全场景迭代优化OpenClaw开发者社区昵称 “龙虾”全平台私有化部署指南今日正式发布。本指南全面覆盖 Windows、macOS、Linux 三大主流操作系统所有部署流程均通过多版本、多硬件环境交叉验证可 100% 无差别复现。针对国内用户海外资源依赖痛点提供完整本地化镜像与离线部署方案彻底解决依赖下载慢、外部服务断连等问题。指南兼顾入门与生产级需求既包含基础环境搭建与核心服务一键启动流程也系统讲解了企业级部署必备的反向代理配置、多租户身份认证体系及主流大模型标准化对接方案。其中国内用户首选的 Kimi 大模型集成模块经深度定制优化长上下文处理效率与复杂工具链调用稳定性显著提升同时完整保留 OpenAI 全系列模型原生支持满足全球用户差异化需求。按照快速开始流程操作最快 5 分钟即可完成全部部署即刻拥有完全私有化、数据自主可控的 AI 智能体服务。关于 OpenClaw2026 年是 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 权限三、安装 OpenClaw1、官方一键脚本安装推荐新手全平台这是最简单、最不易出错的安装方式脚本会自动检测并安装缺失依赖。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.0node -v2.2 全局安装 OpenClaw二选一即可npm 安装npm install -g openclawlatestpnpm 安装速度更快依赖更稳定pnpm add -g openclawlatest2.3 国内用户可添加镜像源加速示例npm install -g openclawlatest --registryhttps://registry.npmmirror.com四、初始化配置1、安装后初始化向导安装完成后配置以下代码执行初始化向导openclaw onboard --install-daemon2、入门向导新手引导入门向导会引导你完成以下核心设置: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如果安装成功但在终端中找不到 openclawnode -v # Node 是否已安装npm prefix -g # 全局包位于何处echo “$PATH” # 全局二进制目录是否在 PATH 中如果未包含在 PATH 中请将其添加到 shell 启动文件或中$(npm prefix -g)/bin$ PATH~/.zshrc~/.bashrcexport PATH$(npm prefix -g)/bin:$ PATH然后打开一个新的终端。八、结语本教程已完整呈现 OpenClaw 3.0 生产级私有化部署全流程涵盖环境依赖、服务配置、模型对接与运维监控。你已成功搭建标准化的 OpenClaw 智能体运行环境节点通过全链路健康校验支持多租户管理与企业级二次开发。可基于此框架进一步构建行业专属智能体解决方案。