OpenClawとは？インストール方法とTelegramへの接続方法

OpenClawが私のフィードに登場したのは昨冬でした。プロジェクトが1週間のうちに2度名前を変え、GitHubで数十万個のスターを獲得した頃です。それ以来、「openclaw installation」や「openclaw telegram」を検索する人が増えています。

以下では、公式ドキュメントを確認しながら、このツールが何なのか、Claude Codeとどう違うのか、Windows、macOS、Linuxへのインストール方法、モデルの選び方、Telegramボットの接続方法を見ていきます。OpenClawはいくつかの注目を集めたインシデントに関わってきたため、セキュリティについても別に取り上げます。

サービスの使い方はAilootのドキュメントをご覧ください。

AIエージェントのOpenClawとは？わかりやすく説明#

OpenClawは、AIモデルをTelegramボットに接続します。必要なツールと権限を設定すれば、メッセージの要約やリマインダーの予約ができます。ゲートウェイのプロセスとローカル設定は、あなたのコンピューターやサーバー上で動きます。ただし、すべての会話がローカル処理になるわけではありません。クラウドモデルを選ぶと、リクエストと関連する会話のコンテキストがそのプロバイダーに送信されます。Ailoot経由なら、リクエストはAilootを通って選択したモデルのプロバイダーに届きます。ローカル推論にはローカルモデルを使い、クラウドへのフォールバックを無効にする必要があります。それでもTelegramのメッセージはTelegramを経由し、有効にしたツールが別のサービスへ接続する場合もあります。

このプロジェクトは、OpenClawのオープンソースコミュニティによって開発されています。GitHubリポジトリは2025年11月24日に作成され、2026年8月22日時点でスターは38万7千個、フォークは8万1千個に達しています。その年に最も急成長したオープンプロジェクトの一つです。使用言語はTypeScriptです。

このプロジェクトには少し面白い改名の歴史があり、古い記事を見て混乱しないよう知っておくとよいでしょう。始まりは、WhatsApp向けゲートウェイのWarelayでした。その後、Clawdbotになりました。2026年1月、Anthropicから商標を理由に改名を求められ、数日間はMoltbotという名前で活動しました。そして2026年1月30日、最終的な名前であるOpenClawになりました。「Clawdbot」や「Moltbot」についての説明を見かけても、同じプロジェクトです。改名前に書かれた記事というだけです。

プロジェクトのマスコットはロブスターのMoltyで、「脱皮」（殻を変えること）は改名のたびに使われる公式の比喩になりました。

OpenClawはClaude CodeやHermes Agentとどう違う？#

外から見るとどれも「AIエージェント」に見えるため、この違いについてよく聞かれます。比較表を見てください。

この表の見方です。私は開発にClaude Codeを使います。強力なモデルが必要で、コードを扱う作業に最も向いているからです。OpenClawとHermesは別の用途に向いています。常時動作し、Telegramにいて、昨日の会話を覚え、スケジュールに沿って作業するエージェントです。OpenClawとHermesのどちらを選ぶかは、もう少し微妙な判断になります。インストールと設定を解説したHermesガイドもあります。

ツールを選んでいるところなら、まず概要をご覧ください。2026年に何を使ってコーディングするかとどのタスクをAIエージェントに任せるかを紹介しています。Claude Codeのインストールについても別の記事があります。

OpenClawをインストールする前に必要なものは？#

唯一の厳格な要件なので、あらかじめNodeのバージョンを確認してください。

node --version

対応しているのは22.22.3以上、24.15以上、25.9以上で、Node 26が推奨されています。コマンドが「command not found」と表示されたり、バージョンが古かったりしても心配はいりません。公式インストーラーが新しいNodeをダウンロードしてくれるため、手動でインストールする必要はありません。

残るのはモデルの選択です。OpenClaw自体が考えるわけではなく、選んだモデルを呼び出します。料金面では、Anthropic、OpenAI、Googleのキーを使う方法があり、実際の使用量に応じてプロバイダーに支払います。もう一つはOllama経由のローカルモデルで、金銭はかかりませんが、高性能なハードウェアが必要です。以下の別々のセクションで両方を説明します。

macOSやLinuxにOpenClawをインストールする方法#

推奨される方法は公式インストーラーです。

1. インストーラーを実行する

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

   スクリプトがOSを検出し、Nodeを確認して必要ならインストールし、OpenClawをインストールしてから設定ウィザードを開きます。ウィザードを実行する前に中身を確認したい場合は、フラグを追加します。bash -s -- --no-onboard。

2. インストールを確認する

   openclaw --version
   openclaw doctor
   openclaw gateway status
   

   最初のコマンドはバージョンを表示し、2つ目は設定を確認し、3つ目はゲートウェイが起動してポート18789で待ち受けていることを確認します。

npmを使ってインストールを自分で管理したい場合は、次の方法もあります。

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

ここには、ドキュメントの別章で説明されている最近の注意点があります。npm 12では既定でパッケージのインストールスクリプトがブロックされます。--allow-scripts=openclawフラグがないと、allowScriptsメッセージが表示されてインストールが停止します。npm 11.15以前では、まだその制限がないためフラグは不要です。npm --versionでバージョンを確認してください。

2つ目のコマンドの--install-daemonフラグは自動起動を設定します。macOSではLaunchAgent、Linuxではsystemdサービスが使われます。サービス管理の条件に従い、再起動やログイン後にゲートウェイを起動します。スリープを防いだり、電源が切れた状態で動かしたりはしません。Telegramへの返信には、ホストが起きていてネットワークに接続されている必要があります。ノートパソコンのスリープ中や電源を切った間も返信が必要なら、常時稼働のサーバーを使ってください。

WindowsにOpenClawをインストールする方法#

1つ目は、ターミナルよりウィンドウ操作を好む人向けです。Windows HubはWindows 10（20H2以降）とWindows 11向けのネイティブOpenClawアプリで、現在ベータ版です。Windows Hubのリリースページを開き、プロセッサーに合ったインストーラーをダウンロードしてください。通常のコンピューターにはOpenClawCompanion-Setup-x64.exe、ARMにはarm64を使います。インストールすると、システムトレイのアイコン、チャットウィンドウ、設定画面を備えたOpenClaw Companionがスタートメニューに表示されます。

初回起動時に「Set up locally」が表示されたら、選択してください。OpenClawGatewayという専用のWSL環境が作られ、その中にゲートウェイがインストールされ、接続されます。既存のUbuntuがインストールされていても、そこには変更を加えません。

2つ目はPowerShellを使う方法です。

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

1行目でOpenClawをインストールし、2行目でWindowsタスクスケジューラーによる自動起動を登録します。コンピューターのポリシーでタスク作成がブロックされている場合、OpenClawは自動的にフォールバックへ切り替えます。スタートアップフォルダーにショートカットを作成し、サインイン時にゲートウェイを起動します。

3つ目はWSL2で、ドキュメントではWindowsで最も互換性の高いランタイムとされています。Ubuntuをインストールしてsystemdを有効にし、前のセクションのLinux向け手順に従います。

wsl --install -d Ubuntu-24.04

WSL内で/etc/wsl.confの[boot]セクションにあるsystemd=trueの行でsystemdを有効にし、PowerShellからwsl --shutdownを実行してWSLを再起動します。その後、Linux向けコマンドでOpenClawをインストールします。「ディストリビューション」や「systemd」が何のことかわからなければ、Windows Hubを使いましょう。これらの作業をすべて代わりに行ってくれます。

モデルを選び、初期設定を完了する方法#

モデルはアシスタントのエンジンです。設定ウィザードにプロバイダーの一覧が表示されます。実用的な選択肢を3つ紹介します。

Anthropicには便利な点があります。すでにClaude Codeをマシンにインストールしてサインインしている場合、OpenClawはそのログインを利用できます。まずマシンでclaude auth loginを実行し、OpenClawに使うよう指定します。

openclaw models auth login --provider anthropic --method cli --set-default

ゲートウェイがバックグラウンドサービスとして動く場合（--install-daemonを使うとそうなります）、キーをサービスから使える状態にする必要があります。そのためには~/.openclaw/.envに入れます。ウィザードが設定してくれるので、手動でファイルを編集する必要はありません。変更後は再起動して確認してください。

openclaw gateway restart
openclaw models status

料金の支払いが難しければ、Ollamaのセクションで紹介するローカルモデルを使う方法があります。

OpenClawをTelegramに接続する方法#

Telegramは最もすばやく接続できるチャンネルです。必要なのはボットトークンだけで、ビジネスアカウントの認証は不要です。ドキュメントでは、スマートフォンからアシスタントとのメッセージを始める最も簡単な方法とされています。手順をすべて紹介します。

1. BotFatherでボットを作成する

   Telegramで@BotFatherとのチャットを開きます（必ず正確なユーザー名であることを確認してください。偽物がたくさんあります）。/newbotを送信し、名前と、末尾がbotのユーザー名を選びます。返信として123456789:ABCdef...のようなトークンが届きます。これはボットのキーなので、パスワードのように扱ってください。

2. トークンをOpenClawに入力する

   最も簡単なのはウィザードを使う方法です。openclaw configureを実行し、Telegramチャンネルを選択します。手動で設定する場合はchannels.telegram.botToken設定、またはTELEGRAM_BOT_TOKEN環境変数を使います。ドキュメントでは、openclaw channels login telegramコマンドは存在せず、Telegramにはトークンでのみ接続すると明記されています。

3. ゲートウェイを起動してボットにメッセージを送る

   openclaw gateway
   

   Telegramで自分のボットを開き、メッセージを送ってください。8文字のペアリングコードが返信されます。これは保護策で、送信者を承認するまでメッセージは処理されません。

4. 自分を承認する

   openclaw pairing list telegram
   openclaw pairing approve telegram CODE
   

   コードは1時間有効なので、あまり待たないでください。最初に承認された送信者が、特権コマンドの所有者に自動的になります。

よく遭遇する難しい点が2つあります。

1つ目はグループです。OpenClawでは既定ですべてのグループがブロックされています。channels.telegram.groups設定でボットを明示的に許可し、グループ内ではrequireMention: trueモードを有効にしておく必要があります。するとユーザー名で呼びかけたときだけ返信し、通常の会話に割り込みません。Telegramには独自のボットプライバシーモードもあり、グループ内では既定でボットはコマンドしか見られません。@BotFatherで/setprivacyを使って無効にしてください。変更後は、設定が適用されるようボットをグループから一度削除し、再追加する必要があります。

2つ目は、誰でもアクセスできる状態にしないことです。設定には、アクセスリストにアスタリスクを付けたdmPolicy: "open"モードがあります。ユーザー名を知っている人なら誰でもボットに指示できます。パーソナルアシスタントでは、他人にあなたのマシンの操作を許す直接的な経路になります。コードによるペアリングを有効のままにするか、数値IDをallowFromに入力してください。

Ollama経由でローカルモデルを使ってOpenClawを動かす方法#

クラウドへのフォールバックを使わないローカル専用経路を選ぶと、モデルの推論を自分のハードウェア上で行え、有料モデルのエンドポイントは不要です。ただしTelegramでの作業全体がローカルになるわけではありません。メッセージはTelegramを通り、有効にしたオンラインツールが別のサービスへデータを送る場合があります。

1. Ollamaをインストールする

   ollama.com/downloadからインストーラーをダウンロードしてください。macOS、Windows、Linux向けのバージョンがあります。

2. モデルをダウンロードする

   ollama pull gemma4
   

3. OllamaをOpenClawに接続する

   openclaw onboard
   

   Ollamaプロバイダーとモードを選択します。Local only（自分のモデルのみ）、Cloud only（ollama.comのモデルのみ）、またはCloud + Localです。ウィザードがローカルサーバーを検出し、インストール済みモデルを表示します。

4. 確認する

   openclaw models list --provider ollama
   

広告のような説明にならないよう、率直な注意点も紹介します。OpenClawのドキュメントによると、ローカルモデルで快適にエージェントを使うには、フル構成のMac Studioが2台あるレベルのハードウェアが必要です。一方、24 GBのグラフィックカードで対応できるのは、遅延を伴う軽いリクエストに限られます。小型で強く圧縮されたモデルは、コンテキストが途切れやすく、他人のテキストに隠れた悪意ある指示への耐性も低くなります。日常的な言い方をすると、性能のよいノートパソコン上のローカルモデルでも「試して、どんなものか理解する」には十分ですが、ツールを使うアシスタントを日常的に使う場合、クラウドモデルのほうがまだはるかに信頼できます。

WSL2 + Ollama + NVIDIA GPUの環境を組む人に向けて、ドキュメントからもう一つ注意があります。公式Linux版Ollamaインストーラーは、再起動ポリシーが「always」の自動起動を有効にします。WSL2でGPUを使うと、マシンが再起動ループに入ることがあります。対処方法はサービスの自動起動を無効にすることです。この問題が起きた場合は、ドキュメントのOllamaページにあるトラブルシューティングを確認してください。

OpenClawを使うのは安全？#

まず、誰もが理解しているわけではない重要な点から説明します。OpenClawは、ファイル、コマンド、ブラウザーなど、あなたのマシンにアクセスします。ドキュメントにも明記されているとおり、プロジェクトは信頼できるユーザー1人向けに設計されています。ボットへのアクセスを外部の人に与えてはいけません。誰かがあなたのエージェントにメッセージを送れるなら、それを使ってあなたのコンピューター上で操作できます。

最低限、次のことを実践してください。

1. コードによるペアリングを有効にするか、アクセスリストを使います。設定方法はTelegramのセクションで説明しました。
2. 必要がない限り、ゲートウェイを外部に公開しないでください。既定ではあなたのマシン上だけで待ち受けるため、その状態を保ちます。
3. 設定を変更したら、組み込みチェックを実行します。

openclaw security audit

公開アクセス、広すぎるツール権限、弱いトークン、公開されたポートを確認します。--fixフラグを使うと、一部の問題は自動修正できます。

詐欺についても別に触れておきます。これは仮定の話ではありません。2026年1月にプロジェクトが慌ただしく改名したとき、便乗者が数秒で古いアドレスを乗っ取り、すぐに暗号資産ウォレットを投稿しました。「OpenClaw開発者」を名乗る偽アカウントが、トークン詐欺を宣伝し始めました。ここから導かれる絶対的なルールは2つです。OpenClawはopenclaw.aiまたはgithub.com/openclaw/openclawからのみダウンロードしてください。そして、このプロジェクトに暗号資産はありません。「OpenClawトークン」はすべて詐欺です。いかなる場合も送金しないでください。

インストール後、OpenClawで何ができる？#

私なら次の順に試します。

1. ゲートウェイとモデル。 openclaw gateway statusを実行してから、openclaw dashboardを開きます。パネルの表示はControl UIに接続できたことを示します。チャットに「model connection testと返信してください」と送り、AIの返信が届くことを確認します。ページの読み込みだけではモデルを検証できません。
2. Telegramと目的のタスク。 ボットを設定して自分のペアリングを承認した後、そのボットにTelegramから新しいメッセージを送り、Telegram上に返信が届くことを確認します。次に、読み取りを許可した無害なテストフォルダーの要約など、範囲が限られ結果を目で確認できるタスクを1つ試します。リマインダーは、保存された予定と実際の配信を別々に確認してください。ダッシュボードで返信があっても、Telegramへの配信や予約実行は証明できません。
3. 予約タスク。 アシスタントはスケジュールに沿ってジョブを実行できます。Telegramで朝の要約を送る、定期的にメールを確認するなどです。そのため、ゲートウェイを24時間稼働させておきます。
4. 記憶。 OpenClawは長期記憶を、作業フォルダー内の普通のMarkdownファイルに保存します。あなたがどんな人か、どう応答すべきか、以前の会話から何を覚えたかが記録されます。ファイルを開いて自分で読むことができ、ブラックボックスではありません。
5. スキル。 プロジェクトには、セキュリティチェックを備えた既成スキルとプラグインがあります。他人のスキルは、あなたのマシン上で他人のコードを実行することを意味します。そのため、カタログで検査されています。

ここでのルールは一度にすべてを有効にしないことです。まず安定した会話を1つ試し、次にTelegram、最後にスケジュールを追加します。そうすれば、失敗がそれぞれの段階で起こり、「全部壊れたけど、どこで失敗したのかわからない」という状態になりません。

インストールで問題が起きたら？#

よくある3つの状況を見てみましょう。

インストール直後に「openclaw: command not found」と表示される。 ほとんどの場合、パスの問題です。npmのグローバルパッケージ用フォルダーがターミナルのPATHに含まれていません。ドキュメントにある診断コマンドは次のとおりです。

node -v
npm prefix -g
echo "$PATH"

2つ目のコマンドが表示するパスは、3つ目の出力に含まれているはずです。なければ、シェルの設定に追加するか、ターミナルを閉じて再度開いてください。インストール後、新しいセッションで初めてNodeのパスが反映されることがあります。

ゲートウェイは動いているのに、アシスタントが無反応。 ドキュメントのFAQにある症状は、最初のメッセージに返信がなく、トークンカウンターが0のままになることです。つまり、エージェントがまだ起動していません。最も多い原因はモデルが設定されていないことです。次の順で確認してください。

openclaw gateway restart
openclaw status
openclaw models status

モデルが設定されているのに返信がなければ、openclaw logs --followでライブログを確認し、どこで止まっているか調べられます。

Telegramボットが返信しない。 次の順に確認してください。トークンが、メッセージを送っているボットのものか、ゲートウェイが動いているか（openclaw gateway status）、ペアリングが承認済みか（openclaw pairing list telegram）。ペアリングコードの有効時間は1時間です。昨日ボットにメッセージを送った場合は、もう一度メッセージを送り、新しいコードを承認してください。

どうしても解決できない場合、ドキュメントでは意外ながら理にかなった方法を勧めています。あなたのマシンを見られるローカルAIエージェントに診断情報を渡す方法です。openclaw status --allとopenclaw doctorの出力をClaude CodeやCodexに渡せば、サポートチャットよりも早く設定を読み解けるかもしれません。AIがAIを直す、というわけです。

OpenClawについてよくある質問#

Ailootについて詳しく知る。