本記事の目標は1つ:最短パスでゼロから完全に動作するOpenClawフローを実現すること。インストール、設定、Telegramへの接続、最初のメッセージの送信、AI応答の受信。理論も寄り道もなく、最速ルートだけです。
OpenClawとは
OpenClawはmacOS、Linux、WindowsをサポートするオープンソースのAIエージェントゲートウェイです。コア機能は、日常的に使用するチャットツール(WhatsApp、Telegram、Discord、iMessageなど)をさまざまなAIモデルに接続し、慣れ親しんだメッセージングインターフェースで直接AIとチャットできるようにすることです。
事前に知っておくべきコア機能:
- マルチチャンネルゲートウェイ:単一インスタンスで複数のチャットプラットフォームを同時管理
- マルチエージェントルーティング:異なる会話を異なるAIモデルにルーティング可能
- セッション分離:ユーザーごと・チャンネルごとに会話コンテキストを完全分離
- プラグイン拡張:Skillシステムによる機能拡張
- メディアサポート:画像、音声、その他のマルチメディアメッセージに対応
背景知識はここまでで十分です。始めましょう。
前提条件
必要なものは2つだけです。
- Node.js 22+:
node -vでバージョンを確認し、22未満の場合はアップグレード - Telegramアカウント:Telegramは全チャンネルの中で最も設定が速い(Bot Tokenだけで完了)
ステップ1:OpenClawをインストール
ターミナルを開いてグローバルインストールを実行します。
npm install -g openclaw@latest
インストール後、内蔵の環境チェックツールを実行してすべて準備完了か確認します。
openclaw doctor
すべてのチェックに合格すれば、インストールは問題ありません。エラーがある場合はプロンプトに従って修正し、再度openclaw doctorを実行してください。
ステップ2:初期化とデーモンのインストール
onboardコマンドを実行して初期設定とバックグラウンドデーモンのインストールを完了します。
openclaw onboard --install-daemon
このステップでいくつかの基本設定を行います。
- AIモデルプロバイダーの選択(例:OpenAI、Claude)
- 対応するAPIキーの入力
- バックグラウンドでOpenClawが継続的に実行できるようにデーモンをインストール
すべての設定は~/.openclaw/openclaw.jsonに書き込まれます。後で設定を変更する場合は、このファイルを直接編集するだけです。
ステップ3:ログインとTelegramチャンネルの設定
次に、最初のチャットチャンネルを接続します。loginコマンドを実行します。
openclaw channels login
Telegramを選択すると、Bot Tokenの入力を求められます。まだ持っていない場合は、以下の手順で取得してください。
- Telegramで
@BotFatherを検索して会話を開始 /newbotを送信し、プロンプトに従ってBot名とユーザー名を設定- 作成後、BotFatherがToken(
7123456789:AAHxxx...のような形式)を返す
ターミナルにTokenを貼り付ければ、チャンネル設定は完了です。
ステップ4:ゲートウェイの起動
すべて準備完了です。OpenClawゲートウェイを起動します。
openclaw gateway --port 18789
ターミナルにゲートウェイが起動したことを確認する出力が表示されたら、Telegramを開いて先ほど作成したBotを見つけ、メッセージを送信してみてください(例:「Hello」)。
すべてが正常に動作していれば、数秒以内にAIの応答を受け取ります。おめでとうございます、最初のAI会話が稼働しています。
次のステップ
基本フローを完了した後、探索する価値のある方向性をいくつか紹介します。
- Webダッシュボード:OpenClawは会話の監視と設定調整のためのビジュアル管理コンソールを提供
- モバイルペアリング:Mobile Node機能を使用してiOSまたはAndroidデバイスをOpenClawインスタンスとペアリング
- さらなるチャンネル:
openclaw channels loginでWhatsApp、Discord、Slackなどのプラットフォームを追加 - プラグインのインストール:Skillマーケットプレイスを通じてコミュニティ開発の機能プラグインを閲覧・インストール
最小限の実行パスはこの4ステップです。すべてがスムーズに進めば、本当に5分で完了します。問題が発生した場合は、openclaw doctorがトラブルシューティングの最良の出発点です。