OpenClaw（龙虾）是目前 GitHub 增长速度最快的 AI agent 开源项目，让你在自己的电脑上部署一个永远在线的私人 AI 助理，并通过 Telegram、WhatsApp、Discord 等你平常就在使用的通讯应用与它对话。
这篇教程从零开始，带你完成安装、设置到发送第一条消息，全程约 10 分钟。
OpenClaw 是什么？和 ChatGPT 有什么不同？
ChatGPT 是问答工具：你问它一个问题，它给你一个回答，对话结束后就终止了。OpenClaw 是 AI agent：你交付一个任务，它会自己思考、调用工具、执行动作——查看你的 Gmail、查看你的日历、搜索网络、编写代码——然后把结果告诉你。
更关键的差异是：OpenClaw 运行在你自己的电脑上，数据完全由你掌控，不会上传到任何第三方服务器。它本身不包含 AI 模型，需要你自己提供 API Key（Anthropic Claude、OpenAI GPT、Google Gemini 等皆可），模型费用直接由你支付给供应商。
安装前准备
系统需求
macOS、Linux，或 Windows（建议使用 WSL2，稳定性更高）
Node.js 22.14 以上（推荐 Node 24）
至少一组 AI 模型的 API Key
安装 Node.js
先确认有没有安装、版本够不够：
node -v
若版本低于 v22.14 或尚未安装，依系统选择安装方式：
获取 AI 模型 API Key
OpenClaw 支持多种模型供应商，以下是最常用的三个选择：
Anthropic Claude：前往 console.anthropic.com 建立账号，在 API Keys 页面新增密钥。Claude Sonnet 4.x 是目前最主流的选择。
OpenAI GPT：前往 platform.openai.com，建立 API Key。
Google Gemini：前往 aistudio.google.com，可免费获取 API Key。
把 API Key 复制好备用，等下安装时会需要贴入。
第一步：安装 OpenClaw
macOS 与 Linux 只需一行指令：
curl -fsSL | bash
Windows 用户在 PowerShell 执行：
iwr -useb | iex
安装完成后，确认指令可以使用：
openclaw --version
第二步：执行 Onboarding 向导
执行以下指令，启动交互式设置向导，同时让 OpenClaw 以后台服务形式随系统启动：
openclaw onboard --install-daemon
向导会依序询问几个问题：
选择模型供应商：选你刚才获取 API Key 的那家（Anthropic、OpenAI、Google 等）
粘贴 API Key：把刚才复制的密钥粘贴进去
选择模型：建议选最新的主力模型（如 claude-sonnet-4-5）
选择安装模式：新手选 QuickStart 即可，会用默认值完成所有设置
整个过程约 2 分钟，大部分选项按 Enter 接受默认值就好。
第三步：确认 Gateway 正在运行
openclaw gateway status
若看到 Gateway 在端口 18789 上监听，代表安装成功。
打开浏览器控制界面试试：
openclaw dashboard
浏览器会打开 Control UI，你可以在这里直接向 AI 助理发送消息，确认一切运行正常。
第四步：串接 Telegram（最快上手的方式）
Telegram 是 OpenClaw 官方支持最完整的通讯通道，设置也最简单，只需要一组 Bot Token。
4-1 向 BotFather 申请 Bot Token
打开 Telegram，搜索并开启 @BotFather（确认旁边有官方蓝勾）
发送 /newbot
依提示输入 Bot 名称（显示名）和 Bot 账号（需以 bot 结尾，如 my_ai_assistant_bot）
BotFather 会给你一组 Token，格式类似 123456789:AAGxxxxxxxxxxxxxxxxx，把它复制下来
4-2 设置 Token
编辑 OpenClaw 配置文件（默认路径
~/.openclaw/config.json5
），加入 Telegram 设置：
{ channels: { telegram: { enabled: true, botToken: “在这里粘贴你的 Token”, dmPolicy: “pairing”, }, }, }
4-3 重启 Gateway 并配对
openclaw gateway restart openclaw pairing list telegram
接着在 Telegram 找到你刚创建的 Bot，给它发送任意一条消息，它会返回一组配对码。执行：
openclaw pairing approve telegram <配对码>
完成后，在 Telegram 向你的 Bot 发送消息，它就会收到 AI 助理的回复。
常见问题 FAQ
Node 版本错误怎么办？
执行
node -v
确认版本。若低于 v22.14，依照上方表格重新安装 Node.js。macOS 用户若安装了 Homebrew，执行 brew upgrade node 即可升级。
Gateway 无法启动？
执行
openclaw gateway status
查看错误信息。最常见的原因是端口 18789 被占用，或 API Key 格式错误。可以执行 openclaw configure 重新设置。
如何更换 API Key？
执行
openclaw configure
，选择 Model/Auth 步骤重新设置即可。
Token 会一直烧吗？
默认情况下，OpenClaw 仅在收到消息时才会调用 API，不会无故消耗 Token。但若你启用了某些自动化 Skill 或排程任务，建议在模型供应商的后台设置每月用量上限，避免意外超支。
接下来可以做什么
串接 Gmail、Google Calendar，让助理帮你管理邮件与行程
安装 Skills，扩充助理的能力（网络搜索、代码执行、记忆管理等）
云端部署：通过 Cloudflare Tunnel 让龙虾 24 小时在线（进阶教学，即将推出）
这篇文章 OpenClaw（龙虾 AI）完整安装教学 2026：从零搭建个人 AI 助理，串接 Telegram 最早出现在 链新闻 ABMedia。
