夜雨聆风
OpenClaw（俗称“小龙虾”）是2026年备受关注的本地AI智能体框架，它能像一位“数字员工”一样，帮你自动整理文件、操作浏览器、编写文案甚至处理表格。由于其开源、免费且注重隐私（数据本地存储）的特性，吸引了大量用户。然而，许多新手在安装时容易被“部署”“脚本”等术语劝退。本文将为你提供一份详尽的保姆级安装指南，覆盖Windows和macOS系统，助你10分钟内成功部署，开启智能自动化之旅。
一、安装前必读：环境准备
在开始安装之前，请务必确认你的设备满足以下基础条件，这能帮你避免90%的安装失败问题。
**1. Windows 10或11（64位）**
**2. 内存：** 推荐8GB及以上，最低需4GB
**3. 硬盘空间：** 至少预留10GB可用空间
**4. 网络：** 安装过程需联网下载依赖，完成后可离线使用
**1. 核心运行环境：Node.js**
OpenClaw依赖Node.js环境运行，且版本必须≥22.0.0。
- **下载：** 访问Node.js官网，下载LTS（长期支持版）。
- **安装：** 运行安装包，务必勾选“Add to PATH”选项。
- **验证：** 安装完成后，打开命令行工具（Windows为PowerShell，Mac为Terminal），输入`node -v`。若显示v22.x.x版本号，则代表安装成功。
**2. 安装包管理工具：Git**
用于拉取必要的资源脚本。
- **下载安装：** 前往Git官网下载对应系统的安装包，一路默认选项安装即可。
**3. 解锁脚本执行权限（仅限Windows）**
这是新手最容易卡住的一步。Windows默认安全策略会阻止脚本运行，需手动开启权限。
- **操作：** 在开始菜单搜索“PowerShell”，右键选择“以管理员身份运行”。
- **执行命令：** 复制粘贴以下命令并回车：
`Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force`
执行完成后，无需任何输出，权限即已开启。
二、核心安装步骤
完成上述准备后，就可以正式开始安装OpenClaw了。
**1. 打开管理员权限的PowerShell**
这一步至关重要，权限不足会导致后续安装报错。
**2. 执行一键安装命令**
根据你的网络状况，选择以下任一命令复制粘贴并回车执行。
- **官方源（网络通畅时使用）：**
`iwr -useb https://openclaw.ai/install.ps1 | iex`
- **国内镜像（推荐国内用户使用，速度更快）：**
`iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex`
安装过程约需3-8分钟，请耐心等待窗口自动下载并配置环境，看到“Installation complete”提示即代表安装成功。
**1. 打开终端（Terminal）**
Mac用户可通过“Command + 空格”聚焦搜索“终端”打开。
**2. 执行一键安装命令**
复制以下命令并回车：
`curl -fsSL https://openclaw.ai/install.sh | bash`
系统可能会提示输入开机密码，输入后按回车即可。等待脚本自动执行完毕。
三、初始化与配置向导
安装成功并不代表可以直接使用，还需要进行初始化配置。
**1. 初始化配置**
在终端中输入以下命令并回车：
`openclaw onboard --install-daemon`
该命令会引导你完成初始设置，包括设置管理员密码、选择AI服务（新手建议先选云端API）、配置端口（默认18789）等。全程按回车使用默认选项即可。
**2. 启动服务**
配置完成后，需要启动OpenClaw的核心服务。在终端输入：
`openclaw gateway --port 18789`
保持此窗口开启状态，不要关闭。
**3. 打开控制面板**
服务启动后，OpenClaw会自动在浏览器中打开控制面板。如果未自动跳转，请手动访问：`http://localhost:18789`。看到界面即代表安装配置成功，你可以开始与你的本地AI助手对话了。
四、常见问题与避坑指南
在安装和使用过程中，你可能会遇到一些常见问题，以下是解决方案汇总：
| **问题现象** | **可能原因** | **解决方案** |
| ------ |------ |------ |
| **提示“禁止执行脚本”** | Windows默认安全策略限制 | 以管理员身份运行PowerShell，执行`Set-ExecutionPolicy RemoteSigned -Scope CurrentUser`命令并确认。 |
| **提示“不是内部或外部命令”** | 环境变量未生效或安装失败 | 1. 重启电脑。2. 检查Node.js安装时是否勾选了“Add to PATH”。3. 重新执行安装命令。 |
| **网页打不开或连接失败** | 端口被占用或防火墙拦截 | 1. 检查18789端口是否被其他程序占用。2. 暂时关闭防火墙或杀毒软件进行测试。 |
| **安装过程卡住或下载失败** | 网络波动或源不稳定 | 尝试使用国内加速镜像命令安装，或更换网络环境后重试。 |
| **配置文件报错** | 默认配置包含本地不存在的插件 | 手动编辑`C:\Users\你的用户名\.openclaw\openclaw.json`文件，删除无效的插件路径和通道配置块。 |
通过以上步骤，你应该能够顺利在自己的设备上安装并运行OpenClaw。这只“小龙虾”不仅能帮你处理日常繁琐的电脑工作，还能作为你探索AI自动化的得力助手。
