ORANGE BOOK · OPENCLAW

第二章 五分钟快速上手

一、动手前的 3 分钟准备

我们先确保你不会在动手之后才发现"哎呀少了什么东西"。

1.1 你需要这些东西

必需品 怎么确认
一台电脑 macOS 12+ / Windows 10+ / 主流 Linux 都行，4GB 内存以上
网络 能正常访问 npm 和 GitHub（国内有加速方案，下面会讲）
Node.js v22 或更高 打开终端运行 node -v，看到 v22.x.x 或更高即可
一个大模型的 API Key 第三章会详细教，本章你可以先跳过模型配置走"试用模式"

1.2 不会打开"终端"怎么办

如果你从来没用过终端，先记住怎么打开它：

  • macOS：按 Command + 空格，输入 terminal，回车。
  • Windows：按 Win 键，输入 powershell，右键选"以管理员身份运行"。
  • Linux：通常在应用程序里有"Terminal"或"终端"，或者按 Ctrl + Alt + T。

打开后会看到一个黑色（或白色）的窗口，光标在闪。这就是终端。复制粘贴命令，回车，就够了，本书不要求你手敲任何命令。

1.3 检查 Node.js 是否就绪

在终端里输入：

node -v

回车，你会看到三种结果：

  • 看到 v22.x.x 或更高（如 v22.12.0）：完美，跳到第二节。
  • 看到 v20.x.x 或更低：版本太老，先升级。
  • 看到 command not found: node 或 'node' 不是内部或外部命令：还没装，先装。

如果需要安装/升级 Node.js

最省心的办法是用 nvm（Node Version Manager）。

macOS / Linux：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 关闭终端再重新打开
nvm install 22
nvm use 22

Windows：

去 nvm-windows 发布页 下载 nvm-setup.exe，安装后在 PowerShell 里：

nvm install 22.12.0
nvm use 22.12.0

国内用户加速（可选，但强烈建议）：

# 让 nvm 走国内镜像
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node

# 让 npm 走国内镜像
npm config set registry https://registry.npmmirror.com

再次运行 node -v，看到 v22.x.x 就 OK 了。

二、安装 OpenClaw（三种方式任选一种）

方式一（推荐 90% 人使用）：一键脚本

macOS / Linux：

curl -fsSL https://openclaw.ai/install.sh | bash

Windows（管理员模式 PowerShell）：

iwr -useb https://openclaw.ai/install.ps1 | iex

脚本会自动检查环境、下载安装包、配置 PATH 环境变量。看到最后一行出现：

✓ OpenClaw installed successfully. Run `openclaw onboard` to get started.

就成功了。

方式二（推荐前端开发者）：npm 全局安装

npm install -g openclaw@latest

国内用户如果慢，加镜像：

npm install -g openclaw@latest --registry https://registry.npmmirror.com

方式三（推荐对终端不熟悉的）：云服务器一键模板

如果你不想在自己电脑上折腾，可以租一台轻量云服务器（每月约 30 元），各家厂商已经做了 OpenClaw 一键模板：

  • 阿里云：搜"OpenClaw 镜像"
  • 腾讯云：搜"OpenClaw 一键部署"
  • DigitalOcean：搜"OpenClaw Droplet"

下单 3 分钟即可拥有一个云端的 OpenClaw，从此随时随地通过 Web 或微信用它。

验证安装是否成功

无论哪种方式，安装完都跑这条命令验证：

openclaw -v

看到类似 openclaw 2.6.1 这样的版本号就 OK。如果提示 command not found，跳到本章末尾的"5 个常见报错"。

三、首次启动：跑一遍 onboarding

第一次用，OpenClaw 提供了一个交互式的引导向导，会一步步问你：用哪个模型、要不要装常用 Skill、要不要把它后台跑起来。

openclaw onboard --install-daemon

参数说明：

  • --install-daemon：把 OpenClaw 装成"开机自启"的后台服务。如果你不希望它一直在后台，去掉这个参数即可。

引导会问你以下几件事，每件都给出推荐答案：

问题 推荐答案 说明
Choose your default model provider DeepSeek 国内用户首选，便宜；海外用户可选 OpenAI
API Key 暂时跳过 选"Skip for now"或"试用模式"
Install recommended skills? Yes 默认会装 8 个最常用 Skill
Enable file system access? Yes 不开它就废了一半
Enable web browser? Yes 想让它会上网就选 Yes
Telemetry? No 想保护隐私就关掉

重要：如果你在 API Key 这一步选了"跳过"，OpenClaw 会进入试用模式——只能用官方提供的免费额度（每天约 20 次调用），用来体验完全够。要做"整理下载文件夹"这种正经任务，你需要回到下面"四、把'大脑'装上"那一节，给它配一个真实的大模型。

跑完之后，你会在用户目录下看到一个新文件夹：

  • macOS / Linux：~/.openclaw/
  • Windows：C:\Users\你的用户名\.openclaw\

里面是你的所有配置、Skills、日志、缓存。整个 OpenClaw 的"家"就在这里，备份这一个文件夹就备份了一切。

四、把"大脑"装上（最简版）

OpenClaw 自己不会想问题，它需要一个大模型当大脑。模型配置详细教程在 第三章，本章给你一个"五分钟最简版"，让你立刻能跑通第一个任务。

我们以国内最便宜、最稳的 DeepSeek 为例。

步骤 1：去 DeepSeek 官网注册并拿 Key

  1. 打开 https://platform.deepseek.com
  2. 用手机号注册，新用户送 5 元额度（够你跑几千次任务）。
  3. 登录后进入"API Keys"页面，点"创建新 API Key"，复制下来（只显示一次，复制好）。

步骤 2：配置到 OpenClaw

在终端运行：

openclaw models add

按提示选择 deepseek，粘贴你的 API Key，再选默认模型为 deepseek-chat（便宜、快）或 deepseek-reasoner（贵但聪明）。

设为默认：

openclaw models set-default deepseek/deepseek-chat

测试是否通了：

openclaw models test deepseek/deepseek-chat

看到 ✓ Model is reachable，就 OK 了。

海外用户/想用其他模型的，请直接看 第三章。流程几乎一样。

五、第一个任务：让 OpenClaw 帮你整理下载文件夹

终于到了见证奇迹的时刻。我们让 OpenClaw 替你整理一下乱成一锅粥的下载文件夹。

启动交互界面

在终端运行：

openclaw tui

tui 是 "Text User Interface" 的缩写，会在终端里弹出一个漂亮的对话界面。

不喜欢终端界面？可以用网页界面：

openclaw web

然后浏览器自动打开 http://localhost:7788。本书后面默认用 tui，但两个界面操作完全一样。

把这段话复制粘贴进去

请帮我整理一下我的下载文件夹（macOS 是 ~/Downloads，Windows 是 C:\Users\我的用户名\Downloads）。
要求：
1. 按文件类型分类：图片、视频、文档、压缩包、安装包、其他，每类一个子文件夹。
2. 超过 30 天没有访问过的文件，统一移到「归档」子文件夹。
3. 同名文件不要覆盖，加 (1)(2) 之类的后缀。
4. 整理完给我一份简短的报告：每类各多少个文件、总共节省了多少空间。

执行前请先把你的整理计划告诉我，等我确认后再动手。

按回车（或界面上的"发送"按钮）。

OpenClaw 的反应

接下来你会看到这样的过程：

  1. 它先读你的下载文件夹，列出文件。
  2. 它识别文件类型，按你的规则分组。
  3. 它先把整理计划告诉你，比如"打算把 ABC.zip 移动到 压缩包/，把 photo.jpg 移动到 图片/，把 setup.exe 移动到 安装包/，预估 142 个文件被分类，34 个文件被归档"。
  4. 它等你确认。你说"OK"，它才真的动手。
  5. 它汇报结果：图片 23 个，视频 4 个，文档 88 个，安装包 17 个，其他 10 个；归档 34 个；耗时 6 秒。

恭喜你，你刚刚指挥了一个 AI 员工完成了一个真实任务。

建议：第一次运行先在一个不重要的文件夹（比如新建一个"测试"文件夹，里面塞几个文件）尝试，确认效果满意，再对真正的下载文件夹动手。

六、本节进阶：给它"留一个家"

很多人跑通第一个任务就以为完事了，其实你还少做一步——告诉 OpenClaw 你的偏好。

在终端运行：

openclaw memory add

它会让你输入一段"长期记忆"。我们建议你贴这段：

我的电脑系统是：[macOS 14.5 / Windows 11 / Ubuntu 22.04 选一个写]
我的下载文件夹路径：[贴你自己的路径]
我的工作偏好：
- 任何会修改/删除文件、发邮件、发消息、调外部 API 的操作，都先告诉我计划再执行；
- 输出报告默认用中文；
- 默认行为风格：高效但礼貌，少废话；
- 我的常用工具是：微信、Notion、飞书、VS Code；
- 默认时区：Asia/Shanghai。

这段记忆会在你之后的每个任务里自动注入，OpenClaw 会按照你的偏好工作，不再每次都问。

详细的"上下文/记忆/提示词"系统在 第四章 讲。

七、五个新手最容易踩的报错

报错 1：command not found: openclaw

原因：安装成功，但 PATH 环境变量没有正确设置。

解决：

  • macOS / Linux：打开 ~/.zshrc 或 ~/.bashrc，加一行：
    export PATH="$HOME/.openclaw/bin:$PATH"
    然后 source ~/.zshrc。
  • Windows：重启 PowerShell 一次。如果还不行，去"系统设置 → 环境变量"里检查 PATH 是否包含 %USERPROFILE%\.openclaw\bin。

报错 2：Node version too low. Required: >=22.0.0, found: v20.x.x

原因：Node.js 版本不够。

解决：参照本章"1.3 检查 Node.js 是否就绪"里的方法升级到 22+。

报错 3：EACCES: permission denied（macOS / Linux）

原因：你用了 sudo 或 npm 的全局安装权限有问题。

解决：不要用 sudo 装 OpenClaw。改用 nvm 装 Node，或者用一键脚本。如果已经用了 sudo 装坏了，先删除：

sudo npm uninstall -g openclaw
rm -rf ~/.openclaw

然后重装。

报错 4：Failed to fetch from registry.npmjs.org

原因：网络问题，国内访问 npm 慢或被拦。

解决：换镜像。

npm config set registry https://registry.npmmirror.com
npm install -g openclaw@latest

或者用一键脚本，脚本里已经内置了国内镜像逻辑。

报错 5：Error: ENOENT: no such file or directory, open '~/.openclaw/openclaw.json'

原因：没跑过 openclaw onboard，配置文件还没生成。

解决：

openclaw onboard

跑完就会自动生成配置。

更全的报错对照表请看 第十一章 避坑指南。

八、确认你已经过关

跑通本章你应该能做到：

  • 在终端运行 openclaw -v 看到版本号；
  • 在终端运行 openclaw status 看到状态正常；
  • 至少配置了一个大模型（哪怕只是试用模式）；
  • 完成了"整理下载文件夹"的练习，并且看懂了它的过程；
  • 写了一段自己的 openclaw memory。

如果以上 5 项都打勾，恭喜你已经迈过了 80% 普通用户的第一道门槛。可以开始读下一章。

如果有任何一项卡住，别硬刚，去看 第十一章 避坑指南 或在评论区/社区提问，常见问题十有八九能找到答案。

本章一图回顾

   准备 (3 分钟)            安装 (1 分钟)         初始化 (1 分钟)
┌────────────────┐      ┌────────────────┐      ┌────────────────┐
│ Node 22+       │  →   │ 一键脚本/npm   │  →   │ openclaw       │
│ 终端能打开     │      │                │      │   onboard      │
│ DeepSeek Key   │      │                │      │ 装常用 Skill   │
└────────────────┘      └────────────────┘      └────────────────┘
                                                          │
                                                          ↓
                                                 ┌────────────────┐
                                                 │ openclaw tui   │
                                                 │ 第一个任务     │
                                                 │ "整理下载夹"   │
                                                 └────────────────┘

下章预告

工具已经能跑了，接下来要做的事，是给它配一个真正合适的大脑——也就是大模型。下一章 第三章 给它装上大脑 我们会把 DeepSeek、Kimi、GPT、Claude、Gemini、本地 Ollama 全部讲一遍，并教你一套"主大脑 + 廉价副脑"的省钱组合，让你每月 AI 开销控制在 10 元以内。