OpenClaw 本地安装与配置指南：打造专属 AI 执行助手

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 的核心能力。本地安装的优势是零成本、数据全程留在本机、隐私性强，完全能满足个人尝鲜与日常办公的需求。唯一的局限是电脑关机后服务就会停止，无法实现远程访问。

OpenClaw 本地安装与配置指南：打造专属 AI 执行助手