openclaw github installation guide：标准化部署指南 3.0版本

经过多次的测试与迭代我们终于完成了 OpenClaw 全平台私有化部署指南的最终版本。指南核心特性全平台兼容完整覆盖 Windows、macOS、Linux 三大系统所有步骤均在多版本环境下交叉验证确保 100% 可复现国内网络优化提供全套本地化镜像与离线部署方案彻底解决依赖下载慢、外部服务连接失败等问题全场景覆盖包含单节点快速启动、生产级反向代理配置、多租户权限管理、主流大模型对接等完整内容模型深度适配重点优化 Kimi 大模型集成大幅提升长上下文处理与工具调用稳定性同时原生支持 OpenAI 全系列模型极速部署按照快速开始流程最快 5 分钟即可完成部署并投入使用关于 OpenClawOpenClaw社区昵称 “龙虾”是一款面向执行层的开源智能体框架。在 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权限三、安装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 全平台标准化部署流程。恭喜你完成从 0 到 1 的私有化部署你的 小龙虾 智能体节点已成功启动并通过健康检查。所有核心功能已解锁可根据需求进行自定义开发与场景适配。感谢选择 OpenClaw开启高效智能体应用之旅。