OpenClaw 安装指南（2026）：安装、Dashboard、WhatsApp 与 Telegram

快速答案

截至 2026 年 3 月 17 日，当前最稳妥的 OpenClaw 安装顺序是：

1. 安装 OpenClaw。
2. 运行 openclaw onboard --install-daemon。
3. 用 openclaw gateway status 确认服务状态。
4. 运行 openclaw dashboard，先验证本地 Control UI 能打开。
5. 要接聊天渠道时，WhatsApp 用 openclaw channels login；Telegram 用 bot token 加 pairing 审批。
6. 用 openclaw message send --target ... 发送一条测试消息。

这个顺序很重要。因为 dashboard 是当前官方最直接的本地健康检查方式，应该先确认 Gateway 正常，再排查渠道问题。

本文内容已在 2026 年 3 月 17 日对照官方 Getting Started、Telegram、Pairing、message CLI 和 OAuth 文档核验。

这篇 OpenClaw 安装指南适合谁

如果你符合下面任一情况，这篇文章就是写给你的：

• 想把 OpenClaw 跑在自己的电脑上，而不是托管工作区里
• 想先跑通本地 dashboard，再接 WhatsApp 或 Telegram
• 想避开已经过时的社区教程，尤其是 Telegram 配置部分
• 想要一条当前可验证、可排错的最短安装路径

开始前你需要准备什么

截至 2026 年 3 月 17 日，官方 Getting Started 文档写的是：

• Node.js 22 或更高版本
• macOS、Linux 或 Windows
• 一种可用认证方式，例如 API key 或支持的 OAuth 流程
• WhatsApp 账号或 Telegram bot token，但只有在你要接这些渠道时才需要

和很多旧文章相比，这里有两个重要更新：

1. 如果本机没有 Node.js，官方 onboarding 流程现在可以辅助安装。
2. OpenClaw 不一定必须走纯 API key。官方 OAuth 文档列出了支持的 OAuth 方式，包括 OpenAI Codex OAuth。对 Anthropic 来说，文档也写明 setup-token 可以用，但 Anthropic API key 仍然是更稳妥的生产默认选择。

第一步：安装 OpenClaw

当前 quick start 优先推荐官方安装脚本。

macOS / Linux

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

Windows PowerShell

iwr -useb https://openclaw.ai/install.ps1 | iex

如果你更喜欢包管理器，这些方式也可用：

npm install -g openclaw@latest
# 或
pnpm add -g openclaw@latest
# 或
bun add -g openclaw@latest

安装后先确认命令可用：

openclaw --version

第二步：运行 Onboarding 并检查 Gateway 状态

先启动引导向导：

openclaw onboard --install-daemon

这个步骤会完成：

• 配置模型认证
• 创建或更新 ~/.openclaw/openclaw.json
• 保留 --install-daemon 时安装后台服务
• 视情况继续引导渠道配置

完成后检查 Gateway：

openclaw gateway status

如果服务还没起来，可以先前台启动做一次快速验证：

openclaw gateway --port 18789

第三步：先打开 Dashboard

在调试 WhatsApp 或 Telegram 之前，先确认本地管理界面没问题：

openclaw dashboard

成功表现通常有两种：

• 浏览器自动打开 dashboard，或者
• 你手动访问 http://127.0.0.1:18789/ 也能正常进入

如果出现授权错误，重新运行一次 openclaw dashboard，使用它重新打印的链接。官方文档也明确提醒：dashboard 属于管理界面，不要直接暴露到公网。

第四步：连接 OpenClaw 到 WhatsApp

如果你希望从手机上直接用，WhatsApp 仍然是更简单的入口。

1. 先执行：

openclaw channels login

2. 用手机 WhatsApp 扫二维码。
3. 限制允许给 bot 发消息的号码。

示例配置：

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+8613800138000"]
    }
  }
}

把 +8613800138000 换成你自己的号码。首个验证方式很简单：在 WhatsApp 里给自己发消息，确认 OpenClaw 会在同一个会话里回复。

第五步：按当前官方方式连接 Telegram

Telegram 是最容易被旧教程写错的部分。

5.1 创建 bot token

打开 Telegram，联系 @BotFather，执行 /newbot，保存 token。

5.2 写入 Telegram 配置

Telegram 不是 通过 openclaw channels login telegram 来配置的。

把 token 写进配置文件，或者放进环境变量：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123:abc",
      "dmPolicy": "pairing",
      "groups": {
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

默认账号也可以走环境变量：

export TELEGRAM_BOT_TOKEN=123:abc

5.3 批准第一条私聊

这是很多社区文章漏掉的一步。

openclaw gateway
openclaw pairing list telegram
openclaw pairing approve telegram <CODE>

为什么必须做这一步：官方 Telegram 文档写得很清楚，Telegram 默认 DM 策略是 pairing。也就是说，第一条私聊只有在 pairing code 被批准后才会真正处理。

5.4 个人 bot 最好尽快切到 allowlist

如果这是你自己长期使用的 bot，建议尽快改成 allowlist，而不是长期依赖 pairing 历史记录。

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123:abc",
      "dmPolicy": "allowlist",
      "allowFrom": ["123456789"]
    }
  }
}

如果你不知道自己的 Telegram 数字 user ID，可以这样查：

1. 先私聊你的 bot。
2. 运行 openclaw logs --follow。
3. 在事件里读取 from.id。

第六步：发送第一条测试消息

当前官方 CLI 语法使用 --target，不是 --to。

WhatsApp

openclaw message send --channel whatsapp --target +8613800138000 --message "Hello from OpenClaw"

Telegram

openclaw message send --channel telegram --target @mychat --message "Hello from OpenClaw"

如果你只配置了一个渠道，--channel 往往可以省略；如果你配置了多个渠道，建议显式写出来。

常见 OpenClaw 安装错误

1. 还在照搬旧 Node 要求

当前官方要求是 Node.js 22 或更高版本，不要继续照搬旧文章里的固定版本说法。

2. 还没验证 dashboard 就先查渠道

如果 dashboard 都打不开，先修 Gateway。很多渠道问题本质上都是本地服务异常的连锁结果。

3. 把 Telegram 当成 WhatsApp 来配

Telegram 是 token 驱动，WhatsApp 是二维码驱动。openclaw channels login 不是 Telegram 安装步骤。

4. 忘了 Telegram pairing 审批

在默认 dmPolicy: "pairing" 流程下，只有 bot token 还不够。

5. 还在复制 --to 示例

最新 message CLI 文档已经统一成 --target。

OpenClaw 安装 FAQ

OpenClaw 一定需要 API key 吗？

不一定。官方 OAuth 文档列出了支持的 OAuth 方式，包括 OpenAI Codex OAuth。如果你使用 Anthropic，文档说明 setup-token 可用，但 Anthropic API key 仍是更稳妥的生产默认方案。

为什么 Telegram 不回第一条消息？

因为默认 Telegram DM 策略是 pairing。你需要先启动 Gateway，列出待审批 pairing，再批准对应 code。

当前最快的验收方式是什么？

先看 dashboard。只要 openclaw gateway status 正常，且 openclaw dashboard 能打开，本地安装链路就基本已经打通，然后再单独处理 WhatsApp 或 Telegram。

最终检查清单

检查项	完成标准
安装	openclaw --version 可用
Gateway	openclaw gateway status 显示运行中
Dashboard	openclaw dashboard 能正常打开
WhatsApp	QR 登录成功，自己的号码可以给 bot 发消息
Telegram	第一条私聊已通过 pairing 或 allowlist
CLI 发送	openclaw message send --target ... 能到达目标

核验说明

本文中的最新事实已在 2026 年 3 月 17 日对照以下官方文档核验：

• OpenClaw Getting Started
• OpenClaw 首页 / 功能概览
• OpenClaw Telegram
• OpenClaw Pairing
• OpenClaw message CLI
• OpenClaw OAuth