【LINE連携】OpenClawをLINEと連携する完全手順【Messaging API使用】

AIエージェント入門

「LINEでAIエージェントと話せたら便利なのに…」そう思ったことはありませんか？

LINEは日本国内で9,700万人以上が利用する（2024年時点）、まさに日本最大のメッセージアプリです。毎日使い慣れたLINEからOpenClawに話しかけられるなら、AIエージェントをもっと自然に生活に取り入れることができます。

この記事では、OpenClawをLINE公式アカウント（Messaging API）と連携する完全な手順をステップ形式で解説します。設定はやや複雑ですが、一度設定してしまえば毎日LINEからAIエージェントを活用できるようになります。ぜひ最後まで読み進めてみてください。

この記事で分かること

  • OpenClawとLINEを連携する仕組みと前提条件
  • LINE Developers での設定方法（Messaging API）
  • OpenClawの設定ファイルへの追記方法
  • ペアリング（紐付け）の完了手順
  • よくあるトラブルと解決方法

LINE連携の仕組みと「HTTPS必須」の重要な注意点

まず、OpenClawとLINEがどのように連携するかを理解しておきましょう。

LINEのMessaging APIは、ユーザーがLINEで公式アカウントにメッセージを送ると、LINEのサーバーから指定した Webhook URL にリクエストを送信する仕組みになっています。OpenClawはこのWebhookを受け取り、AIが返答を生成してLINEに送り返します。

ここで非常に重要なポイントがあります。

⚠️ 重要: LINE Messaging APIのWebhookは「HTTPS」必須です
LINEのサーバーは、HTTPSで公開されているURLにしかWebhookを送信しません。つまり、自分のローカルPCだけでは動かすことができません。

LINE連携を使うには、以下のいずれかの環境が必要です：

  • VPS / クラウドサーバー（ConoHa、さくら、AWS、Google Cloudなど）+ SSL証明書（Let’s Encryptなど）
  • ngrok などのトンネリングツール（開発・テスト目的）

他のOpenClawの連携（Discord、Telegram）と比べると、この点でやや設定が複雑になります。

DiscordやTelegramはOpenClawからBot側から接続しに行く方式なのに対し、LINEはLINEサーバーからOpenClawに向けてWebhookを送ってくる方式です。このため、OpenClawが外部から到達可能なHTTPS URLを持つ必要があります。

前提条件

作業を始める前に、以下が揃っていることを確認してください。

  • ✅ OpenClawがインストールされ、Gatewayが起動できること
  • ✅ HTTPS通信可能な公開URLが用意されていること（VPSまたはngrok等）
  • ✅ LINEアカウントを持っていること（個人アカウントでOK）
  • ✅ メールアドレスでのLINE Developersアカウント登録ができること

補足: ngrokを使った開発環境での試し方については、別途ngrok公式ドキュメントをご参照ください。ngrokの無料プランではURLが起動のたびに変わるため、Webhookの再設定が必要になります。本番運用にはVPS環境をおすすめします。

手順：OpenClawとLINEを連携する

ステップ1: OpenClaw LINEプラグインをインストールする

まず、OpenClawにLINE連携用プラグインを追加します。ターミナルで以下のコマンドを実行してください。

openclaw plugins install @openclaw/line

インストールが完了したら、プラグインが正しく認識されているか確認できます。

openclaw plugins list

一覧に @openclaw/line が表示されていればOKです。

ステップ2: LINE Developersアカウントを作成する

次に、LINE Messaging APIを利用するためのアカウントを作成します。

  1. ブラウザで LINE Developers Console にアクセスします。
  2. お持ちのLINEアカウントでログインします（LINEアプリのQRコードログインが便利です）。
  3. 初回ログイン時は開発者情報の登録が求められます。名前とメールアドレスを入力して登録を完了してください。

ステップ3: ProviderとMessaging APIチャンネルを作成する

LINE Developers Consoleでの設定を行います。

  1. LINE Developers Consoleで「Create a new provider」（プロバイダーの新規作成）をクリックします。プロバイダー名は任意です（例: “My OpenClaw Bot”）。
  2. 作成したプロバイダーの画面で「Create a new channel」をクリックします。
  3. チャンネルタイプの選択画面で「Messaging API」を選択します。
  4. 必要事項を入力します：
    • Channel name: Botの名前（例: “OpenClaw アシスタント”）
    • Channel description: 簡単な説明
    • Category / Subcategory: 任意のカテゴリを選択
  5. 利用規約に同意してチャンネルを作成します。

ステップ4: Channel Access TokenとChannel Secretをコピーする

作成したMessaging APIチャンネルの設定画面で、2つの重要な認証情報を取得します。

  1. チャンネル設定ページの「Messaging API」タブを開きます。
  2. ページ下部にある「Channel access token」の「Issue」ボタンをクリックしてトークンを発行し、コピーしてください。
  3. 「Basic settings」タブに切り替え、「Channel secret」の値をコピーしてください。

注意: Channel access tokenとChannel secretは、第三者に知られないよう大切に管理してください。これらが漏洩すると、あなたのBotが悪用される可能性があります。

ステップ5: Webhookを有効化する

「Messaging API」タブの「Webhook settings」セクションで、「Use webhook」をオンにします。

ステップ6: Webhook URLを設定する

「Webhook URL」フィールドに、OpenClaw GatewayへのHTTPS URLを入力します。URLの末尾は必ず /line/webhook にしてください。

https://あなたのドメインまたはホスト/line/webhook

環境によって入力するURLが変わります。それぞれの例を参考にしてください。

VPS ＋ 独自ドメインがある場合

https://myserver.example.com/line/webhook

VPS ＋ IPアドレスのみ（ドメインなし）の場合

IPアドレスだけの場合、LINEのWebhookはHTTPSが必須のため、SSL証明書の設定が必要です。Let’s Encryptなどで証明書を取得してドメインを紐付けるか、ngrokを使う方法をおすすめします。

ngrokを使う場合（開発・テスト向け）

ngrokはローカルPCのGatewayを一時的にインターネットに公開できるツールです。

https://xxxx-xxx-xxx.ngrok-free.app/line/webhook

📝 ngrokの具体的な使い方は別記事で解説予定です。
ngrokのインストール・起動・HTTPS URLの取得方法については、別途「ngrokでOpenClawを外部公開する方法」記事を公開予定です。

URLを入力したら「Verify」ボタンをクリックして接続テストを行います。「Success」と表示されれば設定は正しいです。

注意: Verifyを実行する前に、OpenClaw Gatewayが起動している必要があります。openclaw gateway status で起動中かどうかを確認してください。

ステップ7: OpenClawにLINEの認証情報を設定する

Channel access tokenとChannel secretをOpenClawに設定します。最新バージョンではSecretsコマンドを使った安全な管理が推奨されています。

推奨：Secretsコマンドで設定する（最新版）

openclaw secrets configure

対話式のウィザードが起動し、LINE用のChannel access tokenとChannel secretを安全に登録できます。設定ファイルには認証情報の参照のみが残り、実際の値は安全な場所に分離保管されます。

代替方法①：ファイルで管理する

認証情報をテキストファイルに保存して参照させる方法もあります。

{
  channels: {
    line: {
      enabled: true,
      tokenFile: "/path/to/line-token.txt",
      secretFile: "/path/to/line-secret.txt",
      dmPolicy: "pairing",
    },
  },
}

代替方法②：環境変数で管理する

環境変数を使う方法もあります。

export LINE_CHANNEL_ACCESS_TOKEN="your-token"
export LINE_CHANNEL_SECRET="your-secret"

⚠️ 直接書きは非推奨：設定ファイルにAPIキーを直接書くと、ファイルが漏洩した際にキーも流出します。上記のSecrets管理・ファイル参照・環境変数のいずれかの方法をご利用ください。

設定項目の補足：

  • enabled: LINEチャンネルを有効にする（true）
  • dmPolicy: "pairing" にすると、ペアリングしたユーザーのみと通信します（セキュリティ上おすすめ）

ステップ8: Gatewayを再起動する

設定を反映させるために、OpenClaw Gatewayを再起動します。

openclaw gateway restart

または、一度停止してから再起動する場合：

openclaw gateway stop
openclaw gateway start

Gatewayが正常に起動したことを確認してください。

ステップ9: LINEアカウントとペアリングする

最後に、あなた自身のLINEアカウントとOpenClawをペアリング（紐付け）します。

まず、LINE Developers ConsoleからBotのQRコードを取得するか、Botの友だち追加リンクを使って、作成したMessaging API BotをLINEの友だちに追加します。

次に、LINEでBotに任意のメッセージを送ると、OpenClawからペアリングコードが返ってきます。

ターミナルで以下のコマンドを実行して、ペアリング申請の一覧を確認します。

openclaw pairing list line

表示されたコード（例: ABC123）を使って、ペアリングを承認します。

openclaw pairing approve line <CODE>

承認が完了すると、LINEでBotに話しかけるとOpenClawが応答するようになります。🎉

よくあるトラブルと解決方法

トラブル① Webhook VerifyがSuccessにならない

原因として考えられること:

  • OpenClaw Gatewayが起動していない
  • Webhook URLのフォーマットが間違っている（/line/webhook がない）
  • HTTPSではなくHTTPのURLを入力している
  • ファイアウォールやポートの設定でアクセスがブロックされている

解決方法: まず openclaw gateway status でGatewayが起動中かを確認してください。次にブラウザで Webhook URL（https://yourdomain.com/line/webhook）に直接アクセスしてみて、接続できるか確認してください。

トラブル② BotにメッセージしてもOpenClawから応答がない

原因として考えられること:

  • config.json5 の設定が正しくない（スペルミス、引用符の漏れなど）
  • Gateway再起動後に設定が反映されていない
  • ペアリングが完了していない（dmPolicy: "pairing" の場合）

解決方法: config.json5 の記述を再度確認し、Gatewayを再起動してみてください。またGatewayのログを確認することで、エラーの手がかりが得られることがあります。

トラブル③ ngrokのURLが変わってしまった

ngrokの無料プランでは、起動のたびにURLが変わります。URLが変わるたびにLINE DevelopersのWebhook URLを更新し直す必要があります。

解決方法: 継続的に使うなら、固定URLが使えるngrokの有料プランか、VPS環境への移行を検討してください。

トラブル④ Channel access tokenが「Invalid」と言われる

原因: Channel access tokenが正しくコピーされていないか、再発行したトークンを使っていない可能性があります。

解決方法: LINE Developers Consoleでトークンを再発行し、config.json5 を更新してからGatewayを再起動してください。

まとめ

OpenClawとLINEの連携手順をまとめると、以下のとおりです。

  1. LINEプラグインをインストール（openclaw plugins install @openclaw/line）
  2. LINE Developersでアカウントを作成
  3. ProviderとMessaging APIチャンネルを作成
  4. Channel access tokenとChannel secretを取得
  5. Use webhookを有効化
  6. Webhook URLを設定（HTTPS必須）
  7. config.json5 にLINE設定を追記
  8. Gatewayを再起動
  9. ペアリングを完了

他のチャンネル連携（DiscordやTelegram）と比べると設定ステップは多いですが、一度設定してしまえば、毎日使い慣れたLINEからシームレスにOpenClawを活用できます。日本人にとっては最もなじみ深いメッセージアプリだからこそ、設定する価値は十分にあります。

ぜひ試してみてください！

関連記事

参考・公式リンク

タイトルとURLをコピーしました