在开始安装 OpenClaw 之前，请确保您的开发环境满足以下基本要求。无论使用何种操作系统，以下三项是必不可少的：
在终端中依次执行以下命令，确认环境就绪：
如果以上命令均返回版本号，说明基础环境已满足要求。
关键提示：Node.js 版本必须为 18 或以上。如果版本过低，请先通过 nodejs.org 下载安装 LTS 版本，或使用 nvm（Node Version Manager）进行版本管理。
macOS 用户可通过以下两种方式之一完成 OpenClaw 的安装。推荐使用 npm 全局安装方式，最为简洁。
打开终端（Terminal.app），执行以下命令：
安装完成后，验证是否成功：
如果正确输出版本号（如 v1.2.0），即表示安装成功。
对于习惯使用 Homebrew 的用户，也可以直接通过 brew 安装：
如果遇到 EACCES 权限错误，表示 npm 全局安装目录没有写入权限。解决方案：
sudo：sudo npm install -g openclawsudo如果遇到 "不受信任的开发人员" 提示导致命令无法运行，请前往 系统设置 > 隐私与安全性，点击 "仍要打开" 以允许 OpenClaw 执行。
Windows 用户可以使用 npm 全局安装或通过预编译的安装程序完成部署。
打开 PowerShell（建议以管理员身份运行），执行：
验证安装：
从 OpenClaw 的 GitHub Releases 页面下载 OpenClaw-Setup-x64.exe，双击运行安装向导即可。安装程序会自动将 OpenClaw 添加到系统 PATH 中。
Set-ExecutionPolicy RemoteSigned -Scope CurrentUseropenclaw 命令找不到，请确认 %APPDATA%\npm 已添加到系统环境变量 PATH 中如果在 PowerShell 中运行 openclaw 时出现 "无法加载文件...因为在此系统上禁止运行脚本" 的错误，请以管理员身份运行以下命令：
然后重新打开 PowerShell 即可。
Linux 用户可通过 npm 或各发行版的包管理器进行安装。以下以 Ubuntu / Debian 和 CentOS / RHEL 为例。
所有 Linux 发行版均适用：
验证安装：
Linux 系统中全局安装 npm 包需要 root 权限，因此 npm install -g 命令前需要加 sudo。如果希望避免使用 sudo，可以参考以下步骤配置用户级 npm 全局目录：
关键提示：Linux 环境下安装完成后，可能需要重新登录终端或执行 source ~/.bashrc（或 source ~/.zshrc）才能使 openclaw 命令生效。
安装完成后，需要进行 API Key 配置才能正常使用 OpenClaw 与 AI 模型通信的能力。OpenClaw 支持多种大语言模型（LLM）的后端接入。
OpenClaw 支持三种配置方式，优先级从高到低排列：
在终端中设置环境变量，配置后立即生效：
为了让配置持久化，可以将上述命令添加到 Shell 配置文件（如 ~/.bashrc、~/.zshrc 或 Windows 用户环境变量）中。
OpenClaw 会自动读取项目根目录下的 .env 文件：
首次运行 OpenClaw 时，如果没有检测到 API Key，系统会以交互式方式引导您输入：
切勿将 API Key 硬编码在代码中或提交到版本控制系统。建议将 .env 文件添加到 .gitignore 中，并优先使用环境变量方式配置。
配置完成后，即可向 OpenClaw 发送第一条指令，验证整个部署链路是否正常。
在终端中直接输入 openclaw 并回车，进入交互式对话界面：
OpenClaw 也支持非交互模式，直接执行单条指令并退出：
成功运行首条指令后，建议进一步验证以下核心功能是否正常工作：
OpenClaw 的核心能力在于 Tool Use。AI 模型可以在对话过程中自主决定调用哪些工具（如读写文件、执行命令、搜索网络等），从而完成复杂任务。开发者也可以通过自定义工具来扩展 OpenClaw 的能力边界。
以下表格汇总了安装过程中最常遇到的问题及其解决方案：
| 序号 | 问题现象 | 可能原因 | 解决方案 |
|---|---|---|---|
| 1 | command not found: openclaw |
npm 全局安装目录未在 PATH 中 | 将 $(npm root -g)/bin 添加到 PATH；Windows 用户检查 %APPDATA%\npm |
| 2 | EACCES: permission denied |
对 npm 全局目录没有写入权限 | 使用 sudo 安装，或配置 npm prefix 到用户目录 |
| 3 | Error: Cannot find module 'xxx' |
npm 依赖安装不完整 | 执行 npm cache clean --force 后重新安装 |
| 4 | 安装速度极慢或超时 | 网络原因，npm 官方源访问慢 | 配置国内镜像源：npm config set registry https://registry.npmmirror.com |
| 5 | PowerShell 中脚本无法运行 | Windows 执行策略限制 | Set-ExecutionPolicy RemoteSigned -Scope CurrentUser |
| 6 | Node.js 版本过低 | 系统 Node.js 版本低于 18.x | 使用 nvm 安装最新 LTS 版本：nvm install --lts |
| 7 | macOS "不受信任的开发者" 警告 | Apple Gatekeeper 安全机制 | 前往 系统设置 > 隐私与安全性，点击 "仍要打开" |
| 8 | Linux 下 openclaw 命令找不到 |
Shell 会话未重新加载 | 执行 source ~/.bashrc 或重新登录终端 |
如果上述方案均无法解决您的问题，请访问 OpenClaw 官方 GitHub 仓库提交 Issue，或在社区论坛中搜索类似问题。同时请确认您使用的 OpenClaw 版本与操作系统兼容。
npm install -g openclaw，各发行版另有专属包管理器方式openclaw -p "你好" 测试首次指令，验证安装成功关键提示：OpenClaw 的强大之处在于其工具调用（Tool Use）能力。完成基础部署后，建议进一步学习如何编写自定义工具、配置多模型切换以及使用会话管理功能，以充分发挥 OpenClaw 作为 AI Agent 开发框架的潜力。