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 包全局安装
目前全球用户最常用的安装方式，稳定性强、支持一键更新、可灵活配置参数。
