OpenClawとFeishu（Lark）ボットの接続

Feishu（海外では Lark として知られる）は ByteDance が開発した企業コラボレーションプラットフォームで、インスタントメッセージング、ドキュメントコラボレーション、ビデオ会議などの機能を備えています。OpenClaw はプラグインシステムを通じて Feishu チャンネルをサポートし、Feishu 内で AI エージェントと直接チャットでき、インテリジェントカスタマーサービス、ナレッジ Q&A、ワークフロー自動化などのユースケースに対応します。

前提条件

開始前に、以下の準備が必要です：

デプロイ済みで動作している OpenClaw インスタンス
Feishu オープンプラットフォームの企業セルフビルドアプリケーション（作成には管理者権限が必要）
アプリケーションの App ID と App Secret
設定済みのイベントサブスクリプションコールバック URL（公開アクセス可能な URL が必要）

Feishu セルフビルドアプリケーションの作成

まず、Feishu オープンプラットフォーム（open.feishu.cn）にログインし、開発者コンソールに移動します。「企業セルフビルドアプリケーションの作成」をクリックし、アプリケーション名と説明を入力します。作成後、アプリケーションの「認証情報と基本情報」ページで App ID と App Secret を取得できます。これらの値は後の設定で必要になります。

次に、アプリケーションに「Bot」機能を追加する必要があります。アプリケーションの「アプリ機能の追加」セクションで「Bot」を選択すると、アプリケーションが Feishu チャットでメッセージを送受信できるようになります。

権限とイベントサブスクリプションの設定

アプリケーションの「権限管理」ページで、以下の権限を有効にします：

im:message — メッセージの送受信
im:message.group_at_msg — グループチャットでボットへの @メンションメッセージの受信
im:message.p2p_msg — ダイレクトメッセージの受信
im:resource — メッセージ内のリソースファイルへのアクセス

「イベントサブスクリプション」ページで、リクエスト URL を OpenClaw インスタンスの Feishu webhook エンドポイントに設定します。OpenClaw Feishu プラグインはデフォルトパス /webhooks/feishu でリッスンするため、完全な URL は https://your-domain.com/webhooks/feishu のようになります。

サブスクライブするイベントは im.message.receive_v1（メッセージ受信イベント）です。設定後、Feishu が検証リクエストを送信しますが、これは OpenClaw プラグインが自動的に処理します。

Feishu プラグインのインストール

OpenClaw の Feishu チャンネルはプラグインシステムを通じて提供されます。まずプラグインをインストールします：

openclaw plugin install feishu

インストール後、インタラクティブログインコマンドを使用して設定できます：

openclaw channels login feishu

システムが App ID、App Secret、Verification Token（イベントサブスクリプションページで確認可能）の入力を求めます。これらの認証情報はローカル設定に安全に保存されます。

openclaw.json の手動設定

openclaw.json 設定ファイルを直接編集して Feishu チャンネルを設定することもできます：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_xxxxxxxxxx",
      "appSecret": "your-app-secret",
      "verificationToken": "your-verification-token",
      "encryptKey": "your-encrypt-key"
    }
  }
}

encryptKey はオプションで、Feishu オープンプラットフォームで Encrypt Key を設定した場合にのみ必要です。暗号化を有効にするとデータ転送のセキュリティが強化され、本番環境では推奨されます。

公開とテスト

設定後、Feishu オープンプラットフォームに戻り、アプリケーションの利用可能範囲をターゲットユーザーまたは部署に設定してから、「バージョン作成」をクリックしてレビューに提出します。企業内部利用の場合、管理者が直接承認できます。

公開が成功したら、Feishu のチャットリストでボット名を検索し、メッセージを送信して正しく応答するかテストします。

グループチャットでの使用

ボットを Feishu のグループチャットに追加すると、デフォルトでは @メンションされたメッセージにのみ応答します。この動作は設定で調整できます：

{
  "channels": {
    "feishu": {
      "groupBehavior": "mention_only"
    }
  }
}

groupBehavior は2つのモードをサポートしています：mention_only（@メンションにのみ応答）と all（すべてのメッセージに応答）。メンバーの多いグループチャットでは、不要なノイズを避けるため mention_only モードが推奨されます。

セキュリティ設定

OpenClaw のホワイトリスト機能を使用して、ボットとインタラクションできるユーザーを制限することを推奨します：

{
  "channels": {
    "feishu": {
      "allowlist": ["user_id_1", "user_id_2"]
    }
  }
}

OpenClaw の DM ペアリング機能を使用して、グループチャットでボットを使用する前にダイレクトメッセージで本人確認を要求することもできます。

他のチャンネルとの共存

Feishu チャンネルは OpenClaw がサポートする他のチャンネルと同時に実行できます。すべてのチャンネルは同じ AI モデルバックエンドを共有します。Feishu での会話は Telegram、Discord などの他のプラットフォームでの会話とは独立していますが、同じナレッジベースとツール設定を共有できます。これにより、企業は社内従業員（Feishu 経由）と外部顧客（他のプラットフォーム経由）に同時に AI サービスを提供できます。

トラブルシューティング

ボットがメッセージを受信できない場合は、イベントサブスクリプションのコールバック URL が正しいこと、アプリケーションが公開されていること、ネットワークファイアウォールが Feishu サーバーからのリクエストを許可していることを確認してください。Feishu オープンプラットフォームの「イベントサブスクリプション」ページにはロギング機能があり、イベントプッシュのステータスとエラーメッセージを確認できます。