30分钟搞定！OpenClaw（小龙虾AI）保姆级搭建教程

OpenClaw 是一个开源的 AI 自动化中枢（AI Agent Runtime）。简单来说，它给大模型（如 GPT-4、通义千问、DeepSeek 等）装上了“手”和“脚”，让它不再只是聊天，而是能真正执行任务

小坏说Java · 2026-03-20 15:10:30 发布

你是否厌倦了每天手动整理文件、重复回复消息？今天，我们带来一款开源神器——OpenClaw（俗称小龙虾AI）。它不仅能听懂你的自然语言指令，还能直接操作你的电脑，实现文件管理、浏览器自动化、甚至自动发布公众号文章。

本文将从零开始，手把手教你如何在 Windows、macOS 及 Linux 系统上部署 OpenClaw，并解决国内网络环境下的常见报错。

OpenClaw 是一个开源的 AI 自动化中枢（AI Agent Runtime）。简单来说，它给大模型（如 GPT-4、通义千问、DeepSeek 等）装上了“手”和“脚”，让它不再只是聊天，而是能真正执行任务：

步骤 1：打开终端
按 Win + X，选择 Windows PowerShell（管理员）。

步骤 2：解除执行策略限制
为了允许运行远程脚本，输入以下命令并回车：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

输入 Y 确认。

步骤 3：执行一键安装脚本
国内用户强烈推荐使用加速镜像，速度更快：

iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex

（官方源：iwr -useb https://openclaw.ai/install.ps1 | iex）

脚本会自动检测并安装 Node.js（若未安装）及 OpenClaw 核心包，请耐心等待 3-8 分钟。

步骤 4：验证安装
安装完成后，关闭管理员窗口，重新打开一个普通 PowerShell 窗口，输入：

openclaw --version

若显示版本号（如 2026.3.x），则安装成功。

步骤 1：打开终端
macOS：打开“启动台” -> “其他” -> “终端”。
Linux：按 Ctrl + Alt + T。

步骤 2：执行一键安装脚本

# 国内加速镜像（推荐）
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash

# 官方源
# curl -fsSL https://openclaw.ai/install.sh | bash

步骤 3：验证安装

openclaw --version

安装完成后，运行初始化向导：

openclaw onboard

根据提示进行配置：

选择语言：选择 zh-CN（中文）。
配置模型：选择你的大模型提供商（如 OpenAI、DeepSeek、阿里云百炼等），输入 API Key。若暂无 Key，可选择 Skip for now 先体验基础功能。
权限授权：根据提示授权 OpenClaw 访问文件系统、浏览器等（建议先开启，后续可在 Web UI 中精细控制）。

启动服务：

openclaw gateway start

访问控制台：
浏览器打开 http://127.0.0.1:18789（默认端口），输入初始化时设置的管理员 Token 即可登录。

Windows 报错“无法加载文件…未对脚本进行数字签名”
解决：必须执行 步骤 2 的 Set-ExecutionPolicy 命令，且务必以管理员身份运行 PowerShell。
网络超时或下载缓慢
解决：使用上文提供的 国内加速镜像 地址（open-claw.org.cn），或配置 npm 国内源：
```
npm config set registry https://registry.npmmirror.com
```
端口 18789 被占用
解决：修改默认端口，例如改为 3000：
```
openclaw config set gateway.port 3000
openclaw gateway restart
```
安装后命令找不到（command not found）
解决：通常是因为环境变量未刷新。请关闭当前终端窗口，重新打开一个新终端再试。