--- read_when: - Feishu/Lark ボットを接続したい場合 - Feishu チャネルを設定しています summary: Feishu ボットの概要、機能、設定 title: Feishu x-i18n: generated_at: "2026-05-11T20:20:36Z" model: gpt-5.5 provider: openai source_hash: 8d4e43c65072d44cb5973a1ed09cb5336f18d100d0cb5b43c5e31f37aecff329 source_path: channels/feishu.md workflow: 16 --- Feishu/Lark は、チームがチャットし、ドキュメントを共有し、カレンダーを管理し、共同で作業を進めるためのオールインワンコラボレーションプラットフォームです。 **状態:** bot の DM + グループチャットで本番運用可能。WebSocket がデフォルトモードで、webhook モードは任意です。 --- ## クイックスタート OpenClaw 2026.4.25 以降が必要です。確認するには `openclaw --version` を実行します。アップグレードは `openclaw update` で行います。 ```bash openclaw channels login --channel feishu ``` Feishu Open Platform の App ID と App Secret を貼り付けるには手動設定を選ぶか、bot を自動作成するには QR 設定を選びます。中国国内版の Feishu モバイルアプリが QR コードに反応しない場合は、設定を再実行して手動設定を選んでください。 ```bash openclaw gateway restart ``` --- ## アクセス制御 ### ダイレクトメッセージ bot に DM できるユーザーを制御するには `dmPolicy` を設定します。 - `"pairing"` - 不明なユーザーにはペアリングコードが送られます。CLI で承認します - `"allowlist"` - `allowFrom` に listed されたユーザーのみがチャットできます（デフォルト: bot 所有者のみ） - `"open"` - `allowFrom` に `"*"` が含まれる場合のみパブリック DM を許可します。制限付きのエントリがある場合、一致するユーザーのみがチャットできます - `"disabled"` - すべての DM を無効にします **ペアリングリクエストを承認する:** ```bash openclaw pairing list feishu openclaw pairing approve feishu ``` ### グループチャット **グループポリシー**（`channels.feishu.groupPolicy`）: | 値 | 動作 | | ------------- | -------------------------------------------------------------------------------------------- | | `"open"` | グループ内のすべてのメッセージに応答します | | `"allowlist"` | `groupAllowFrom` 内、または `groups.` 配下で明示的に設定されたグループにのみ応答します | | `"disabled"` | すべてのグループメッセージを無効にします。明示的な `groups.` エントリでも上書きされません | デフォルト: `allowlist` **メンション要件**（`channels.feishu.requireMention`）: - `true` - @mention を必須にします（デフォルト） - `false` - @mention なしで応答します - グループごとの上書き: `channels.feishu.groups..requireMention` - ブロードキャスト専用の `@all` と `@_all` は bot へのメンションとして扱われません。`@all` と bot への直接メンションの両方を含むメッセージは、引き続き bot へのメンションとして扱われます。 --- ## グループ設定例 ### すべてのグループを許可し、@mention を不要にする ```json5 { channels: { feishu: { groupPolicy: "open", }, }, } ``` ### すべてのグループを許可し、引き続き @mention を必須にする ```json5 { channels: { feishu: { groupPolicy: "open", requireMention: true, }, }, } ``` ### 特定のグループのみを許可する ```json5 { channels: { feishu: { groupPolicy: "allowlist", // Group IDs look like: oc_xxx groupAllowFrom: ["oc_xxx", "oc_yyy"], }, }, } ``` `allowlist` モードでは、明示的な `groups.` エントリを追加してグループを許可することもできます。明示的なエントリは `groupPolicy: "disabled"` を上書きしません。`groups.*` 配下のワイルドカードデフォルトは一致するグループを設定しますが、それ自体ではグループを許可しません。 ```json5 { channels: { feishu: { groupPolicy: "allowlist", groups: { oc_xxx: { requireMention: false, }, }, }, }, } ``` ### グループ内の送信者を制限する ```json5 { 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 を取得](/images/feishu-get-group-id.png) ### ユーザー ID（`open_id`、形式: `ou_xxx`） Gateway を起動し、bot に DM を送信してからログを確認します。 ```bash openclaw logs --follow ``` ログ出力内の `open_id` を探します。保留中のペアリングリクエストも確認できます。 ```bash openclaw pairing list feishu ``` --- ## 一般的なコマンド | コマンド | 説明 | | --------- | ---------------------------- | | `/status` | bot の状態を表示します | | `/reset` | 現在のセッションをリセットします | | `/model` | AI モデルを表示または切り替えます | 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` --- ## 高度な設定 ### 複数アカウント ```json5 { 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..tts` は `messages.tts` と同じ形を使用し、グローバルな TTS 設定の上にディープマージされます。そのため、複数 bot の Feishu 設定では、共有 provider の認証情報をグローバルに保持しながら、アカウントごとに voice、model、persona、または auto mode だけを上書きできます。 ### メッセージ制限 - `textChunkLimit` - アウトバウンドテキストのチャンクサイズ（デフォルト: `2000` 文字） - `mediaMaxMb` - メディアのアップロード/ダウンロード制限（デフォルト: `30` MB） ### ストリーミング Feishu/Lark はインタラクティブカードによるストリーミング返信をサポートします。有効にすると、bot はテキストを生成しながらリアルタイムでカードを更新します。 ```json5 { 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` を設定します ```json5 { channels: { feishu: { typingIndicator: false, resolveSenderNames: false, }, }, } ``` ### ACP セッション Feishu/Lark は DM とグループスレッドメッセージで ACP をサポートします。Feishu/Lark の ACP はテキストコマンド駆動です。ネイティブのスラッシュコマンドメニューはないため、会話内で `/acp ...` メッセージを直接使用してください。 #### 永続 ACP バインディング ```json5 { 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 またはスレッド内で: ```text /acp spawn codex --thread here ``` `--thread here` は DM と Feishu/Lark のスレッドメッセージで機能します。バインドされた会話内の後続メッセージは、その ACP セッションへ直接ルーティングされます。 ### マルチエージェントルーティング Feishu/Lark の DM またはグループを別々のエージェントにルーティングするには `bindings` を使用します。 ```json5 { 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 を取得する](#get-groupuser-ids) を参照してください。 --- ## 設定リファレンス 完全な設定: [Gateway 設定](/ja-JP/gateway/configuration) | 設定 | 説明 | デフォルト | | ------------------------------------------------- | -------------------------------------------------------------------------------- | ---------------- | | `channels.feishu.enabled` | チャネルを有効化/無効化 | `true` | | `channels.feishu.domain` | API ドメイン（`feishu` または `lark`） | `feishu` | | `channels.feishu.connectionMode` | イベント転送（`websocket` または `webhook`） | `websocket` | | `channels.feishu.defaultAccount` | アウトバウンドルーティングのデフォルトアカウント | `default` | | `channels.feishu.verificationToken` | webhook モードで必須 | - | | `channels.feishu.encryptKey` | webhook モードで必須 | - | | `channels.feishu.webhookPath` | Webhook ルートパス | `/feishu/events` | | `channels.feishu.webhookHost` | Webhook バインドホスト | `127.0.0.1` | | `channels.feishu.webhookPort` | Webhook バインドポート | `3000` | | `channels.feishu.accounts..appId` | アプリ ID | - | | `channels.feishu.accounts..appSecret` | アプリシークレット | - | | `channels.feishu.accounts..domain` | アカウントごとのドメイン上書き | `feishu` | | `channels.feishu.accounts..tts` | アカウントごとの TTS 上書き | `messages.tts` | | `channels.feishu.dmPolicy` | DM ポリシー | `allowlist` | | `channels.feishu.allowFrom` | DM 許可リスト（open_id リスト） | [BotOwnerId] | | `channels.feishu.groupPolicy` | グループポリシー | `allowlist` | | `channels.feishu.groupAllowFrom` | グループ許可リスト | - | | `channels.feishu.requireMention` | グループ内で @mention を必須にする | `true` | | `channels.feishu.groups..requireMention` | グループごとの @mention 上書き。明示的な ID は許可リストモードでもグループを許可 | 継承 | | `channels.feishu.groups..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 リソースペイロードではなく、`` プレースホルダーと保存済み添付ファイルを受け取ります。 ### 送信 - ✅ テキスト - ✅ 画像 - ✅ ファイル - ✅ 音声 - ✅ 動画/メディア - ✅ インタラクティブカード（ストリーミング更新を含む） - ⚠️ リッチテキスト（投稿形式の書式設定。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_*`）を使用するため、最初のターンと後続ターンは同じセッションに留まります。 --- ## 関連 - [チャネル概要](/ja-JP/channels) - サポートされるすべてのチャネル - [ペアリング](/ja-JP/channels/pairing) - DM 認証とペアリングフロー - [グループ](/ja-JP/channels/groups) - グループチャットの動作とメンションゲート - [チャネルルーティング](/ja-JP/channels/channel-routing) - メッセージのセッションルーティング - [セキュリティ](/ja-JP/gateway/security) - アクセスモデルと強化