なぜFeishuなのか？
Feishu（飛書）は、国際的にはLarkとして知られる、ByteDanceのエンタープライズコラボレーションプラットフォームです——中国のテック企業、スタートアップ、そして東南アジアでも広く使用されています。OpenClaw v2026.2.2で、Feishuはプラットフォーム初の公式サポートされた中国チャットクライアントとなりました。
- •パブリックURLは不要 ——ngrokも、ドメインも、Webhookサーバーも不要
- •ファイアウォールの背後でも動作 ——接続はマシンからのアウトバウンド
- •低遅延 ——リアルタイム双方向メッセージング
- •リッチコンテンツサポート ——テキスト、画像、ファイル、オーディオ、ビデオ、スタンプ
前提条件
- •OpenClaw v2026.2.2以降
- •Feishu/Larkエンタープライズアカウント（無料枠で可）
- •Feishuオープンプラットフォームでアプリを作成するための管理者アクセス
ステップ1：Feishuアプリを作成
- 1.Feishuオープンプラットフォーム（国際テナントの場合はLark Developer Console）にアクセス
- 2.カスタムアプリを作成をクリック
- 3.アプリ名（例：「OpenClaw Agent」）と説明を設定
- 4.アイコンをアップロード（OpenClawのロブスターロゴがぴったりです）
- 5.認証情報ページからApp ID（形式：
cli_xxx）とApp Secretをコピー
ステップ2：アプリの権限を設定
アプリの権限設定で、以下のスコープを有効にします：
| 権限 | 目的 |
|---|---|
im:message | メッセージの送受信 |
im:message.group_at_msg | グループチャットでの@メンションの受信 |
im:resource | 画像とファイルへのアクセス |
contact:user.id:readonly | ユーザーの識別 |
権限を追加した後、公開をクリックしてレビューに送信します。ほとんどのエンタープライズテナントでは、自作アプリは自動承認されます。
ステップ3：イベントサブスクリプションを有効にする
- 1.アプリ設定で、イベントサブスクリプションに移動
- 2.WebSocketモード（長時間接続）を選択——これが重要です。パブリックURLが必要なWebhookモードは使用しないでください。
- 3.以下のイベントをサブスクライブ：
ステップ4：OpenClawを設定
OpenClawの設定にFeishuの認証情報を追加します。~/.openclaw/.envを編集：
FEISHU_APP_ID=cli_xxxxxxxxxxxxx
FEISHU_APP_SECRET=your_app_secret_here
またはOpenClaw設定ファイル（~/.openclaw/config.yaml）を使用する場合：
channels:
feishu:
enabled: true
appId: cli_xxxxxxxxxxxxx
appSecret: your_app_secret_here
OpenClawを再起動：
openclaw restart
Feishu WebSocket接続が確立されたことを確認するログメッセージが表示されるはずです。
ステップ5：接続をテスト
Feishuを開き、チャットリストでアプリを見つけます（ステップ1で設定したアプリ名で検索）。メッセージを送信：
> Hello!
- •テキストメッセージ
- •画像（ビジョン対応モデルを使用している場合、エージェントが分析できます）
- •ファイル（エージェントがドキュメントを読み取れます）
- •音声メッセージ（テキストに変換されて処理されます）
グループチャット設定
OpenClawは3つのアクセスモードでFeishuグループチャットをサポートしています：
| モード | 動作 |
|---|---|
open（デフォルト） | @メンションされた時にグループメンバーの誰でもボットをトリガー可能 |
allowlist | @メンションしても承認されたユーザーのみインタラクション可能 |
disabled | グループメッセージは完全に無視 |
config.yamlで設定：
channels:
feishu:
groupAccess: open # or "allowlist" or "disabled"
allowedUsers: # only used with "allowlist" mode
- user_id_1
- user_id_2
グループチャットでは、エージェントは@メンションされた場合のみ応答し、忙しいチャンネルでのノイズを防ぎます。
ストリーミングレスポンス
OpenClawはインタラクティブカードを使用してFeishuでAIレスポンスのストリーミングをサポートしています。完全なレスポンスを待つ代わりに、エージェントは初期カードを送信し、AIがテキストを生成するにつれてリアルタイムで更新します。これにより、長いレスポンスのユーザー体験が大幅に向上します。
ストリーミングはデフォルトで有効です。無効にするには：
channels:
feishu:
streaming: false
サポートされるメッセージタイプ
| 方向 | サポートされるタイプ |
|---|---|
| インバウンド（ユーザー → エージェント） | テキスト、リッチテキスト（post）、画像、ファイル、オーディオ、ビデオ、スタンプ |
| アウトバウンド（エージェント → ユーザー） | テキスト、画像、ファイル、オーディオ、インタラクティブカード |
トラブルシューティング
「App not found」エラー: アプリがFeishuテナントで公開され承認されていることを確認してください。エンタープライズテナントの自作アプリは通常自動承認されますが、一部の組織では管理者の承認が必要です。
エージェントからの応答なし: OpenClawログ（openclaw logs）でWebSocket接続エラーを確認してください。App IDとApp Secretが正しいことを確認します。
グループチャットでメッセージが届かない: ボットがグループに追加されていること、ユーザーがボットを正しく@メンションしていることを確認してください。groupAccess設定を確認します。
接続が切断される: WebSocket接続は自動的に再接続します。切断が頻繁な場合は、ネットワークの安定性やファイアウォール設定を確認してください。
コミュニティブリッジの使用（代替方法）
ネイティブ統合を超える機能が必要な場合、コミュニティが管理するAlexAnysのfeishu-openclaw bridgeは、カスタムメッセージフォーマットや高度なグループ管理などの追加機能を提供します。セットアップには約5分かかり、パブリックサーバーは不要です。
完全なドキュメントについては、公式Feishuチャンネルガイドをご覧ください。