一、OpenClaw 是什么?
OpenClaw(社区俗称「小龙虾」)是一款可本地/自建的开源 AI 助手,特点是「能干活」:除对话外,支持浏览器自动化、桌面控制、向量记忆、定时任务等,并可通过 Gateway 接入微信、飞书、Telegram、Discord 等渠道。技术栈以 Node.js 为核心,适合作为「AI + 自动化 + 多端接入」的练手或生产项目。
本文以学习 + AI + 前端为场景,手把手带你完成安装与第一次配置。
二、安装前准备
2.1 系统与硬件
- 系统:Windows 10/11、macOS 12+(推荐 14+)、或 Linux(如 Ubuntu 20.04+、Debian 11+)
- 内存:至少 2GB,推荐 4GB 以上
- 磁盘:预留约 500MB
- 网络:需要联网(调用各类 AI API)
2.2 必装环境:Node.js
OpenClaw 依赖 Node.js 22 或更高版本(推荐 LTS)。若未安装:
- 官网下载:https://nodejs.org/
或用 nvm 管理多版本:
# 安装并切换到 Node 22
nvm install 22
nvm use 22
安装后验证:
node -v
npm -v
# 应 >= v22.x.x
2.3 准备一个 AI API Key(必选)
OpenClaw 本身免费,但需要接入一家 AI 服务商的 API:
- 新手推荐:MiniMax — 国内直连、可免费试用约 7 天,无需信用卡
- 其他可选:Claude、GPT、DeepSeek、通义等(按官方文档配置对应 Key 即可)
先到所选平台注册账号,在控制台里拿到 API Key,安装完成后在配置向导里填入。
三、安装方式(任选其一)
方式一:一键脚本(最省事)
Windows(PowerShell,以管理员身份运行):
iwr -useb https://clawd.org.cn/install.ps1 -OutFile install.ps1; ./install.ps1
macOS / Linux:
curl -fsSL https://openclaw.ai/install.sh | bash
也可使用带参数的安装(例如指定 git 方式):
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
脚本会自动处理依赖,一般 3~5 分钟即可完成。
方式二:npm / pnpm 全局安装(适合前端同学)
已熟悉 Node 生态的话,可以直接:
npm install -g openclaw
pnpm add -g openclaw@beta

