Feishu

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

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

クイックスタート

openclaw channels login --channel feishu

openclaw gateway restart

アクセス制御

ダイレクトメッセージ

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

• "pairing" - 不明なユーザーにはペアリングコードが送られます。CLI で承認します
• "allowlist" - allowFrom に listed されたユーザーのみがチャットできます（デフォルト: bot 所有者のみ）
• "open" - allowFrom に "*" が含まれる場合のみパブリック DM を許可します。制限付きのエントリがある場合、一致するユーザーのみがチャットできます
• "disabled" - すべての 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. 設定内の値を更新します
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 設定の上にディープマージされます。そのため、複数 bot の Feishu 設定では、共有 provider の認証情報をグローバルに保持しながら、アカウントごとに 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 を取得する を参照してください。

設定リファレンス

完全な設定: 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 認証とペアリングフロー
• グループ - グループチャットの動作とメンションゲート
• チャネルルーティング - メッセージのセッションルーティング
• セキュリティ - アクセスモデルと強化