OpenClaw セットアップガイド（2026）：インストール、Dashboard、WhatsApp、Telegram

Q: Telegram が最初のメッセージに返事しないのはなぜ？

既定の DM ポリシーが pairing だから。Gateway を起動し、保留中の pairing を確認してコードを承認する必要がある。

Q: いちばん速い動作確認は？

dashboard を開くこと。openclaw gateway status が正常で openclaw dashboard が開けば、ローカル側のセットアップは通っている。

まず結論

2026 年 3 月 17 日時点で、OpenClaw を最短で安定して動かす流れは次の通り。

OpenClaw をインストールする。
openclaw onboard --install-daemon を実行する。
openclaw gateway status でサービス状態を確認する。
openclaw dashboard を実行して、ローカル Control UI が開くことを確かめる。
チャネルを追加する。WhatsApp は openclaw channels login、Telegram は bot token + pairing 承認で設定する。
openclaw message send --target ... でテストメッセージを送る。

この順番が大事。dashboard は Gateway が正常かどうかを最短で確かめられる公式ルートなので、チャネル側の切り分けより先に確認した方が速い。

この記事は 2026 年 3 月 17 日時点で、公式の Getting Started、Telegram、Pairing、message CLI、OAuth を基に確認している。

この OpenClaw セットアップガイドが向く人

次のどれかに当てはまるなら、この手順が向いている。

OpenClaw を自分の PC で動かしたい
まず dashboard を通してから WhatsApp / Telegram を繋ぎたい
Telegram 周りの古い記事に振り回されたくない
いま動く構成を最短で再現し、あとで切り分けやすくしたい

始める前に必要なもの

2026 年 3 月 17 日時点の公式 Getting Started に基づく前提は次の通り。

Node.js 22 以上
macOS / Linux / Windows
使える認証方式を 1 つ。API キーか、サポート済み OAuth フローのどちらか
WhatsApp アカウントか Telegram bot token。ただしチャネルを使う場合だけ必要

古い解説と比べて重要な更新が 2 つある。

Node.js が未導入でも、公式 onboarding がインストールを補助できる。
OpenClaw は必ずしも API キー必須ではない。公式 OAuth docs には OpenAI Codex OAuth などが載っている。一方で Anthropic については、setup-token を使えるとしても、本番向けのより安全な既定は Anthropic API key auth と案内されている。

ステップ 1: 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

ステップ 2: Onboarding を実行して Gateway を確認する

まずセットアップウィザードを実行する。

openclaw onboard --install-daemon

ここで行われること：

モデル認証の設定
~/.openclaw/openclaw.json の作成または更新
--install-daemon を付けた場合のバックグラウンドサービス導入
必要に応じたチャネル設定案内

その後、Gateway を確認する。

openclaw gateway status

まだ起動していなければ、まずは前面で動かして確認する。

openclaw gateway --port 18789

ステップ 3: 先に Dashboard を開く

WhatsApp や Telegram を調べる前に、ローカル管理画面を確認する。

openclaw dashboard

成功時の目安：

ブラウザが自動で dashboard を開く
あるいは http://127.0.0.1:18789/ を手動で開ける

認証エラーが出るなら openclaw dashboard を再実行し、新しいリンクを使う。公式 docs でも dashboard は管理画面なので公開しないよう注意されている。

ステップ 4: OpenClaw を WhatsApp に接続する

スマホ中心で使うなら、WhatsApp の方が導入は簡単。

まず実行：

openclaw channels login

スマホの WhatsApp で QR コードを読み取る。
bot に DM できる番号を絞る。

例：

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

+819012345678 は自分の番号に置き換える。最初の確認は、自分宛てにメッセージを送り、同じスレッドで OpenClaw が返してくるかを見るのが早い。

ステップ 5: いま正しい 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 最初の DM を承認する

この一手間を省いている記事が多い。

openclaw gateway
openclaw pairing list telegram
openclaw pairing approve telegram &#x3C;CODE>

理由は、公式 Telegram docs が Telegram の既定 DM ポリシーを pairing と案内しているから。最初の DM は承認されるまで処理されない。

5.4 個人用 bot なら allowlist に切り替える

自分専用 bot なら、古い pairing 承認に頼るより allowlist に固定した方が扱いやすい。

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

自分の Telegram 数値 user ID は次の手順で確認できる。

bot に DM する。
openclaw logs --follow を実行する。
イベントの from.id を読む。

ステップ 6: 最初のテストメッセージを送る

最新の CLI では --to ではなく --target を使う。

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

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

チャネルが 1 つだけなら --channel は省略できることもある。複数あるなら明示した方が安全。

よくあるセットアップミス

1. 古い Node 要件を信じる

現在の公式要件は Node.js 22 以上。古い記事の固定バージョンをそのまま信じない方がよい。

2. dashboard を見ずにチャネルから疑う

dashboard が開かないなら、先に Gateway を直す。チャネル問題の多くはそこから派生している。

3. Telegram を WhatsApp と同じ流れで考える

Telegram は token ベース。WhatsApp は QR ベース。openclaw channels login は Telegram 用ではない。

4. Telegram pairing 承認を忘れる

既定の dmPolicy: "pairing" では、token だけでは足りない。

5. 古い `--to` 例を使う

現在の message CLI docs は --target に揃っている。

OpenClaw セットアップ FAQ

OpenClaw は API キー必須？

必須ではない。公式 OAuth docs には OpenAI Codex OAuth などの選択肢がある。Anthropic を使う場合は setup-token も使えるが、本番向けには Anthropic API key auth の方がより安全な既定とされている。

Telegram が最初のメッセージに返事しないのはなぜ？

既定の DM ポリシーが pairing だから。Gateway を起動し、保留中の pairing を確認してコードを承認する必要がある。

いちばん速い動作確認は？

dashboard を開くこと。openclaw gateway status が正常で openclaw dashboard が開けば、ローカル側のセットアップは通っている。

最終チェックリスト

確認項目	完了条件
インストール	`openclaw --version` が動く
Gateway	`openclaw gateway status` が running を返す
Dashboard	`openclaw dashboard` が開く
WhatsApp	QR ログイン成功後、自分の番号で bot に送れる
Telegram	最初の DM が pairing または allowlist で許可される
CLI 送信	`openclaw message send --target ...` が届く

検証メモ

この記事の記述は 2026 年 3 月 17 日時点で以下の公式資料を確認している。