Feishu

Feishu/Lark は、チームがチャット、ドキュメント共有、カレンダー管理、共同作業をまとめて行えるオールインワンのコラボレーションプラットフォームです。

ステータス: bot の DM とグループチャットで本番運用可能です。WebSocket がデフォルトモードで、webhook モードは任意です。

クイックスタート

openclaw channels login --channel feishu

openclaw gateway restart

アクセス制御

ダイレクトメッセージ

bot に DM できるユーザーを制御するには dmPolicy を設定します。

• "pairing" - 不明なユーザーはペアリングコードを受け取り、CLI で承認します
• "allowlist" - allowFrom に列挙されたユーザーのみがチャットできます
• "open" - allowFrom に "*" が含まれる場合のみ公開 DM を許可します。制限的なエントリがある場合は、一致するユーザーのみがチャットできます

ペアリングリクエストを承認する:

openclaw pairing list feishuopenclaw pairing approve feishu <CODE>

グループチャット

グループポリシー (channels.feishu.groupPolicy):

デフォルト: allowlist

メンション要件 (channels.feishu.requireMention):

• true - @mention を必須にします（デフォルト）
• false - @mention なしで応答します
• グループ単位の上書き: channels.feishu.groups.<chat_id>.requireMention
• ブロードキャスト専用の @all と @_all は bot メンションとして扱われません。@all と bot への直接メンションの両方を含むメッセージは、引き続き bot メンションとして扱われます。

グループ設定例

すべてのグループを許可し、@mention を不要にする

{  channels: {    feishu: {      groupPolicy: "open",    },  },}

すべてのグループを許可し、引き続き @mention を必須にする

{  channels: {    feishu: {      groupPolicy: "open",      requireMention: true,    },  },}

特定のグループのみ許可する

{  channels: {    feishu: {      groupPolicy: "allowlist",      // Group IDs look like: oc_xxx      groupAllowFrom: ["oc_xxx", "oc_yyy"],    },  },}

allowlist モードでは、明示的な groups.<chat_id> エントリを追加してグループを許可することもできます。明示的なエントリは groupPolicy: "disabled" を上書きしません。groups.* 配下のワイルドカードデフォルトは一致するグループを設定しますが、それだけではグループを許可しません。

{  channels: {    feishu: {      groupPolicy: "allowlist",      groups: {        oc_xxx: {          requireMention: false,        },      },    },  },}

グループ内の送信者を制限する

{  channels: {    feishu: {      groupPolicy: "allowlist",      groupAllowFrom: ["oc_xxx"],      groups: {        oc_xxx: {          // User open_ids look like: ou_xxx          allowFrom: ["ou_user1", "ou_user2"],        },      },    },  },}

グループ/ユーザー ID を取得する

グループ ID (chat_id、形式: oc_xxx)

Feishu/Lark でグループを開き、右上のメニューアイコンをクリックして 設定 に移動します。グループ ID (chat_id) は設定ページに表示されます。

ユーザー ID (open_id、形式: ou_xxx)

gateway を起動し、bot に DM を送信してからログを確認します。

openclaw logs --follow

ログ出力で open_id を探します。保留中のペアリングリクエストも確認できます。

openclaw pairing list feishu

よく使うコマンド

トラブルシューティング

bot がグループチャットで応答しない

1. bot がグループに追加されていることを確認します
2. bot に @mention していることを確認します（デフォルトで必須）
3. groupPolicy が "disabled" でないことを確認します
4. ログを確認します: openclaw logs --follow

bot がメッセージを受信しない

1. bot が Feishu Open Platform / Lark Developer で公開および承認されていることを確認します
2. イベントサブスクリプションに im.message.receive_v1 が含まれていることを確認します
3. 永続接続（WebSocket）が選択されていることを確認します
4. 必要なすべての権限スコープが付与されていることを確認します
5. gateway が実行中であることを確認します: openclaw gateway status
6. ログを確認します: openclaw logs --follow

QR セットアップが Feishu モバイルアプリで反応しない

1. セットアップを再実行します: openclaw channels login --channel feishu
2. 手動セットアップを選択します
3. Feishu Open Platform で自社開発アプリを作成し、その App ID と App Secret をコピーします
4. それらの認証情報をセットアップウィザードに貼り付けます

App Secret が漏えいした

1. Feishu Open Platform / Lark Developer で App Secret をリセットします
2. config 内の値を更新します
3. gateway を再起動します: openclaw gateway restart

高度な設定

複数アカウント

{  channels: {    feishu: {      defaultAccount: "main",      accounts: {        main: {          appId: "cli_xxx",          appSecret: "xxx",          name: "Primary bot",          tts: {            providers: {              openai: { voice: "shimmer" },            },          },        },        backup: {          appId: "cli_yyy",          appSecret: "yyy",          name: "Backup bot",          enabled: false,        },      },    },  },}

defaultAccount は、送信 API が accountId を指定しない場合に使用されるアカウントを制御します。 accounts.<id>.tts は messages.tts と同じ形状を使用し、グローバル TTS config に対してディープマージされます。そのため、複数 bot の Feishu セットアップでは、共有プロバイダー認証情報をグローバルに保持しながら、アカウントごとに voice、model、persona、auto mode のみを上書きできます。

メッセージ制限

• textChunkLimit - 送信テキストチャンクサイズ（デフォルト: 2000 文字）
• mediaMaxMb - メディアのアップロード/ダウンロード制限（デフォルト: 30 MB）

ストリーミング

Feishu/Lark はインタラクティブカードによるストリーミング返信に対応しています。有効にすると、bot はテキスト生成中にカードをリアルタイムで更新します。

{  channels: {    feishu: {      streaming: true, // enable streaming card output (default: true)      blockStreaming: true, // opt into completed-block streaming    },  },}

返信全体を 1 つのメッセージで送信するには streaming: false を設定します。blockStreaming はデフォルトでオフです。最終返信の前に完了済み assistant ブロックをフラッシュしたい場合のみ有効にします。

クォータ最適化

2 つの任意フラグで Feishu/Lark API 呼び出し回数を減らします。

• typingIndicator（デフォルト true）: タイピングリアクション呼び出しをスキップするには false を設定します
• resolveSenderNames（デフォルト true）: 送信者プロフィール検索をスキップするには false を設定します

{  channels: {    feishu: {      typingIndicator: false,      resolveSenderNames: false,    },  },}

ACP セッション

Feishu/Lark は DM とグループスレッドメッセージで ACP に対応しています。Feishu/Lark ACP はテキストコマンド駆動です。ネイティブのスラッシュコマンドメニューはないため、会話内で /acp ... メッセージを直接使用します。

永続 ACP バインディング

{  agents: {    list: [      {        id: "codex",        runtime: {          type: "acp",          acp: {            agent: "codex",            backend: "acpx",            mode: "persistent",            cwd: "/workspace/openclaw",          },        },      },    ],  },  bindings: [    {      type: "acp",      agentId: "codex",      match: {        channel: "feishu",        accountId: "default",        peer: { kind: "direct", id: "ou_1234567890" },      },    },    {      type: "acp",      agentId: "codex",      match: {        channel: "feishu",        accountId: "default",        peer: { kind: "group", id: "oc_group_chat:topic:om_topic_root" },      },      acp: { label: "codex-feishu-topic" },    },  ],}

チャットから ACP を起動する

Feishu/Lark の DM またはスレッドで:

/acp spawn codex --thread here

--thread here は DM と Feishu/Lark スレッドメッセージで機能します。バインドされた会話内の後続メッセージは、その ACP セッションに直接ルーティングされます。

マルチエージェントルーティング

Feishu/Lark の DM またはグループを別々のエージェントへルーティングするには bindings を使用します。

{  agents: {    list: [      { id: "main" },      { id: "agent-a", workspace: "/home/user/agent-a" },      { id: "agent-b", workspace: "/home/user/agent-b" },    ],  },  bindings: [    {      agentId: "agent-a",      match: {        channel: "feishu",        peer: { kind: "direct", id: "ou_xxx" },      },    },    {      agentId: "agent-b",      match: {        channel: "feishu",        peer: { kind: "group", id: "oc_zzz" },      },    },  ],}

ルーティングフィールド:

• match.channel: "feishu"
• match.peer.kind: "direct"（DM）または "group"（グループチャット）
• match.peer.id: ユーザー Open ID (ou_xxx) またはグループ ID (oc_xxx)

検索のヒントは グループ/ユーザー ID を取得する を参照してください。

ユーザーごとのエージェント分離（動的エージェント作成）

各 DM ユーザーに対して 分離されたエージェントインスタンス を自動作成するには、dynamicAgentCreation を有効にします。各ユーザーには次が割り当てられます。

• 独立したワークスペースディレクトリ
• 個別の USER.md / SOUL.md / MEMORY.md
• プライベートな会話履歴
• 分離された Skills と状態

これは、各ユーザーに自分専用のプライベート AI アシスタント体験を提供したい公開 bot では不可欠です。

クイックセットアップ

{  channels: {    feishu: {      dmPolicy: "open",      allowFrom: ["*"],      dynamicAgentCreation: {        enabled: true,        workspaceTemplate: "~/.openclaw/workspace-{agentId}",        agentDirTemplate: "~/.openclaw/agents/{agentId}/agent",      },    },  },  session: {    // Critical: makes each user's DM their "main session"    // Automatically loads USER.md / SOUL.md / MEMORY.md    // For stronger isolation, use "per-channel-peer" instead    dmScope: "main",  },}

仕組み

新しいユーザーが最初の DM を送信すると:

1. チャンネルが一意の agentId を生成します。デフォルトアカウントでは feishu-{user_open_id}、名前付きアカウントでは境界付きのアカウント接頭辞付き ID ダイジェストになります
2. workspaceTemplate パスに新しいワークスペースを作成します
3. エージェントを登録し、このユーザー向けのバインディングを作成します
4. ワークスペースヘルパーが初回アクセス時にブートストラップファイル（AGENTS.md、SOUL.md、USER.md など）を確保します
5. このユーザーからの今後すべてのメッセージを専用エージェントへルーティングします

設定オプション

テンプレート変数:

• {agentId} - 生成されたエージェント ID（例: feishu-ou_xxxxxx または feishu-support-<identity_digest>）
• {userId} - 送信者の Feishu open_id（例: ou_xxxxxx）

セッションスコープ

session.dmScope は、ダイレクトメッセージをエージェントセッションにどう対応付けるかを制御します。これはすべてのチャンネルに影響するグローバル設定です。

トレードオフ: "main" を使うとブートストラップファイル（USER.md、SOUL.md、MEMORY.md）の自動読み込みが有効になりますが、すべてのチャンネルのすべての DM が同じセッションキーのパターンを共有します。ブートストラップの自動読み込みよりも分離が重要な公開マルチユーザーボットでは、"per-channel-peer" を検討し、ブートストラップファイルを手動で管理してください。

{  session: {    // 単一ユーザーの個人用ボット向け: 自動ブートストラップ読み込みを有効化    dmScope: "main",     // 公開マルチユーザーボット向け: より強い分離    // dmScope: "per-channel-peer",  },}

一般的なマルチユーザーデプロイ

{  channels: {    feishu: {      appId: "cli_xxx",      appSecret: "xxx",      dmPolicy: "open",      allowFrom: ["*"],      groupPolicy: "open",      requireMention: true,      dynamicAgentCreation: {        enabled: true,        workspaceTemplate: "~/.openclaw/workspace-{agentId}",        agentDirTemplate: "~/.openclaw/agents/{agentId}/agent",      },    },  },  session: {    // 分離要件に応じて dmScope を選択:    // ブートストラップ自動読み込みには "main"、より強い分離には "per-channel-peer"    dmScope: "main",  },  bindings: [], // 空 - 動的エージェントが自動バインドされる}

検証

Gateway ログを確認して、動的作成が機能していることを確認します:

feishu: creating dynamic agent "feishu-ou_xxxxxx" for user ou_xxxxxxworkspace: /Users/you/.openclaw/workspace-feishu-ou_xxxxxxfeishu: dynamic agent created, new route: agent:feishu-ou_xxxxxx:main

作成されたすべてのワークスペースを一覧表示します:

ls -la ~/.openclaw/workspace-*

注記

• ワークスペース分離: 各ユーザーは自身のワークスペースディレクトリとエージェントインスタンスを持ちます。通常のメッセージングフロー内では、ユーザーは互いの会話履歴やファイルを見ることはできません。
• セキュリティ境界: これはメッセージングコンテキストの分離メカニズムであり、敵対的な同居テナントに対するセキュリティ境界ではありません。エージェントプロセスとホスト環境は共有されます。
• bindings は空にする必要があります: 動的エージェントは自身のバインディングを自動登録します
• アップグレードパス: 既存の手動バインディングは動的エージェントと並行して引き続き機能します
• session.dmScope はグローバルです: これは Feishu だけでなく、すべてのチャンネルに影響します

設定リファレンス

完全な設定: Gateway 設定

サポートされるメッセージタイプ

受信

• ✅ テキスト
• ✅ リッチテキスト（投稿）
• ✅ 画像
• ✅ ファイル
• ✅ 音声
• ✅ 動画/メディア
• ✅ ステッカー

受信した Feishu/Lark の音声メッセージは、生の file_key JSON ではなく、メディアプレースホルダーとして正規化されます。tools.media.audio が設定されている場合、OpenClaw はボイスメモリソースをダウンロードし、エージェントターンの前に共有音声文字起こしを実行するため、エージェントは発話の文字起こしを受け取ります。Feishu が音声ペイロードに文字起こしテキストを直接含めている場合、そのテキストが追加の ASR 呼び出しなしで使用されます。音声文字起こしプロバイダーがない場合でも、エージェントは生の Feishu リソースペイロードではなく、<media:audio> プレースホルダーと保存済み添付ファイルを受け取ります。

送信

• ✅ テキスト
• ✅ 画像
• ✅ ファイル
• ✅ 音声
• ✅ ビデオ/メディア
• ✅ インタラクティブカード（ストリーミング更新を含む）
• ⚠️ リッチテキスト（投稿形式のフォーマット。Feishu/Lark の完全な作成機能には対応していません）

ネイティブの Feishu/Lark 音声バブルは Feishu の audio メッセージタイプを使用し、 Ogg/Opus アップロードメディア（file_type: "opus"）が必要です。既存の .opus と .ogg メディアは、 ネイティブ音声として直接送信されます。MP3/WAV/M4A とその他の音声と思われる形式は、 返信が音声配信（audioAsVoice / メッセージツール asVoice、TTS 音声メモ返信を含む）を要求した場合にのみ、 ffmpeg で 48kHz Ogg/Opus にトランスコードされます。通常の MP3 添付ファイルは通常のファイルのままです。ffmpeg がない場合、または 変換に失敗した場合、OpenClaw はファイル添付にフォールバックし、その理由をログに記録します。

スレッドと返信

• ✅ インライン返信
• ✅ スレッド返信
• ✅ スレッドメッセージに返信する場合、メディア返信はスレッドを認識したままになります

groupSessionScope: "group_topic" と "group_topic_sender" では、ネイティブの Feishu/Lark トピックグループはイベントの thread_id（omt_*）を標準の トピックセッションキーとして使用します。ネイティブトピックの開始イベントで thread_id が省略されている場合、OpenClaw は ターンをルーティングする前に Feishu からそれを補完します。OpenClaw がスレッドに変換する通常のグループ返信では、 返信ルートメッセージ ID（om_*）を引き続き使用するため、 最初のターンと後続ターンは同じセッションに残ります。

関連

• チャンネル概要 - 対応しているすべてのチャンネル
• ペアリング - DM 認証とペアリングフロー
• グループ - グループチャットの動作とメンション制御
• チャンネルルーティング - メッセージのセッションルーティング
• セキュリティ - アクセスモデルと強化