OpenClaw 本地安装与配置指南
OpenClaw 是一款能将对话式 AI 进化为能落地执行的数字助手工具。本指南介绍从零开始的本地安装流程，包含环境准备、安装方式及启动验证。
1. 安装前的必备准备
做好基础准备可提升部署成功率，所需工具均为免费开源。
1.1 硬件适配
根据使用场景满足基础要求即可：
- 零基础新手尝鲜试玩：电脑满足 4 核 CPU、2GB 运行内存、20GB 以上的 SSD 存储空间，即可流畅运行；
- 长期用于个人办公、日常自动化需求：推荐 6 核 CPU、8GB 运行内存、50GB 以上的 SSD 存储空间，避免多任务运行时出现卡顿。
1.2 软件环境
核心需要 Node.js 环境：
- 必须安装 v18 及以上的 LTS 长期支持版本，新手直接下载官网推荐的 LTS 版即可；
- 安装时全程选择默认下一步，无需自定义配置，自动完成环境配置与系统路径添加；
- 若后续想尝试容器化部署，可提前安装 Docker 与 Docker Compose，实现环境隔离，避免版本冲突。
1.3 可选材料
根据需要提前准备：
- 若想使用 ChatGPT、Claude、智谱 AI 等云端大模型，可提前在对应平台官网申请好 API Key；
- 若想实现完全离线运行、保护数据隐私，可提前安装 Ollama 本地大模型运行环境，下载好适配的轻量级开源模型。
2. 本地安装方式
整理两种最主流、稳定性最强的本地安装方式，全程无需复杂的代码编写。
2.1 方式一：一键脚本安装
最简单的安装方式，全程无需手动输入复杂代码，只需复制粘贴一行命令，自动完成环境检测、依赖安装、程序部署。
2.1.1 打开终端工具
- Windows 用户：按下 Win+X，选择「Windows PowerShell (管理员)」，必须以管理员身份运行，否则会出现权限不足的报错；
- macOS 用户：按下 Command + 空格，搜索「终端」打开即可；
- Linux 用户：直接打开系统默认终端。
2.1.2 执行一键安装命令
根据系统复制对应命令，粘贴到终端中按下回车执行：
- Windows PowerShell：
irm https://get.openclaw.dev | iex
- macOS/Linux 终端：
curl -fsSL https://get.openclaw.dev | bash
2.1.3 等待脚本自动执行
脚本会自动检测系统环境、安装缺失依赖、下载最新版 OpenClaw 核心程序，全程无需人工干预，网络正常的情况下 1-3 分钟即可完成。
2.1.4 验证安装并访问后台
安装完成后，终端会输出安装成功提示，同时给出本地管理后台地址（默认 http://localhost:3000），打开任意浏览器输入该地址，即可进入可视化管理界面。
注意：若执行脚本时出现网络超时，可切换手机热点重试，或更换为国内镜像源的一键脚本。
2.2 方式二：NPM 包全局安装
目前全球用户最常用的安装方式，稳定性强、支持一键更新、可灵活配置参数。
2.2.1 验证 Node.js 环境
打开终端后，分别输入以下两行命令，若输出版本号且版本在 v18 及以上，说明环境安装成功：
node -v
npm -v
若提示命令不存在，需重新安装 Node.js，注意勾选「添加到系统 PATH」选项。
2.2.2 全局安装 OpenClaw
输入以下命令，按下回车执行，终端会自动完成核心程序的下载与安装：
npm i -g openclaw
2.2.3 验证安装结果
输入以下命令，若输出版本号，说明核心程序安装成功：
openclaw -v
2.2.4 初始化配置
输入以下命令，按照终端的中文提示完成基础配置（如管理员账号、默认模型等），新手全程按回车选择默认配置即可：
openclaw onboard
2.2.5 启动服务
输入以下命令，即可启动 OpenClaw 服务，终端会输出启动成功提示：
openclaw start
此时打开浏览器输入 http://localhost:3000，即可进入管理界面，后续如需停止服务，在终端按下 Ctrl+C 即可。
注意：macOS/Linux 用户若出现权限报错，在命令前加上 sudo 即可（如 sudo npm i -g openclaw）；Windows 用户必须以管理员身份运行 PowerShell。
3. 总结
至此，已完成 OpenClaw 的本地安装，成功拥有了属于自己的 AI 执行助手。可以在本地后台完成基础的模型接入与插件安装，体验 OpenClaw 的核心能力。本地安装的优势是零成本、数据全程留在本机、隐私性强，完全能满足个人尝鲜与日常办公的需求。唯一的局限是电脑关机后服务就会停止，无法实现远程访问。