OpenClawのMicrosoft Teams設定

Teamsチャネルは、OpenClawのチャネルの中でも特に長いキーの一覧を持っています。政府機関向けクラウド、Graphに基づく履歴、チームごとの上書き、Adaptive Cardのウェルカムフローを一つのブロックでカバーしなければならないためです。ここでは、ドキュメントのまとめ方に沿って、環境変数、履歴コンテキスト、そして設定キーそのものの順に一覧を紹介します。

環境変数と履歴

• 環境変数から指定できるのは認証関連のキーだけです。アプリID、アプリパスワード、テナントID、secretまたはfederatedの認証タイプ、証明書方式の証明書パスと拇印、マネージドID方式のマネージドIDフラグとクライアントIDがこれに当たります。グループポリシーや履歴の上限など、その他のキーは設定でのみ指定できます。
• 履歴の上限は、直近のチャネルまたはグループのメッセージを何件プロンプトに含めるかを制御します。未設定の場合はグローバルなグループチャット履歴の上限に、それもなければ50にフォールバックし、0にすると無効になります。
• Graphのスレッドコンテキストは、直近のチャネル履歴に加えて、親メッセージと古いものから最大50件の返信を追加します。トリガーとなったメッセージは除外され、履歴は送信者のコマンドテキストと分けて保持されるため、履歴内で引用されたコマンドは実行されません。取得した長いメッセージは、メッセージごとの上限内に収まるよう先頭と末尾を残して切り詰められます。
• スレッドと引用された添付ファイルのコンテキストはコンテキスト可視性キーに従い、未設定の場合はチャネルのデフォルト、次にallにフォールバックします。allowlistは送信者の許可リストで両方を絞り込み、allowlist-quoteはスレッド履歴を絞り込みつつ引用されたコンテキストは許可します。DM履歴はユーザーのターン数で制限され、ユーザーごとに上書きできます。

安定したAADオブジェクトIDは、承認アクションの認可にも使われます。

クラウド、webhook、アクセス、上限

有効化フラグ、アプリID、アプリパスワード、テナントIDが基本です。クラウドキーはTeams SDKの環境を選択します。デフォルトはパブリックで、ほかに米国政府、DoD、中国を選べ、政府機関向けクラウドではサービスURLと一緒に設定します。中国ではSDKのプリセットと保存済みのAzure Chinaの会話参照を使い、Azure China向けのGraphルーティングが提供されるまでGraphに基づくヘルパーは無効になります。サービスURLはプロアクティブな操作におけるBot Connectorの境界で、パブリッククラウドではデフォルト値が使われ、GCC、GCC High、DoDでは明示的に設定します。webhookのポートはデフォルトで3978、パスはデフォルトでmessagesルートです。DMポリシーはpairing、allowlist、open、disabledのいずれかで、デフォルトはpairingです。DM許可リストではAADオブジェクトIDが推奨され、これは承認アクションの認可にも使われます。Graphアクセスが利用できる場合は、セットアップウィザードが名前をIDに解決します。デフォルトの送信先は送信メッセージの宛先を設定し、同様に承認を認可できます。危険な名前照合キーは非常用のトグルで、変更される可能性のあるUPNや表示名による照合と、チーム名やチャネル名による直接ルーティングを再び有効にします。テキストのチャンク上限はデフォルトで4000で、どう設定してもそこが上限になります。newlineチャンクモードは長さで分割する前に空行で分割します。メディアホストの許可リストはデフォルトでMicrosoftとTeamsのドメインで、メディア認証の許可リストは再試行時にAuthorizationヘッダーを付加してよい宛先を決めます。Graphメディアフォールバックは、HTMLにファイルマーカーがない場合にGraphでの検索を行うオプトインで、メディアサイズの上限はエージェントのデフォルトにフォールバックします。

上書き、カード、フィードバック、SSO

• メンション要件はデフォルトでtrueで、返信スタイルはthreadかtop-levelを選びます。どちらもteamsマップの下で、チームIDと会話IDをキーにしてチームごと・チャネルごとに上書きでき、あわせてallow、deny、also-allowによるチームごと・チャネルごとのツールポリシーや、channel、id、e164、username、nameの明示的なプレフィックスとワイルドカードをキーにした送信者ごとのツールポリシーも設定できます。
• 認証タイプ、証明書パスと拇印、マネージドIDフラグとクライアントIDは認証のページと同じ内容です。SharePointサイトIDは、グループチャットとチャネルでのファイルアップロードに使うサイトを指定します。
• プロンプトスターター付きのウェルカムカードとグループウェルカムカードは、最初のDMまたはグループでのやり取りでAdaptive Cardを表示します。応答プレフィックスは送信する返信の先頭にテキストを付け加えます。サムズアップとサムズダウンのフィードバックはデフォルトでオンで、否定的なフィードバックに対する振り返りのフォローアップとそのクールダウンが用意されています。SSOブロックとdelegated-authブロックはBot FrameworkのOAuth接続と委任されたGraphスコープを設定し、SSOを有効にするには接続名が必要です。

これらのキーが属するチャネルの記事はMicrosoft Teams上のOpenClaw、認証キーの背後にあるfederated方式についてはOpenClawのMicrosoft Teams認証をご覧ください。

名前ではなくID

一覧のうち3つのキーは、一つの原則を共有しています。オブジェクトIDは変わらず、名前は変わるということです。したがって、許可リスト、承認、送信先にはIDを使うべきであり、名前照合スイッチは、古いインストールを移行する間だけ動かし続けるために存在します。Graphに基づくヘルパーに必要な権限はOpenClawのMicrosoft Teamsマニフェストと権限で、これらの上書きが細かく調整するグループ会話のチャネル横断のルールはOpenClawのグループチャットで解説しています。

Dialiでは

Microsoft Teamsは、Dialiが現在接続できるチャネル（WhatsApp、Telegram、Discord、Slack、Mattermost、Matrix、SMS、音声）には含まれていません。アシスタントについてはDialiのマネージドOpenClawホスティングを、5分で接続できるチャネルについては最初のチャネルを5分で接続する方法をご覧ください。

• 環境変数から指定できるのは認証キーだけで、残りは設定で指定します。
• スレッドコンテキストは親メッセージと50件の返信を取り込みますが、そこに含まれるコマンドは決して実行しません。
• チャンクあたり4000文字が上限で、それ以上には設定できません。