メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Feishu/Lark は、チームがチャットし、ドキュメントを共有し、カレンダーを管理し、共同で作業を進めるためのオールインワンコラボレーションプラットフォームです。 状態: bot の DM + グループチャットで本番運用可能。WebSocket がデフォルトモードで、webhook モードは任意です。

​
クイックスタート

OpenClaw 2026.4.25 以降が必要です。確認するには openclaw --version を実行します。アップグレードは openclaw update で行います。
1

チャンネル設定ウィザードを実行する

openclaw channels login --channel feishu
Feishu Open Platform の App ID と App Secret を貼り付けるには手動設定を選ぶか、bot を自動作成するには QR 設定を選びます。中国国内版の Feishu モバイルアプリが QR コードに反応しない場合は、設定を再実行して手動設定を選んでください。
2

設定が完了したら、変更を適用するために gateway を再起動する

openclaw gateway restart

​
アクセス制御

​
ダイレクトメッセージ

bot に DM できるユーザーを制御するには dmPolicy を設定します。
  • "pairing" - 不明なユーザーにはペアリングコードが送られます。CLI で承認します
  • "allowlist" - allowFrom に listed されたユーザーのみがチャットできます（デフォルト: bot 所有者のみ）
  • "open" - allowFrom に "*" が含まれる場合のみパブリック DM を許可します。制限付きのエントリがある場合、一致するユーザーのみがチャットできます
  • "disabled" - すべての DM を無効にします
ペアリングリクエストを承認する: 
openclaw pairing list feishu
openclaw pairing approve feishu <CODE>

​
グループチャット

グループポリシー（channels.feishu.groupPolicy）:
値動作
"open"グループ内のすべてのメッセージに応答します
"allowlist"groupAllowFrom 内、または groups.<chat_id> 配下で明示的に設定されたグループにのみ応答します
"disabled"すべてのグループメッセージを無効にします。明示的な groups.<chat_id> エントリでも上書きされません
デフォルト: 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 を取得

​
ユーザー ID（open_id、形式: ou_xxx）

Gateway を起動し、bot に DM を送信してからログを確認します。 
openclaw logs --follow
ログ出力内の open_id を探します。保留中のペアリングリクエストも確認できます。 
openclaw pairing list feishu

​
一般的なコマンド

コマンド説明
/statusbot の状態を表示します
/reset現在のセッションをリセットします
/modelAI モデルを表示または切り替えます
Feishu/Lark はネイティブのスラッシュコマンドメニューをサポートしていないため、これらはプレーンテキストメッセージとして送信してください。

​
トラブルシューティング

​
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 設定
設定説明デフォルト
channels.feishu.enabledチャネルを有効化/無効化true
channels.feishu.domainAPI ドメイン（feishu または lark）feishu
channels.feishu.connectionModeイベント転送（websocket または webhook）websocket
channels.feishu.defaultAccountアウトバウンドルーティングのデフォルトアカウントdefault
channels.feishu.verificationTokenwebhook モードで必須-
channels.feishu.encryptKeywebhook モードで必須-
channels.feishu.webhookPathWebhook ルートパス/feishu/events
channels.feishu.webhookHostWebhook バインドホスト127.0.0.1
channels.feishu.webhookPortWebhook バインドポート3000
channels.feishu.accounts.<id>.appIdアプリ ID-
channels.feishu.accounts.<id>.appSecretアプリシークレット-
channels.feishu.accounts.<id>.domainアカウントごとのドメイン上書きfeishu
channels.feishu.accounts.<id>.ttsアカウントごとの TTS 上書きmessages.tts
channels.feishu.dmPolicyDM ポリシーallowlist
channels.feishu.allowFromDM 許可リスト（open_id リスト）[BotOwnerId]
channels.feishu.groupPolicyグループポリシーallowlist
channels.feishu.groupAllowFromグループ許可リスト-
channels.feishu.requireMentionグループ内で @mention を必須にするtrue
channels.feishu.groups.<chat_id>.requireMentionグループごとの @mention 上書き。明示的な ID は許可リストモードでもグループを許可継承
channels.feishu.groups.<chat_id>.enabled特定のグループを有効化/無効化true
channels.feishu.textChunkLimitメッセージチャンクサイズ2000
channels.feishu.mediaMaxMbメディアサイズ制限30
channels.feishu.streamingストリーミングカード出力true
channels.feishu.blockStreaming完了ブロック返信ストリーミングfalse
channels.feishu.typingIndicator入力中リアクションを送信true
channels.feishu.resolveSenderNames送信者の表示名を解決true

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

​
受信

  • ✅ テキスト
  • ✅ リッチテキスト（投稿）
  • ✅ 画像
  • ✅ ファイル
  • ✅ 音声
  • ✅ 動画/メディア
  • ✅ ステッカー
受信した 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_*）を使用するため、最初のターンと後続ターンは同じセッションに留まります。

​
関連