OpenClaw 是什么？OpenClaw（龙虾AI）完整安装教学2026

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 等皆可），模型费用直接由你付给供应商。

你需要用到「终端机」，不用怕

这份教学需要在电脑上输入几行指令。如果你之前没用过，先花30 秒了解怎么打开它：

macOS：按Command + 空白键开启Spotlight 搜寻，输入「终端机」，按Enter 开启
Windows：按Win + R，输入powershell，按Enter；或在开始选单搜寻「PowerShell」
Linux：在应用程式选单找Terminal 或Konsole

打开后，把本文的指令直接复制贴上，再按Enter 执行，就这样。遇到要你输入密码的时候，打字时画面不会显示，但其实有输入，打完按Enter 就好。

安装前准备

系统需求

macOS、Linux，或Windows（建议使用WSL2，稳定性更高）
Node.js 22.14 以上（推荐Node 24）
至少一组AI 模型的API Key

安装Node.js

Node.js 是OpenClaw 需要的执行环境，就像App 需要作业系统才能跑一样。先确认电脑上有没有、版本够不够：

node -v

若版本低于v22.14 或尚未安装，依你的电脑系统选择：

macOS 用户：最简单的方式是直接前往nodejs.org下载安装包，点两下执行即可。若你有安装Homebrew（Mac 的套件管理工具），也可以在终端机执行：

brew install node

Windows 用户：同样可以直接去nodejs.org下载Windows 安装包，双击执行，一路Next 就好。

安装完后，重新打开终端机，再输入一次node -v确认版本显示v22 以上即代表成功。

取得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

打开终端机，复制以下指令贴上并按Enter：

macOS / Linux：

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

Windows（在PowerShell 执行）：

iwr -useb https://openclaw.ai/install.ps1 | 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资料夹，路径是~/.openclaw/config.json5。

最简单的开启方式：在终端机输入以下指令（macOS 用TextEdit 开启）：

open -e ~/.openclaw/config.json5

Windows 用户：

notepad $env:USERPROFILE\.openclaw\config.json5

在档案中找到（或加入）以下Telegram 设定：

{
  channels: {
    telegram: {
      enabled: true,
      botToken: "在这里贴入你的 Token",
      dmPolicy: "pairing",
    },
  },
}

4-3 重启Gateway 并配对

openclaw gateway restart
openclaw pairing list telegram

接着打开Telegram，找到你刚建立的Bot（搜寻你设定的帐号名称），传任何一则讯息给它。这时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 小时在线（进阶教学，即将推出）

本文链接地址：https://www.wwsww.cn/rgzn/37964.html
郑重声明：本文版权归原作者所有，转载文章仅为传播更多信息之目的，如作者信息标记有误，请第一时间联系我们修改或删除，多谢。