Appearance
10分钟，装好小龙虾
很多人听说小龙虾很火，想试试，但卡在安装这一步。
这篇教程专为你准备：
- 零基础友好，每一步都写清楚
- 全平台覆盖，Windows/Mac/Linux 都有
- 避坑指南，踩过的坑都帮你填了
跟着做，10分钟跑通。
先选安装方式
OpenClaw 提供三种安装方式：
| 方式 | 难度 | 适合人群 | 推荐指数 |
|---|---|---|---|
| 官方脚本 | ⭐ 最简单 | 新手首选 | ⭐⭐⭐⭐⭐ |
| npm 安装 | ⭐⭐ 简单 | 有 Node.js 经验 | ⭐⭐⭐⭐ |
| 源码安装 | ⭐⭐⭐ 中等 | 开发者/想定制 | ⭐⭐⭐ |
新手建议： 直接用官方脚本，一条命令搞定。
方式一：官方脚本安装（推荐）
Windows 用户
前提条件：
- Windows 10 或更高版本
- 有管理员权限
步骤：
- 打开 PowerShell（管理员）
右键开始菜单 → Windows PowerShell（管理员）
- 运行安装命令
powershell
irm https://get.openclaw.ai | iex等待下载和安装，大约 2-3 分钟。
- 验证安装
powershell
claw --version显示版本号就成功了。
Mac 用户
前提条件：
- macOS 11 或更高版本
- 已安装 Homebrew（如果没有，先装）
步骤：
打开终端
运行安装命令
bash
curl -fsSL https://get.openclaw.ai | bash或者用 Homebrew：
bash
brew install openclaw- 验证安装
bash
claw --versionLinux 用户
步骤：
bash
# 一键安装
curl -fsSL https://get.openclaw.ai | bash
# 验证
claw --version方式二：npm 安装
适合已经装了 Node.js 的用户。
前提条件
| 软件 | 版本要求 |
|---|---|
| Node.js | 18.0 或更高 |
| npm 或 pnpm | 最新版 |
安装步骤
bash
# 用 npm
npm install -g openclaw
# 或用 pnpm（更快）
pnpm add -g openclaw
# 验证
claw --version常见问题
问题：command not found: claw
原因： PATH 没配置好
解决：
bash
# 查看 npm 全局路径
npm config get prefix
# 添加到 PATH（Mac/Linux）
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
# Windows 用户
# 手动把 npm 路径加到系统 PATH方式三：源码安装
适合开发者或想自己定制。
步骤
bash
# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# 安装依赖
pnpm install
# 构建
pnpm build
# 链接到全局
pnpm link --global
# 验证
claw --version安装后配置
装好之后，需要配置模型才能用。
快速配置（推荐新手）
运行向导：
bash
claw onboard按提示选择模型提供商，输入 API Key。
手动配置
编辑 ~/.clawrc.yaml：
yaml
# 选择模型提供商
provider: deepseek
# API Key
api_key: "sk-xxx"
# 模型选择
model: deepseek-chat获取 API Key
| 模型提供商 | 免费额度 | 获取地址 |
|---|---|---|
| DeepSeek | 注册送额度 | platform.deepseek.com |
| 豆包 | 免费使用 | www.doubao.com |
| 阿里百炼 | 新用户免费 | bailian.console.aliyun.com |
| 通义千问 | 有免费额度 | tongyi.aliyun.com |
新手推荐： DeepSeek，免费额度够用，中文友好。
验证安装
测试对话
bash
claw chat进入对话模式，输入：
你好，请介绍一下你自己如果小龙虾正常回复，恭喜你，安装成功！
测试功能
bash
# 查看版本
claw --version
# 查看配置
claw config list
# 查看状态
claw status新手避坑指南
坑 1：安装失败，网络超时
原因： 国内访问 GitHub 或 npm 慢
解决：
- 用国内镜像
- 开代理
- 用官方脚本（会自动选最快源）
坑 2：command not found: claw
原因： PATH 没配好
解决： 见上文 npm 安装的常见问题
坑 3：API Key 无效
原因：
- Key 填错了
- Key 过期了
- 账户没余额了
解决：
- 重新复制 Key，确保没有多余空格
- 登录平台检查账户状态
- 换一个模型试试
坑 4：模型报错
原因： 模型名称填错了
解决：
bash
# 查看支持的模型
claw models list
# 设置正确的模型名
claw config set model deepseek-chat坑 5：Windows 报"无法运行脚本"
原因： PowerShell 执行策略限制
解决：
powershell
# 以管理员运行 PowerShell，执行：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser硬件要求
OpenClaw 本身对硬件要求很低：
| 配置级别 | 内存 | 存储 | 用途 |
|---|---|---|---|
| 最低 | 4GB | 64GB | 搭配云 API |
| 推荐 | 8GB | 128GB | 日常使用 |
| 进阶 | 16GB+ | 256GB+ | 运行本地模型 |
普通用户： 4GB 内存 + 云 API 就够了，不需要显卡。
下一步
装好之后，你可以：
- 试试对话：
claw chat - 接入微信/钉钉/飞书：看相关教程
- 安装技能：
claw skill install xxx - 开发自己的 Skill：看 Skill 开发教程
总结
安装 OpenClaw，记住这三步：
| 步骤 | 内容 |
|---|---|
| 1. 安装 | 官方脚本一条命令 |
| 2. 配置 | claw onboard 或手动配置 |
| 3. 验证 | claw chat 测试对话 |
新手常见问题 90% 都是网络和 PATH，遇到问题先检查这两个。
