🦞 gobuildit

🦞 OpenClaw 小龙虾完全新手指南

📖 阅读约 25 分钟 🎯 零编程基础友好 🔄 2026 年 3 月更新
PHASE 01

什么是 OpenClaw(小龙虾)?

一句话版本:OpenClaw 是一个住在你电脑上的 AI 员工,你通过微信、Telegram、WhatsApp 给它发消息,它就帮你干活。

和 ChatGPT 到底有什么区别?

你肯定用过 ChatGPT——打开网页,问一个问题,它给你一个答案。这叫聊天机器人(ChatBot),本质是「问答」。

OpenClaw 不一样。它不只是聊天,它能真正动手做事

  • 帮你查资料并整理成文档
  • 帮你管理日程、发提醒
  • 帮你写文案、做翻译、处理表格
  • 帮你操作电脑上的文件
  • 7 x 24 小时在线,随时待命

类比:ChatGPT 像一个只会动嘴的顾问——你问它建议,它给建议,但活儿还是你自己干。OpenClaw 像一个真正的员工——你吩咐一声,它就去做了。

小龙虾的前世今生

OpenClaw 原名 Clawdbot,2025 年 11 月由奥地利开发者 Peter Steinberger 一个人做出来。2026 年 1 月突然爆红,72 小时内在 GitHub 拿到 6 万颗星。

Karpathy(特斯拉前 AI 总监)评价它是「最不可思议的科幻式事件」。

后来因为名字里有「Claud」容易和 Claude 混淆,先改名 Moltbot,最终定名 OpenClaw。中文圈给它取了个绰号——小龙虾 🦞。

💡 它到底在哪里运行?

在你自己的电脑上。你的数据、对话、记忆全部存在你的本地硬盘里,不经过任何第三方服务器。这是 OpenClaw「本地优先」的核心设计理念。

真实应用场景

📝
自媒体 / 公众号
自动收集热点 → 写文章 → 排版 → 推送到公众号草稿箱,10 分钟搞定
📊
职场人
自动整理会议纪要、跟踪待办、生成周报、每天 9 点推送 AI 资讯
💻
开发者
自动处理 backlog issue、追踪 bug、提交 PR,你忙的时候它帮你干
🛒
电商 / 小红书
自动收集竞品数据、生成种草文案、定时发布
PHASE 02

📋 准备工作

安装小龙虾之前,你需要准备两样东西。别担心,都是免费的。

安装 Node.js(运行环境)

Node.js 是让小龙虾能在你电脑上跑起来的「底层引擎」。打开 nodejs.org,下载左边那个 LTS 版本(长期支持版),一路下一步装好。

装完之后,打开终端(Mac 叫「终端」,Windows 叫「PowerShell」),输入:

终端node --version

如果显示 v22.x.x 或更高版本,就说明装好了。

准备一个 AI 模型的 API Key

小龙虾本身不自带「大脑」——它需要连接一个 AI 模型来思考。你可以选择:

模型价格推荐度
Kimi 2.5(月之暗面)100 万 token 约 1 元国内首选,性价比之王
Claude(Anthropic)按量付费能力最强,但贵
GPT-4o(OpenAI)按量付费也不错,但需翻墙
💡 为什么推荐 Kimi 2.5?

Kimi 2.5 的缓存命中率高达约 90%,100 万 token 实际成本仅约 1 元人民币(标准价 4 元的 25%)。对比 OpenAI 高强度使用一天几十到上百美元,省钱效果明显。

去对应的官网注册账号,在「API Keys」页面创建一个 Key,复制保存好。

⚠️ Kimi API Key 注意事项

国内注册选 .cn 域名,国外注册选 .ai 域名。编程套餐的 Key 和普通 Key 不通用,一定要严格对应来源渠道。

⚠️ API Key 是你的「钱包钥匙」

谁拿到你的 API Key,谁就能用你的钱调用 AI。千万别发到群里、别上传到 GitHub、别截图发朋友圈。

PHASE 02

⚡ 一键安装

打开终端,根据你的操作系统,复制粘贴对应的命令:

Mac / Linux

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

Windows(PowerShell)

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

或者用 npm 安装(如果你知道 npm 是什么的话)

npmnpm install -g openclaw@latest

等命令跑完,输入以下命令验证:

终端openclaw --version

看到版本号?恭喜,安装成功。

💡 什么是终端?

Mac:按 Cmd + 空格,搜「终端」,回车打开。
Windows:按 Win 键,搜「PowerShell」,回车打开。
就是那个黑色(或蓝色)的输入框,看着吓人但其实就是个「打字发命令」的工具。

💡 小白福音:用 AI 编辑器装

打开 Cursor 或 Windsurf 等 AI 编辑器,在里面的终端输入安装命令。遇到报错时,选中终端输出直接问右侧的 AI——不管是看不懂的配置文件、概念还是报错信息,AI 都能帮你解释和解决。

安装向导会问你什么?

运行 openclaw 后会启动安装向导,依次配置:

选择模型

填入你的 API Key(推荐 Kimi 2.5)

选择通讯软件

Telegram / 飞书 / WhatsApp / Discord 等

配置 Skills(可跳过)

后面在管理面板里也能装

配置守护进程

选「是」——电脑重启后小龙虾会自动启动

完成后会自动打开网页版管理面板,你的小龙虾就上线了。

PHASE 03

🚀 第一次对话

安装完了,让我们把小龙虾叫醒。

启动 Gateway(网关)

Gateway 是小龙虾的「总机」,负责接收和分配消息。在终端输入:

终端openclaw start

你会看到一条消息告诉你 Gateway 已经在后台运行了。

打开控制面板

在浏览器里打开 http://localhost:3210(或者终端提示的地址)。你会看到一个简洁的聊天界面——这就是小龙虾的「控制面板」。

发送第一条消息

在输入框里打一句话,比如:

对话帮我用一段话介绍一下你自己

小龙虾会思考几秒钟,然后给你回复。

发生了什么?

看起来和 ChatGPT 没区别?其实背后完全不同:

你发消息Gateway 收到(小龙虾的总机)
  → 路由到 Agent(分配给对应的助手)
  → Agent 思考(调用 AI 模型 + 本地工具)
  → 结果返回给你

关键区别:小龙虾在第三步不只是「想」,它还会调用工具来「做」。这就是 Agent 和 ChatBot 的本质区别。

PHASE 03

📁 工作空间

小龙虾的所有「记忆」和「规则」都放在一个叫 Workspace 的文件夹里。你可以把它理解为小龙虾的「工位」。

~/.openclaw/
├── openclaw.json ← 主配置文件(小龙虾的「入职登记表」)
├── workspace/ ← 工作空间根目录
│ ├── AGENTS.md ← 工作手册(你希望它怎么干活)
│ ├── SOUL.md ← 性格设定(它用什么语气说话)
│ ├── MEMORY.md ← 长期记忆(它记住的事情)
│ ├── TOOLS.md ← 工具清单(它会用什么工具)
│ ├── IDENTITY.md ← 身份信息(它叫什么名字)
│ ├── USER.md ← 关于你(它对你的了解)
│ └── skills/ ← 技能目录(已安装的技能)
├── agents/ ← 多助手配置
└── credentials/ ← API Key 存放处
文件白话解释什么时候改?
AGENTS.md写你想让 AI 遵守的规则和工作流程想调整它的工作方式时
SOUL.md设定 AI 的性格、说话风格、底线想改变它的「人设」时
MEMORY.mdAI 自动记录的长期记忆一般不用手动改
USER.md你的个人信息,让 AI 更了解你想让它记住你的偏好时
💡 这些文件全是普通的 Markdown 文本

用任何文本编辑器都能打开修改。不需要学编程,会打字就行。

PHASE 04

📱 连接聊天软件

小龙虾最酷的功能之一:你可以通过日常用的聊天软件直接跟它对话。以 Telegram 为例(最容易配置):

创建 Telegram Bot

在 Telegram 里搜索 @BotFather,发送 /newbot,按提示取个名字,你会收到一个 Bot Token

在配置文件中添加 Telegram 渠道

打开 openclaw.json,在 channels 里加入:

json{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "你的 Bot Token 粘贴到这里"
    }
  }
}

重启小龙虾

终端openclaw restart

现在打开 Telegram,给你的 Bot 发条消息试试!

支持哪些聊天软件?

📨
Telegram
最推荐,配置最简单
💚
WhatsApp
需要 Twilio 账号
🎮
Discord
适合社群场景
🔧
自定义
API 接入任意平台
PHASE 04

⚙️ 配置文件入门

openclaw.json 是小龙虾的「入职登记表」。刚装好的时候它已经有默认值了,但你可以根据需要调整。

json5{
  // 助手配置
  "agents": [{
    "name": "小助手",
    "model": "claude-sonnet-4-6",      // 用哪个 AI 模型
    "workspace": "./workspace"         // 工作空间路径
  }],

  // 聊天渠道
  "channels": {
    "telegram": { "enabled": true, "botToken": "..." }
  },

  // 会话设置
  "session": {
    "resetMode": "daily",              // 每天重置对话记忆
    "maxTokens": 100000                // 单次对话最大长度
  }
}
💡 这个文件支持 JSON5 格式

你可以写注释(// 像这样)、末尾可以多一个逗号。比标准 JSON 宽松很多,对新手更友好。

PHASE 04

🔒 安全设置

如果你把小龙虾连上了 Telegram 等聊天软件,别人也可能给你的 Bot 发消息。你需要设置谁能跟它说话

策略白话解释适合谁
pairing 陌生人发消息需要你手动批准 大多数人(默认推荐
allowlist 只有白名单里的人能说话 只想让特定人使用
open 所有人都能跟它聊 公开的客服 Bot
disabled 关闭私聊功能 只在群里用
⚠️ 新手请保持默认的 pairing 模式

千万别图方便设成 open。任何人给你的 Bot 发消息都会消耗你的 API 额度(也就是你的钱)。

PHASE 05

🤖 多助手协作

一个小龙虾不够?你可以同时养好几只,让它们各司其职。

比如这样分工

✍️
写作助手
专门帮你写文案、改稿子
📅
日程助手
管理待办、发送提醒
🔍
调研助手
搜索信息、整理资料

配置方法:在 openclaw.jsonagents 数组里加入多个助手:

json{
  "agents": [
    {
      "name": "写作助手",
      "model": "claude-sonnet-4-6",
      "workspace": "./workspace/writer"
    },
    {
      "name": "日程助手",
      "model": "claude-haiku-4-5",
      "workspace": "./workspace/scheduler"
    }
  ]
}
💡 省钱技巧

不是每个助手都需要最强大脑。简单任务(日程提醒、格式转换)用便宜的模型,复杂任务(写代码、分析)用强模型。在对话中输入 /model 提供方 模型名 可随时切换。

创建新 Agent 只需一行命令

终端openclaw agents add dailynews

向导会引导你:创建工作空间 → 是否复制主 Agent 配置 → 选择模型 → 绑定独立的 Telegram 机器人。完成后每个 Agent 拥有独立的 workspace 和 memory。

子 Agent:自动并发处理批量任务

无需手动设置。当你给主 Agent 一个批量任务时,它会自动派生子 Agent 并发执行

对话同时查询北京、上海、杭州、深圳今天的实时天气

小龙虾会自动创建 4 个子 Agent 并发查询,完成后汇总结果返回。用 /subagents list 可查看子 Agent 状态。

PHASE 05

🧩 安装技能

技能(Skill)就像手机上的 App——给小龙虾装上新技能,它就能做更多事。

三种安装方式

🖥️
管理面板内置
最简单,打开面板 → Skills 页面 → 点击安装
🏪
ClawHub 官方市场
数百个 Skill,用 clawhub install 命令安装
npx skills add(推荐)
Vercel 出品,跨平台通用,可装整个仓库

方式一:ClawHub 市场

安装 CLI 工具(首次)

终端npm install -g clawhub

搜索并安装技能

终端clawhub search "天气"
clawhub install @openclaw/weather

重启生效

终端openclaw gateway restart

新装的 Skill 需要重启网关才能被 Agent 识别到。

方式二:npx skills add(最推荐)

Vercel 推出的跨平台 Skill 安装工具,适用于 OpenClaw、Claude Code、Codex 等所有工具。

终端# 安装整个仓库的所有 skills
npx skills add jimliu/baoyu-skills

# 安装单个 skill
npx skills add <skill 链接>

安装时会让你选目标平台(OpenClaw / Claude Code)和安装范围(全局 / 项目级)。

实战案例:让小龙虾自动写公众号文章

安装 post-to-wechat Skill 后,直接在对话中说:

对话收集 Deepseek V4 的最新信息,写一篇公众号文章,推送到草稿箱

小龙虾会自动联网搜索 → 整理信息 → 撰写文章 → 排版 → 推送到公众号后台草稿箱。全程约 10 分钟,你只需要最后审核一下就能发布。

新手推荐技能

技能功能
@openclaw/weather查天气
@openclaw/web-search联网搜索
@openclaw/image-genAI 画图
@openclaw/reminder定时提醒
@openclaw/translator多语言翻译
@openclaw/githubGitHub 操作
💡 技能市场

clawhub.com 可以浏览所有可用技能。社区贡献的技能越来越多,总有一款适合你。

PHASE 05

⌨️ 常用命令速查

不用全记住,收藏这页随时查就行。

命令干什么用
openclaw start启动小龙虾
openclaw stop关掉小龙虾
openclaw status看看它是不是在运行
openclaw restart重启(改了配置后用)
openclaw doctor自检(出问题先跑这个)
openclaw logs查看运行日志
clawhub search "关键词"搜索技能
clawhub install 技能名安装技能
clawhub update --all更新所有已装技能
PHASE 05

🔧 常见问题

小龙虾启动不了?

先跑 openclaw doctor,它会自动检测问题。
最常见的原因:Node.js 版本太低(需要 ≥ 22)。

发消息没有回复?

检查你的 API Key 是否正确配置。在终端运行 openclaw logs 查看错误信息。
如果看到 401 Unauthorized,说明 API Key 过期或写错了。

回复很慢?

可能是网络问题(API 请求需要翻墙),或者你选的模型太大(试试换成 Haiku)。
也可能是 API 服务商那边在排队——高峰期正常。

想重新来过?

终端openclaw stop
rm -rf ~/.openclaw    # 删除所有配置
openclaw start        # 重新初始化

这会清掉小龙虾的所有记忆和配置,从零开始。

🔗 资源链接

教程看完了,接下来呢?

和真正在用的人一起交流,少走弯路。

查看社区与课程 →