🦞 OpenClaw 小龙虾 AI 助理（零基础版）

一、这玩意儿到底是什么？

一句话说明白：OpenClaw 就是你自己养的 AI 助理，装在你自己电脑上，然后你在 Telegram / WhatsApp / Discord 这些本来就在用的 App 里跟它说话。

有多火？GitHub 上已经 32 万颗星 ⭐——很多红了十几年的老项目都没这个数，它才出来几个月。

跟普通 ChatGPT 网页版有啥区别？举个例子：

• ChatGPT 网页：打开浏览器 → 登录账号 → 聊完关掉

• OpenClaw：直接在 Telegram 里发一句「帮我查今天深圳天气」，秒回，就像手机里住了一个助理

它能干啥：

🤖 支持几乎所有主流 AI 模型，随时切换

• OpenAI 系列：GPT-4o、GPT-4o mini、GPT-5、o3、o4-mini、Codex……有什么用什么

• Anthropic Claude 系列：Claude Opus、Sonnet、Haiku，推理能力很强

• Google Gemini 系列：Gemini 2.5 Pro / Flash

• 本地模型（白嫖党）：接 Ollama 跑 Llama、Mistral、Qwen（通义千问）等开源模型，完全不花钱

• 其它：Mistral、DeepSeek、Groq 等都能接，支持多个 Key 轮换 + 自动容灾切换

一个助理，同时管多个模型账号，哪个回答得好就用哪个，还能一键切换，不用分别打开 N 个网页。

💬 在你本来就在用的 App 里聊，不用学新东西

• Telegram、Discord、WhatsApp、飞书、LINE、Signal、iMessage……共 22 个平台

• 手机 Telegram 发一句话，AI 秒回——跟发普通消息一模一样

• 支持群聊（@它才回复）、私聊、语音转文字

🔒 所有数据只在你自己电脑上

• 聊天记录本地存储，不上传任何服务器

• 消息只直接发给 OpenAI / Anthropic 等 AI 厂商，不经过 OpenClaw 自己的任何中转服务器

• 陌生人想用你的 Bot？需要你手动审批授权码，防白嫖

🦾 装插件让 AI 更厉害（选装）

• 🌤 查实时天气：「今天北京天气」直接出结果

• 🔍 联网搜索：不被 AI 训练截止日期限制，看最新新闻

• 💻 控制你的电脑：帮你跑脚本、开关程序、读写文件

• 📅 定时任务：「每天早上 8 点提醒我喝水」，真能做到

• 🎨 生成图片：接 DALL-E / Stable Diffusion 直接出图

• 📸 截图 / 摄像头：AI 能"看见"你屏幕或摄像头画面再回答

• 🌐 控制浏览器：帮你自动填表、抓网页内容

📱 手机 App（可选）

• macOS 菜单栏 App：随时查看状态、语音唤醒（喊一句话就能召唤 AI）

• iOS / Android App：连上家里电脑的 OpenClaw，手机直接用

🆓 完全免费开源（MIT 协议）

• 软件本身 0 元，花的钱只是你调 AI API 的费用

• 用本地模型（Ollama）的话，完全免费，0 费用

• 代码公开在 GitHub，社区 1200+ 人在维护，每天都有更新

为啥叫小龙虾？
Logo 就是一只大龙虾 🦞，英文名 OpenClaw（龙虾爪），国内社区叫它小龙虾。AI 首次启动会喊一句 "EXFOLIATE!"（龙虾蜕壳！），挺有个性的。

🔧 二、装之前先看看要准备啥

对电脑的要求（不高，放心）

• 系统： macOS ✅、Linux ✅、Windows ✅（Windows 要多装个 WSL2，下面有教程，5 分钟搞定）

• Node.js： 运行环境，没装过也别慌，下面一起安排

• 内存： 1GB 够用，现在的电脑基本都满足

• 网络： 需要能访问 GitHub，国内用户记得开代理

你得有一个 AI 的 API Key

API Key 说白了就是一张"使用凭证"，有了它 OpenClaw 才知道去调用哪个 AI。选一个就够：

• ✅ OpenAI（最常用）：去 platform.openai.com 注册，充 5 美元就能用 GPT-4o

• ✅ Anthropic（Claude）：去 console.anthropic.com 注册，Claude 系列也很强

• ✅ 还支持 Gemini、Mistral 等，挑一个你有账号的

没有 API Key 也能先玩！
可以先把 OpenClaw 装好，配置向导里跳过 API Key 这步，先看看界面长啥样。想正式用的时候再去充值也来得及。

🚀 三、开装！按你的系统选对应方法

▶ Mac / Linux 用户 — 一行命令搞定

打开「终端」（Terminal），粘贴这行命令，回车：

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

全自动跑完。完成后验证一下：

openclaw --version

屏幕出现版本号（比如 2026.3.13）就装好了 ✅

▶ Windows 用户 — 多一步，但真的不难

Windows 需要先装 WSL2（在 Windows 里运行一个 Linux 环境），装好之后跟 Mac/Linux 用法完全一样。

第一步：装 WSL2
按 Win 键搜索「PowerShell」，右键 → 以管理员身份运行，粘贴这行：

wsl --install

自动下载安装 Ubuntu，装完之后重启电脑。

第二步：打开 Ubuntu，装 OpenClaw
重启后按 Win 搜索「Ubuntu」打开，在黑色窗口粘贴：

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

跑完后 openclaw --version 验证一下，出现版本号就行。

⚠️ Windows 用户注意：后面所有命令都要在 Ubuntu 窗口里运行，不是 CMD，也不是 PowerShell，搞错了会报错。

⚙️ 四、第一次运行，跟着向导一步步来

装好之后，运行这个命令启动「开箱向导」：

openclaw onboard --install-daemon

它会问你几个问题，跟着填就行：

1. 选 AI 模型 + 填 API Key：比如选 OpenAI，然后把你的 Key 粘进去

2. 设置 Gateway：这是 OpenClaw 的核心"大脑"，碰到不懂的选项直接回车选默认就行

3. 接聊天软件：这步可以先跳过，后面随时加

命令里的 --install-daemon 是干嘛的？让 OpenClaw 变成系统服务，开机自动在后台跑，不需要每次手动启动。这个参数一定要加。

向导里遇到不认识的问题，直接回车选默认就行，以后都可以改。

🖥️ 五、打开网页，发第一条消息

向导跑完之后，运行：

openclaw dashboard

浏览器会自动弹出 http://127.0.0.1:18789/，这是 OpenClaw 的网页控制台。

好消息：你现在就能在这个网页里直接和 AI 聊天了！ 不需要配 Telegram，不需要配 Discord，打开就能用，这是最快的验证方式。

这个网页还能干：

• 💬 直接打字聊天——就是个聊天框，发消息就行

• 📊 看你用了多少 Token（花了多少钱）

• ⚙️ 在线改设置，不需要手动改配置文件

• 🔌 管理已接入的聊天软件

💡 如果你只是自己用，网页版完全够了——接 Telegram / Discord 是可选项，不是必须的。

💬 六、接入 Telegram（想在手机里直接聊的看这里）

想在 Telegram 里用 AI？跟着这三步走，10 分钟搞定。

第一步：去申请一个 Telegram 机器人

去找 Telegram 上的"机器人之父"（@BotFather）申请一个 Bot：

1. 在 Telegram 里搜索 @BotFather，点进去

2. 给它发 /newbot

3. 它问你 Bot 名字，随便起一个

4. 它问你用户名，必须以 bot 结尾，比如 myai_bot

5. 设置完它给你发一串 Token，长这样：1234567890:ABCDEFGhijkl...，复制保存好

第二步：把 Token 告诉 OpenClaw

在终端运行（把括号里换成你自己的 Token）：

openclaw channels add --channel telegram --token "你的BotToken"

第三步：去 Telegram 找你的 Bot 聊天！

搜索你刚才设置的 Bot 用户名，发一条消息，AI 就回了 🎉

陌生人给 Bot 发消息怎么办？
默认陌生人发消息，Bot 先发给对方一个数字验证码，你运行 openclaw pairing approve telegram <验证码> 批准之后，对方才能用。这样能防止别人白嫖你的 API 额度。

🎯 七、还支持这些 App（不急着配，先玩起来再说）

官方一共支持 22 个聊天平台，从最容易到最麻烦排个序：

💡 国内用户怎么选？ 有飞书（企业用）和钉钉（暂不支持）两种选择，最推荐的还是装个 Telegram 搞定—— 国内用梯子用 Telegram 很普遍。

接入 Discord（换成你自己的 Token）：

openclaw channels add --channel discord --token "你的DiscordBotToken"

接入 WhatsApp（手机扫码，跟登微信网页版一样）：

openclaw channels login

🧩 八、给 AI 装插件，让它更厉害

OpenClaw 有个"技能市场"叫 ClawHub，里面有各种插件，装上之后 AI 就多会很多本事：

• 🌤 实时查天气（说「今天上海天气」，AI 直接帮你查）

• 📅 帮你记日程、设提醒

• 🔍 联网搜新闻，不被训练数据截止日期限制

• 💻 帮你在电脑上跑脚本、执行命令

• 🎨 生成图片

最省事的方式：直接在聊天里告诉 AI，让它自己去装。比如说「帮我装一个查天气的插件」，AI 自己去 ClawHub 找然后装好，你啥都不用干。

也可以手动装：

openclaw skills install weather

📋 九、常用命令小抄（截图收藏这一节）

聊天时直接在对话框发这些命令（Telegram / Discord / 网页都能用）：

🔧 十、配置文件在哪？要手动改吗？

配置都存在 ~/.openclaw/openclaw.json 里（Windows WSL2 里大概是 /home/你的用户名/.openclaw/openclaw.json）。

大多数情况不需要手动改——向导已经帮你配好了，在网页控制台里也能改。但如果你想换个 AI 模型，直接编辑这个文件也行。

最精简的配置长这样：

{
  "agent": {
    "model": "openai/gpt-4o"
  }
}

换成 Claude：

{
  "agent": {
    "model": "anthropic/claude-opus-4-6"
  }
}

同时配好 Telegram 的完整示例：

{
  "agent": {
    "model": "openai/gpt-4o"
  },
  "channels": {
    "telegram": {
      "botToken": "你的BotToken"
    }
  }
}

❓ 十一、遇到问题了？先看这里

运行了命令，浏览器没弹 / 网页打不开
先跑：openclaw doctor，它会自动帮你查哪里有问题。也有可能是 18789 端口被占了，重启电脑试一下。

AI 半天没回复，或者报错了
多半是 API Key 有问题：要么输错了，要么账户没余额了。去 OpenAI / Anthropic 后台查一眼。想看详细报错就跑 openclaw gateway --verbose。

给 Telegram Bot 发消息，没有任何反应
挨个排查：① Token 有没有填错？② OpenClaw 在不在跑？（openclaw gateway status）③ 有没有待批准的配对码没处理？

Windows 上命令死活报错
确认你是在 WSL2 的 Ubuntu 窗口里跑命令，不是 CMD 也不是 PowerShell，那两个环境是不一样的。

OpenClaw 会把我的聊天记录传给谁吗？
不会。OpenClaw 只跑在你自己电脑上。消息只发给你选的 AI（比如 OpenAI），不经过任何 OpenClaw 自己的服务器。

怎么更新到最新版？
openclaw update --channel stable，一行搞定。

想从 GPT 换成 Claude？
在网页控制台设置里直接改，或者编辑 ~/.openclaw/openclaw.json 把 agent.model 换掉，重启 Gateway 就生效。

📚 十二、有用的链接收藏起来

• 🏠 官网：openclaw.ai

• 📖 官方文档：docs.openclaw.ai

• 💻 GitHub 源码：github.com/openclaw/openclaw（32万+ Star）

• 🛠 技能市场 ClawHub：clawhub.com

• 💬 Discord 社区：discord.gg/clawd

• 🚀 一键部署工具（中文）：OpenClawInstaller（国内用户推荐）

• 🐋 Docker 部署文档：docs.openclaw.ai/install/docker