【连载】10分钟搭建你的第一个AI助手:龙虾入门第一课

收藏夹里躺了多少”等有时间再学”的工具？三个月后点开，发现和收藏那天一样新。

这不能怪你。很多工具安装文档就十几页，配环境、装依赖、配密钥……还没开始用，热情已经耗了一半。

OpenClaw不一样。它的安装体验是刻意做过的：一行命令、一次配置、一次启动，龙虾就跑起来了。

这篇文章只有一个目标：让你在10分钟内，把龙虾跑起来，看到它真的在工作。哪怕你完全不懂技术，按着步骤走，10分钟后你会有一个能帮你跑腿的AI助手。

我们开始。

有人可能会问：官网不是有详细文档吗，对着装不就行了？

没错。但我们这系列教程的出发点不一样。

这个系列不是给你一本参考手册，而是带你亲手把龙虾养起来。亲手安装过，你才会理解它是怎么运转的；亲手配置过，下次遇到问题你才知道去哪找原因。

另外，OpenClaw的安装体验本身就是它的一个卖点。Peter Steinberger（创始人）在设计的时候就希望这个过程足够简单，简单到任何人都能在10分钟内完成。

所以这篇文章的承诺是：跟着步骤走，10分钟内让龙虾跑起来。比你刷两集短视频快。

在开始之前，确认你的电脑满足以下条件：

支持的系统

• macOS 12及以上
• Linux（Ubuntu 20.04、Debian 11及以上）
• Windows 11 + WSL2（Windows Subsystem for Linux）

不支持Windows原生，需要通过WSL2。

需要安装的东西

• Node.js 18或更高版本
• npm（通常随Node.js一起安装）

检查你有没有Node.js

打开终端，输入：

node -v

如果显示版本号（如v20.10.0），说明你已经有Node.js了。

如果没有，去 nodejs.org 下载安装，或者用包管理器一行命令搞定：

macOS用Homebrew：

brew install node

Linux用apt：

sudo apt update && sudo apt install nodejs npm

Windows（WSL2）参考上面Linux的方法。

确认Node.js就位后，我们开始安装OpenClaw。

方式一：推荐——npm一行命令（5分钟）

这是最简单的方式。打开终端，执行：

npm install -g openclaw

等待安装完成，通常一两分钟。

验证安装成功：

openclaw --version

看到版本号（如0.1.0），说明安装完成。

方式二：备选——从源码跑起来

如果你想折腾，或者想第一时间用到最新功能，可以从源码安装：

git clone https://github.com/openclaw/openclaw.git cd openclaw npm install npm run build

这种方式需要本地有Git和Node.js环境。

常见安装报错

如果安装过程中看到EACCES权限错误，试试：

sudo npm install -g openclaw

或者选择正确的npm全局目录权限。

如果npm install很慢，切换到国内镜像：

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

安装完成后，你的电脑上就有OpenClaw了。但要让龙虾真正工作，还需要给它配置一个AI模型。

OpenClaw本身不提供AI能力，它需要调用大模型来”思考”。支持的主流模型包括：

• OpenAI系列（GPT-4、GPT-4o等）
• Anthropic系列（Claude 3.5等）
• 本地模型（Ollama支持的Llama、Qwen等）
• 其他兼容OpenAI API格式的模型

配置API密钥

OpenClaw的配置文件在用户目录下。执行以下命令创建配置：

mkdir -p ~/.openclaw cat > ~/.openclaw/config.json << 'EOF' {   "model": "openai/gpt-4o",   "apiKey": "your-api-key-here" } EOF

把 your-api-key-here 换成你从对应平台获取的API密钥。

新手推荐：先试MiniMax或Kimi

如果你不想花钱，或者只是想先体验，推荐用国内模型。MiniMax和Kimi都有免费额度，配置方法相同，只是apiKey不同：

cat > ~/.openclaw/config.json << 'EOF' {   "model": "minimax/MiniMax-M2.7",   "apiKey": "你的MiniMax密钥" } EOF

模型选择建议：新手先用云端模型（OpenAI/MiniMax/Kimi等）练手，等熟悉了再考虑本地模型。本地模型数据更私密，但配置相对麻烦，显存要求也高。

API密钥从哪里来？

• MiniMax：platform.minimaxi.com
• Kimi：platform.moonshot.cn
• OpenAI：platform.openai.com

注册后通常有免费额度，够你跑完这个系列教程。

配置完成，现在启动龙虾。

openclaw

你会看到一只龙虾的logo出现在终端里。如果看到了，说明龙虾已经成功启动了。

试着说一句话：

你好，给我做个自我介绍

龙虾会调用AI模型，回答你的问题。它会告诉你它能做什么、它叫什么名字——这些回答来自AI模型本身，所以每次可能略有不同。

这就是你亲手搭建的第一个AI助手。它已经在为你工作了。

如何退出

按 Ctrl+C 或者输入 exit 可以退出。

常用命令

openclaw --help    # 查看帮助 openclaw --version # 查看版本 openclaw status    # 查看状态

我们用不到10分钟，完成了以下事情：

• 确认/安装了Node.js环境
• 一行命令安装OpenClaw
• 配置了第一个AI模型
• 启动了龙虾，看到了它的工作状态

你的电脑上现在有一个能和你对话的AI助手了。但这只是开始——它还不会帮你干活，不会主动推送消息，也不懂你的个人偏好。

下一期，我们给它装上第一个技能：让它学会帮你查天气、发提醒，像一个真正的数字员工那样主动工作。

第2期预告：《让龙虾学会第一个技能：Sub-Agent与即时任务执行》

感兴趣的话，关注这个系列，我们继续。

本文是OpenClaw系列教程的第1期，讲解安装与首次启动。第0期介绍了龙虾是什么，第2期将讲解Sub-Agent与即时任务执行。