Hướng dẫn cài đặt đầy đủ OpenClaw（AI Tôm Hùm） 2026: Từ số không thiết lập trợ lý AI cá nhân, tích hợp với Telegram

OpenClaw（龙虾）是目前 GitHub 增长速度最快的 AI agent 开源项目，让你在自己的电脑上架设一个永远在线的私人 AI 助理，并通过 Telegram、WhatsApp、Discord 等你平常就在使用的通讯 App 和它对话。

这篇教学从零开始，带你完成安装、设置到发送第一则消息，全程约 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 监听在 port 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

查看错误讯息。最常见的原因是 port 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。