🦞 OpenClaw 小龙虾完全新手指南
什么是 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「本地优先」的核心设计理念。
真实应用场景
📋 准备工作
安装小龙虾之前,你需要准备两样东西。别担心,都是免费的。
安装 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 的缓存命中率高达约 90%,100 万 token 实际成本仅约 1 元人民币(标准价 4 元的 25%)。对比 OpenAI 高强度使用一天几十到上百美元,省钱效果明显。
去对应的官网注册账号,在「API Keys」页面创建一个 Key,复制保存好。
国内注册选 .cn 域名,国外注册选 .ai 域名。编程套餐的 Key 和普通 Key 不通用,一定要严格对应来源渠道。
谁拿到你的 API Key,谁就能用你的钱调用 AI。千万别发到群里、别上传到 GitHub、别截图发朋友圈。
⚡ 一键安装
打开终端,根据你的操作系统,复制粘贴对应的命令:
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」,回车打开。
就是那个黑色(或蓝色)的输入框,看着吓人但其实就是个「打字发命令」的工具。
打开 Cursor 或 Windsurf 等 AI 编辑器,在里面的终端输入安装命令。遇到报错时,选中终端输出直接问右侧的 AI——不管是看不懂的配置文件、概念还是报错信息,AI 都能帮你解释和解决。
安装向导会问你什么?
运行 openclaw 后会启动安装向导,依次配置:
选择模型
填入你的 API Key(推荐 Kimi 2.5)
选择通讯软件
Telegram / 飞书 / WhatsApp / Discord 等
配置 Skills(可跳过)
后面在管理面板里也能装
配置守护进程
选「是」——电脑重启后小龙虾会自动启动
完成后会自动打开网页版管理面板,你的小龙虾就上线了。
🚀 第一次对话
安装完了,让我们把小龙虾叫醒。
启动 Gateway(网关)
Gateway 是小龙虾的「总机」,负责接收和分配消息。在终端输入:
终端openclaw start
你会看到一条消息告诉你 Gateway 已经在后台运行了。
打开控制面板
在浏览器里打开 http://localhost:3210(或者终端提示的地址)。你会看到一个简洁的聊天界面——这就是小龙虾的「控制面板」。
发送第一条消息
在输入框里打一句话,比如:
对话帮我用一段话介绍一下你自己
小龙虾会思考几秒钟,然后给你回复。
发生了什么?
看起来和 ChatGPT 没区别?其实背后完全不同:
你发消息 → Gateway 收到(小龙虾的总机) → 路由到 Agent(分配给对应的助手) → Agent 思考(调用 AI 模型 + 本地工具) → 结果返回给你
关键区别:小龙虾在第三步不只是「想」,它还会调用工具来「做」。这就是 Agent 和 ChatBot 的本质区别。
📁 工作空间
小龙虾的所有「记忆」和「规则」都放在一个叫 Workspace 的文件夹里。你可以把它理解为小龙虾的「工位」。
├── 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.md | AI 自动记录的长期记忆 | 一般不用手动改 |
USER.md | 你的个人信息,让 AI 更了解你 | 想让它记住你的偏好时 |
用任何文本编辑器都能打开修改。不需要学编程,会打字就行。
📱 连接聊天软件
小龙虾最酷的功能之一:你可以通过日常用的聊天软件直接跟它对话。以 Telegram 为例(最容易配置):
创建 Telegram Bot
在 Telegram 里搜索 @BotFather,发送 /newbot,按提示取个名字,你会收到一个 Bot Token。
在配置文件中添加 Telegram 渠道
打开 openclaw.json,在 channels 里加入:
json{
"channels": {
"telegram": {
"enabled": true,
"botToken": "你的 Bot Token 粘贴到这里"
}
}
}
重启小龙虾
终端openclaw restart
现在打开 Telegram,给你的 Bot 发条消息试试!
支持哪些聊天软件?
⚙️ 配置文件入门
openclaw.json 是小龙虾的「入职登记表」。刚装好的时候它已经有默认值了,但你可以根据需要调整。
json5{
// 助手配置
"agents": [{
"name": "小助手",
"model": "claude-sonnet-4-6", // 用哪个 AI 模型
"workspace": "./workspace" // 工作空间路径
}],
// 聊天渠道
"channels": {
"telegram": { "enabled": true, "botToken": "..." }
},
// 会话设置
"session": {
"resetMode": "daily", // 每天重置对话记忆
"maxTokens": 100000 // 单次对话最大长度
}
}
你可以写注释(// 像这样)、末尾可以多一个逗号。比标准 JSON 宽松很多,对新手更友好。
🔒 安全设置
如果你把小龙虾连上了 Telegram 等聊天软件,别人也可能给你的 Bot 发消息。你需要设置谁能跟它说话。
| 策略 | 白话解释 | 适合谁 |
|---|---|---|
pairing |
陌生人发消息需要你手动批准 | 大多数人(默认推荐) |
allowlist |
只有白名单里的人能说话 | 只想让特定人使用 |
open |
所有人都能跟它聊 | 公开的客服 Bot |
disabled |
关闭私聊功能 | 只在群里用 |
千万别图方便设成 open。任何人给你的 Bot 发消息都会消耗你的 API 额度(也就是你的钱)。
🤖 多助手协作
一个小龙虾不够?你可以同时养好几只,让它们各司其职。
比如这样分工
配置方法:在 openclaw.json 的 agents 数组里加入多个助手:
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 状态。
🧩 安装技能
技能(Skill)就像手机上的 App——给小龙虾装上新技能,它就能做更多事。
三种安装方式
方式一: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-gen | AI 画图 |
@openclaw/reminder | 定时提醒 |
@openclaw/translator | 多语言翻译 |
@openclaw/github | GitHub 操作 |
在 clawhub.com 可以浏览所有可用技能。社区贡献的技能越来越多,总有一款适合你。
⌨️ 常用命令速查
不用全记住,收藏这页随时查就行。
| 命令 | 干什么用 |
|---|---|
openclaw start | 启动小龙虾 |
openclaw stop | 关掉小龙虾 |
openclaw status | 看看它是不是在运行 |
openclaw restart | 重启(改了配置后用) |
openclaw doctor | 自检(出问题先跑这个) |
openclaw logs | 查看运行日志 |
clawhub search "关键词" | 搜索技能 |
clawhub install 技能名 | 安装技能 |
clawhub update --all | 更新所有已装技能 |
🔧 常见问题
小龙虾启动不了?
先跑 openclaw doctor,它会自动检测问题。
最常见的原因:Node.js 版本太低(需要 ≥ 22)。
发消息没有回复?
检查你的 API Key 是否正确配置。在终端运行 openclaw logs 查看错误信息。
如果看到 401 Unauthorized,说明 API Key 过期或写错了。
回复很慢?
可能是网络问题(API 请求需要翻墙),或者你选的模型太大(试试换成 Haiku)。
也可能是 API 服务商那边在排队——高峰期正常。
想重新来过?
终端openclaw stop
rm -rf ~/.openclaw # 删除所有配置
openclaw start # 重新初始化
这会清掉小龙虾的所有记忆和配置,从零开始。