Microsoft Teams

​

バンドル済み Plugin

openclaw plugins install @openclaw/msteams

openclaw plugins install ./path/to/local/msteams-plugin

​

クイックセットアップ

npm install -g @microsoft/teams.cli@preview
teams login
teams status   # verify you're logged in and see your tenant info

# One-time setup (persistent URL across sessions):
devtunnel create my-openclaw-bot --allow-anonymous
devtunnel port create my-openclaw-bot -p 3978 --protocol auto

# Each dev session:
devtunnel host my-openclaw-bot
# Your endpoint: https://<tunnel-id>.devtunnels.ms/api/messages

teams app create \
  --name "OpenClaw" \
  --endpoint "https://<your-tunnel-url>/api/messages"

{
  channels: {
    msteams: {
      enabled: true,
      appId: "<CLIENT_ID>",
      appPassword: "<CLIENT_SECRET>",
      tenantId: "<TENANT_ID>",
      webhook: { port: 3978, path: "/api/messages" },
    },
  },
}

teams app get <teamsAppId> --install-link

teams app doctor <teamsAppId>

​

目標

• Teams DM、グループチャット、またはチャネル経由で OpenClaw と会話する。
• ルーティングを決定的に保つ: 返信は常に到着したチャネルに戻ります。
• 安全なチャネル動作をデフォルトにする（別途構成されていない限りメンション必須）。

​

構成の書き込み

{
  channels: { msteams: { configWrites: false } },
}

​

アクセス制御（DM + グループ）

• デフォルト: channels.msteams.dmPolicy = "pairing"。未知の送信者は承認されるまで無視されます。
• channels.msteams.allowFrom には、安定した AAD オブジェクト ID または accessGroup:core-team のような静的送信者アクセスグループを使用してください。
• allowlist には UPN/表示名の一致に依存しないでください。それらは変更される可能性があります。OpenClaw はデフォルトで直接の名前一致を無効にしています。channels.msteams.dangerouslyAllowNameMatching: true でオプトインします。
• ウィザードは、認証情報で許可されている場合に Microsoft Graph 経由で名前を ID に解決できます。

• デフォルト: channels.msteams.groupPolicy = "allowlist"（groupAllowFrom を追加しない限りブロック）。channels.msteams.groupPolicy が未設定の場合、channels.defaults.groupPolicy は共有デフォルトを上書きできます。
• channels.msteams.groupAllowFrom は、グループチャット/チャネルでトリガーできる送信者または静的送信者アクセスグループを制御します（channels.msteams.allowFrom にフォールバックします）。
• 任意のメンバーを許可するには groupPolicy: "open" を設定します（デフォルトでは引き続きメンション必須）。
• すべてのチャネルをブロックするには、channels.msteams.groupPolicy: "disabled" を設定します。

{
  channels: {
    msteams: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["00000000-0000-0000-0000-000000000000", "accessGroup:core-team"],
    },
  },
}

• channels.msteams.teams 配下にチームとチャネルを列挙して、グループ/チャネル返信のスコープを制限します。
• キーには、変更可能な表示名ではなく、Teams リンクの安定した Teams 会話 ID を使用してください（チームとチャネル IDを参照）。
• groupPolicy="allowlist" で teams allowlist が存在する場合、列挙されたチーム/チャネルのみが受け入れられます（メンション必須）。
• 構成ウィザードは Team/Channel エントリを受け取り、保存します。
• 起動時に、OpenClaw は（Graph 権限で許可されている場合）チーム/チャネルおよびユーザー allowlist 名を ID に解決し、マッピングをログに記録します。未解決の名前は入力されたまま保持されますが、channels.msteams.dangerouslyAllowNameMatching: true が設定されていない限りルーティングでは無視されます。

{
  channels: {
    msteams: {
      groupPolicy: "allowlist",
      teams: {
        "My Team": {
          channels: {
            General: { requireMention: true },
          },
        },
      },
    },
  },
}

​

フェデレーション認証（証明書とマネージド ID）

​

オプション A: 証明書ベースの認証

1. 証明書を生成または取得します（秘密鍵付き PEM 形式）。
2. Entra ID → App Registration → Certificates & secrets → Certificates → 公開証明書をアップロードします。

{
  channels: {
    msteams: {
      enabled: true,
      appId: "<APP_ID>",
      tenantId: "<TENANT_ID>",
      authType: "federated",
      certificatePath: "/path/to/cert.pem",
      webhook: { port: 3978, path: "/api/messages" },
    },
  },
}

• MSTEAMS_AUTH_TYPE=federated
• MSTEAMS_CERTIFICATE_PATH=/path/to/cert.pem

​

オプション B: Azure Managed Identity

1. ボットのポッド/VM にマネージド ID（システム割り当てまたはユーザー割り当て）があります。
2. フェデレーション ID 認証情報が、マネージド ID を Entra ID アプリ登録にリンクします。
3. 実行時に、OpenClaw は Azure IMDS エンドポイントからトークンを取得するために @azure/identity を使用します。
4. トークンはボット認証のために Teams SDK に渡されます。

• マネージド ID が有効な Azure インフラストラクチャ（AKS ワークロード ID、App Service、VM）。
• Entra ID アプリ登録上に作成されたフェデレーション ID 認証情報。
• ポッド/VM から IMDS（169.254.169.254:80）へのネットワークアクセス。

{
  channels: {
    msteams: {
      enabled: true,
      appId: "<APP_ID>",
      tenantId: "<TENANT_ID>",
      authType: "federated",
      useManagedIdentity: true,
      webhook: { port: 3978, path: "/api/messages" },
    },
  },
}

• MSTEAMS_AUTH_TYPE=federated
• MSTEAMS_USE_MANAGED_IDENTITY=true
• MSTEAMS_MANAGED_IDENTITY_CLIENT_ID=<client-id>（ユーザー割り当てのみ）

​

AKS Workload Identity セットアップ

1. AKS クラスターで ワークロード ID を有効化します。
2. Entra ID アプリ登録で フェデレーション ID 資格情報を作成します:
   az ad app federated-credential create --id <APP_OBJECT_ID> --parameters '{
     "name": "my-bot-workload-identity",
     "issuer": "<AKS_OIDC_ISSUER_URL>",
     "subject": "system:serviceaccount:<NAMESPACE>:<SERVICE_ACCOUNT>",
     "audiences": ["api://AzureADTokenExchange"]
   }'
   
3. アプリのクライアント ID で Kubernetes サービスアカウントにアノテーションを付けます:
   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: my-bot-sa
     annotations:
       azure.workload.identity/client-id: "<APP_CLIENT_ID>"
   
4. ワークロード ID 注入用に ポッドにラベルを付けます:
   metadata:
     labels:
       azure.workload.identity/use: "true"
   
5. IMDS (169.254.169.254) への ネットワークアクセスを許可します: NetworkPolicy を使用している場合は、ポート 80 の 169.254.169.254/32 に対する egress ルールを追加します。

​

認証タイプの比較

​

ローカル開発 (トンネリング)

# 1 回限りのセットアップ:
devtunnel create my-openclaw-bot --allow-anonymous
devtunnel port create my-openclaw-bot -p 3978 --protocol auto

# 各開発セッション:
devtunnel host my-openclaw-bot

teams app update <teamsAppId> --endpoint "https://<new-url>/api/messages"

​

ボットのテスト

teams app doctor <teamsAppId>

1. Teams アプリをインストールします (teams app get <id> --install-link からのインストールリンク)。
2. Teams でボットを見つけて DM を送信します。
3. 受信アクティビティについて Gateway ログを確認します。

​

環境変数

​

メンバー情報アクション

• Member.Read.Group RSC 権限 (推奨マニフェストにすでに含まれています)。
• チーム横断の検索の場合: 管理者同意付きの User.Read.All Graph アプリケーション権限。

​

履歴コンテキスト

• channels.msteams.historyLimit は、最近のチャネル/グループメッセージをいくつプロンプトに包めるかを制御します。messages.groupChat.historyLimit にフォールバックし、その後デフォルトは 50 になります。無効化するには 0 を設定します。
• 取得したスレッド履歴は送信者許可リスト (allowFrom / groupAllowFrom) によってフィルタリングされるため、スレッドコンテキストのシードには許可された送信者からのメッセージのみが含まれます。
• 引用された添付ファイルコンテキスト (返信自身の添付ファイル内にある Skype Reply-schema HTML から解析) はフィルタリングされずに渡されます。現在、送信者許可リストフィルターが適用されるのはスレッド履歴のシードのみです。
• DM 履歴は channels.msteams.dmHistoryLimit (ユーザーターン) で制限できます。ユーザーごとの上書き: channels.msteams.dms["<user_id>"].historyLimit。

​

現在の Teams RSC 権限 (マニフェスト)

• ChannelMessage.Read.Group (Application) - @mention なしですべてのチャネルメッセージを受信
• ChannelMessage.Send.Group (Application)
• Member.Read.Group (Application)
• Owner.Read.Group (Application)
• ChannelSettings.Read.Group (Application)
• TeamMember.Read.Group (Application)
• TeamSettings.Read.Group (Application)

• ChatMessage.Read.Chat (Application) - @mention なしですべてのグループチャットメッセージを受信

teams app rsc add <teamsAppId> ChannelMessage.Read.Group --type Application

​

Teams マニフェスト例 (編集済み)

{
  $schema: "https://developer.microsoft.com/en-us/json-schemas/teams/v1.23/MicrosoftTeams.schema.json",
  manifestVersion: "1.23",
  version: "1.0.0",
  id: "00000000-0000-0000-0000-000000000000",
  name: { short: "OpenClaw" },
  developer: {
    name: "Your Org",
    websiteUrl: "https://example.com",
    privacyUrl: "https://example.com/privacy",
    termsOfUseUrl: "https://example.com/terms",
  },
  description: { short: "OpenClaw in Teams", full: "OpenClaw in Teams" },
  icons: { outline: "outline.png", color: "color.png" },
  accentColor: "#5B6DEF",
  bots: [
    {
      botId: "11111111-1111-1111-1111-111111111111",
      scopes: ["personal", "team", "groupChat"],
      isNotificationOnly: false,
      supportsCalling: false,
      supportsVideo: false,
      supportsFiles: true,
    },
  ],
  webApplicationInfo: {
    id: "11111111-1111-1111-1111-111111111111",
  },
  authorization: {
    permissions: {
      resourceSpecific: [
        { name: "ChannelMessage.Read.Group", type: "Application" },
        { name: "ChannelMessage.Send.Group", type: "Application" },
        { name: "Member.Read.Group", type: "Application" },
        { name: "Owner.Read.Group", type: "Application" },
        { name: "ChannelSettings.Read.Group", type: "Application" },
        { name: "TeamMember.Read.Group", type: "Application" },
        { name: "TeamSettings.Read.Group", type: "Application" },
        { name: "ChatMessage.Read.Chat", type: "Application" },
      ],
    },
  },
}

​

マニフェストの注意点 (必須フィールド)

• bots[].botId は Azure Bot App ID と一致している必要があります。
• webApplicationInfo.id は Azure Bot App ID と一致している必要があります。
• bots[].scopes には、使用予定のサーフェス (personal, team, groupChat) を含める必要があります。
• bots[].supportsFiles: true は personal スコープでのファイル処理に必要です。
• authorization.permissions.resourceSpecific には、チャネル通信のためのチャネル読み取り/送信を含める必要があります。

​

既存アプリの更新

# マニフェストをダウンロード、編集し、再アップロードします
teams app manifest download <teamsAppId> manifest.json
# manifest.json をローカルで編集...
teams app manifest upload manifest.json <teamsAppId>
# 内容が変更された場合、バージョンは自動的に上がります

​

機能: RSC のみ vs Graph

​

Teams RSC のみの場合 (アプリはインストール済み、Graph API 権限なし)

• チャネルメッセージのテキスト内容を読み取る。
• チャネルメッセージのテキスト内容を送信する。
• personal (DM) ファイル添付を受信する。

• チャネル/グループの画像またはファイル内容 (ペイロードには HTML スタブのみが含まれます)。
• SharePoint/OneDrive に保存された添付ファイルのダウンロード。
• ライブ Webhook イベントを超えたメッセージ履歴の読み取り。

​

Teams RSC + Microsoft Graph アプリケーション権限の場合

• ホストされたコンテンツ (メッセージに貼り付けられた画像) のダウンロード。
• SharePoint/OneDrive に保存されたファイル添付のダウンロード。
• Graph 経由でのチャネル/チャットメッセージ履歴の読み取り。

​

RSC vs Graph API

​

Graph 対応のメディア + 履歴 (チャネルに必要)

1. Entra ID (Azure AD) アプリ登録 → Graph アプリケーション権限を追加:
   • ChannelMessage.Read.All (チャネル添付ファイル + 履歴)
   • Chat.Read.All または ChatMessage.Read.All (グループチャット)
2. テナントに対して管理者同意を付与します。
3. Teams アプリのマニフェストバージョンを上げ、再アップロードし、Teams でアプリを再インストールします。
4. キャッシュされたアプリメタデータを消去するために、Teams を完全に終了して再起動します。

​

既知の制限

​

Webhook タイムアウト

• Teams がメッセージを再試行する（重複が発生する）。
• 返信が失われる。

​

Teams クラウドとサービス URL のサポート

• channels.msteams.cloud は、認証、JWT 検証、トークンサービス、Graph スコープ用の Teams SDK クラウドプリセットを選択します。
• channels.msteams.serviceUrl は、プロアクティブな送信、編集、削除、カード、投票、ファイル同意メッセージ、キューに入った長時間実行返信の前に、保存済み会話参照を検証するために使用される Bot Connector エンドポイント境界を選択します。USGov と DoD SDK クラウドでは必須です。China/21Vianet では、OpenClaw は SDK の China プリセットを使用し、Azure China Bot Framework チャネルホスト上の保存済みまたは設定済みサービス URL のみを受け入れます。

{
  "channels": {
    "msteams": {
      "serviceUrl": "https://smba.infra.gcc.teams.microsoft.com/teams"
    }
  }
}

{
  "channels": {
    "msteams": {
      "cloud": "USGov",
      "serviceUrl": "https://smba.infra.gov.teams.microsoft.us/teams"
    }
  }
}

​

書式設定

• 基本的な書式は機能します: bold、italic、code、リンク。
• 複雑な markdown（テーブル、ネストしたリスト）は正しくレンダリングされない場合があります。
• Adaptive Cards は、投票とセマンティックなプレゼンテーション送信でサポートされています（下記参照）。

​

設定

• channels.msteams.enabled: チャネルを有効化または無効化します。
• channels.msteams.appId、channels.msteams.appPassword、channels.msteams.tenantId: ボット認証情報。
• channels.msteams.cloud: Teams SDK クラウド環境（Public、USGov、USGovDoD、または China。既定は Public）。USGov/DoD SDK クラウドでは serviceUrl とともに設定します。China は SDK プリセットと保存済み Azure China Bot Framework 会話参照を使用し、Azure China Graph ルーティングが出荷されるまで Graph ベースのヘルパーは無効です。
• channels.msteams.serviceUrl: SDK プロアクティブ操作用の Bot Connector サービス URL 境界。パブリッククラウドは SDK の既定値を使用します。GCC（https://smba.infra.gcc.teams.microsoft.com/teams）、GCC High、または DoD では設定します。China は、保存済み会話参照が 21Vianet によって運用される Teams から来ている場合、Azure China Bot Framework チャネルホストを受け入れます。
• channels.msteams.webhook.port（既定 3978）。
• channels.msteams.webhook.path（既定 /api/messages）。
• channels.msteams.dmPolicy: pairing | allowlist | open | disabled（既定 pairing）。
• channels.msteams.allowFrom: DM 許可リスト（AAD オブジェクト ID を推奨）。Graph アクセスが利用可能な場合、ウィザードはセットアップ中に名前を ID に解決します。
• channels.msteams.dangerouslyAllowNameMatching: 変更可能な UPN/表示名マッチングと、直接のチーム/チャネル名ルーティングを再有効化するための緊急用トグル。
• channels.msteams.textChunkLimit: 送信テキストのチャンクサイズ（文字数、既定 4000。より高い値が設定されても 4000 でハードキャップ）。
• channels.msteams.chunkMode: 長さによるチャンク化の前に空行（段落境界）で分割する length（既定）または newline。
• channels.msteams.mediaAllowHosts: 受信添付ファイルホストの許可リスト（既定は Microsoft/Teams ドメイン: Graph、SharePoint/OneDrive、Teams CDN、Bot Framework、Azure Media Services）。
• channels.msteams.mediaAuthAllowHosts: メディア再試行時に Authorization ヘッダーを付与するための許可リスト（既定は Graph + Bot Framework ホスト）。
• channels.msteams.mediaMaxMb: チャネルごとのメディアサイズ上限の MB 単位オーバーライド。未設定時は agents.defaults.mediaMaxMb にフォールバックします。
• channels.msteams.requireMention: チャネル/グループで @メンションを必須にします（既定 true）。
• channels.msteams.replyStyle: thread | top-level（返信スタイル を参照）。
• channels.msteams.teams.<teamId>.replyStyle: チームごとのオーバーライド。
• channels.msteams.teams.<teamId>.requireMention: チームごとのオーバーライド。
• channels.msteams.teams.<teamId>.tools: チャネルオーバーライドがない場合に使用される、チームごとの既定ツールポリシーオーバーライド（allow/deny/alsoAllow）。
• channels.msteams.teams.<teamId>.toolsBySender: チームごと、送信者ごとの既定ツールポリシーオーバーライド（"*" ワイルドカードをサポート）。
• channels.msteams.teams.<teamId>.channels.<conversationId>.replyStyle: チャネルごとのオーバーライド。
• channels.msteams.teams.<teamId>.channels.<conversationId>.requireMention: チャネルごとのオーバーライド。
• channels.msteams.teams.<teamId>.channels.<conversationId>.tools: チャネルごとのツールポリシーオーバーライド（allow/deny/alsoAllow）。
• channels.msteams.teams.<teamId>.channels.<conversationId>.toolsBySender: チャネルごと、送信者ごとのツールポリシーオーバーライド（"*" ワイルドカードをサポート）。
• toolsBySender キーには明示的なプレフィックスを使用してください: channel:、id:、e164:、username:、name:（従来のプレフィックスなしキーは引き続き id: のみにマップされます）。
• channels.msteams.authType: 認証タイプ - "secret"（既定）または "federated"。
• channels.msteams.certificatePath: PEM 証明書ファイルへのパス（フェデレーション + 証明書認証）。
• channels.msteams.certificateThumbprint: 証明書サムプリント。受け入れられますが、認証には必須ではありません。
• channels.msteams.useManagedIdentity: マネージド ID 認証を有効化します（フェデレーションモード）。
• channels.msteams.managedIdentityClientId: ユーザー割り当てマネージド ID のクライアント ID。
• channels.msteams.sharePointSiteId: グループチャット/チャネルでのファイルアップロード用 SharePoint サイト ID（グループチャットでファイルを送信する を参照）。
• channels.msteams.welcomeCard、channels.msteams.groupWelcomeCard、channels.msteams.promptStarters: 初回 DM/グループ接触時に表示されるようこそ Adaptive Card と、その推奨プロンプトボタン。
• channels.msteams.responsePrefix: 送信返信の先頭に付加されるテキスト。
• channels.msteams.feedbackEnabled（既定 true）、channels.msteams.feedbackReflection（既定 true）、channels.msteams.feedbackReflectionCooldownMs: 返信に対する賛成/反対フィードバックと、否定的フィードバックのリフレクションフォローアップ。
• channels.msteams.sso、channels.msteams.delegatedAuth: SSO ベースのフロー用の Bot Framework OAuth 接続と委任 Graph スコープ。sso.enabled: true には sso.connectionName が必要です。

​

ルーティングとセッション

• セッションキーは標準のエージェント形式に従います（/concepts/session を参照）:
  • ダイレクトメッセージはメインセッションを共有します（agent:<agentId>:<mainKey>）。
  • チャネル/グループメッセージは会話 ID を使用します:
    • agent:<agentId>:msteams:channel:<conversationId>
    • agent:<agentId>:msteams:group:<conversationId>

​

返信スタイル: スレッドと投稿

• Threads スタイルのチャネルで thread → 返信が不自然にネストされて表示されます。
• Posts スタイルのチャネルで top-level → 返信がスレッド内ではなく、個別のトップレベル投稿として表示されます。

{
  channels: {
    msteams: {
      replyStyle: "thread",
      teams: {
        "19:abc...@thread.tacv2": {
          channels: {
            "19:xyz...@thread.tacv2": {
              replyStyle: "top-level",
            },
          },
        },
      },
    },
  },
}

​

解決の優先順位

1. チャネルごと - channels.msteams.teams.<teamId>.channels.<conversationId>.replyStyle
2. チームごと - channels.msteams.teams.<teamId>.replyStyle
3. グローバル - channels.msteams.replyStyle
4. 暗黙の既定値 - requireMention から派生:
   • requireMention: true → thread
   • requireMention: false → top-level

​

スレッドコンテキストの保持

​

添付ファイルと画像

• DM: 画像とファイル添付は Teams ボットファイル API 経由で動作します。
• チャネル/グループ: 添付ファイルは M365 ストレージ（SharePoint/OneDrive）に保存されます。Webhook ペイロードには HTML スタブのみが含まれ、実際のファイルバイトは含まれません。チャネル添付ファイルをダウンロードするには Graph API 権限が必要 です。
• 明示的なファイル優先送信では、media / filePath / path とともに action=upload-file を使用します。任意の message は付随するテキスト/コメントになり、filename（または title）はアップロード名を上書きします。

​

グループチャットでファイルを送信する

​

グループチャットに SharePoint が必要な理由

​

セットアップ

1. Entra ID（Azure AD）→ アプリ登録で Graph API 権限を追加 します:
   • Sites.ReadWrite.All（アプリケーション）- SharePoint にファイルをアップロードします。
   • Chat.Read.All（アプリケーション）- 任意。ユーザー単位の共有リンクを有効にします。
2. テナントの 管理者同意を付与 します。
3. SharePoint サイト ID を取得 します:
   # Via Graph Explorer or curl with a valid token:
   curl -H "Authorization: Bearer $TOKEN" \
     "https://graph.microsoft.com/v1.0/sites/{hostname}:/{site-path}"
   
   # Example: for a site at "contoso.sharepoint.com/sites/BotFiles"
   curl -H "Authorization: Bearer $TOKEN" \
     "https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com:/sites/BotFiles"
   
   # Response includes: "id": "contoso.sharepoint.com,guid1,guid2"
   
4. OpenClaw を設定 します:
   {
     channels: {
       msteams: {
         // ... other config ...
         sharePointSiteId: "contoso.sharepoint.com,guid1,guid2",
       },
     },
   }
   

​

共有の動作

​

フォールバック動作

​

ファイルの保存場所

​

投票（Adaptive Cards）

• CLI: openclaw message poll --channel msteams --target conversation:<id> --poll-question "..." --poll-option "..." --poll-option "..."。
• 投票は Gateway によって、state/openclaw.sqlite の OpenClaw plugin-state SQLite に記録されます。
• 既存の msteams-polls.json ファイルは、実行中の Plugin ではなく openclaw doctor --fix によってインポートされます。
• 投票を記録するには Gateway がオンラインのままである必要があります。
• 投票は結果サマリーを自動投稿せず、poll-results CLI もまだありません。

​

プレゼンテーションカード

{
  action: "send",
  channel: "msteams",
  target: "user:<id>",
  presentation: {
    title: "Hello",
    blocks: [{ type: "text", text: "Hello!" }],
  },
}

openclaw message send --channel msteams \
  --target "conversation:19:abc...@thread.tacv2" \
  --presentation '{"title":"Hello","blocks":[{"type":"text","text":"Hello!"}]}'

​

ターゲット形式

# Send to a user by ID
openclaw message send --channel msteams --target "user:40a1a0ed-..." --message "Hello"

# Send to a user by display name (triggers Graph API lookup)
openclaw message send --channel msteams --target "user:John Smith" --message "Hello"

# Send to a group chat or channel
openclaw message send --channel msteams --target "conversation:19:abc...@thread.tacv2" --message "Hello"

# Send a presentation card to a conversation
openclaw message send --channel msteams --target "conversation:19:abc...@thread.tacv2" \
  --presentation '{"title":"Hello","blocks":[{"type":"text","text":"Hello"}]}'

{
  action: "send",
  channel: "msteams",
  target: "user:John Smith",
  message: "Hello!",
}

{
  action: "send",
  channel: "msteams",
  target: "conversation:19:abc...@thread.tacv2",
  presentation: {
    title: "Hello",
    blocks: [{ type: "text", text: "Hello" }],
  },
}

​

プロアクティブメッセージング

• プロアクティブメッセージは、ユーザーが操作した 後 にのみ可能です。その時点で OpenClaw が会話参照を保存するためです。
• dmPolicy と許可リストゲートについては、/gateway/configuration を参照してください。

​

チーム ID とチャネル ID（よくある落とし穴）

https://teams.microsoft.com/l/team/19%3ABk4j...%40thread.tacv2/conversations?groupId=...
                                    └────────────────────────────┘
                                    Team conversation ID (URL-decode this)

https://teams.microsoft.com/l/channel/19%3A15bc...%40thread.tacv2/ChannelName?groupId=...
                                      └─────────────────────────┘
                                      Channel ID (URL-decode this)

• チームキー = /team/ の後のパスセグメント（URL デコード済み、例: 19:Bk4j...@thread.tacv2。古いテナントでは @thread.skype が表示される場合があり、これも有効です）。
• チャネルキー = /channel/ の後のパスセグメント（URL デコード済み）。
• OpenClaw ルーティングでは groupId クエリパラメーターを 無視 します。これは Microsoft Entra グループ ID であり、受信 Teams アクティビティで使用される Bot Framework 会話 ID ではありません。

​

プライベートチャネル

1. ボットとのやり取りには標準チャネルを使用します。
2. DMを使用します。ユーザーはいつでもボットに直接メッセージを送信できます。
3. 履歴アクセスには Graph API を使用します（ChannelMessage.Read.All が必要）。

​

トラブルシューティング

​

よくある問題

• チャネルで画像が表示されない: Graph 権限または管理者の同意がありません。Teams アプリを再インストールし、Teams を完全に終了して再度開いてください。
• チャネルで応答がない: 既定ではメンションが必要です。channels.msteams.requireMention=false を設定するか、チーム/チャネルごとに構成してください。
• バージョンの不一致（Teams に古いマニフェストがまだ表示される）: アプリを削除して再追加し、Teams を完全に終了して更新してください。
• Webhook からの 401 Unauthorized: Azure JWT なしで手動テストする場合は想定される動作です。エンドポイントには到達できますが、認証に失敗したことを意味します。正しくテストするには Azure Web Chat を使用してください。

​

マニフェストのアップロードエラー

• 「Icon file cannot be empty」: マニフェストが参照しているアイコンファイルが 0 バイトです。有効な PNG アイコン（outline.png は 32x32、color.png は 192x192）を作成してください。
• 「webApplicationInfo.Id already in use」: アプリがまだ別のチーム/チャットにインストールされています。まず見つけてアンインストールするか、反映されるまで 5〜10 分待ってください。
• アップロード時の「Something went wrong」: 代わりに https://admin.teams.microsoft.com からアップロードし、ブラウザーの DevTools（F12）→ Network タブを開いて、実際のエラーをレスポンス本文で確認してください。
• サイドロードに失敗する: 「Upload a custom app」ではなく「Upload an app to your org’s app catalog」を試してください。これによりサイドロード制限を回避できることがよくあります。

​

RSC 権限が機能しない

1. webApplicationInfo.id がボットの App ID と完全に一致していることを確認します。
2. アプリを再アップロードし、チーム/チャットに再インストールします。
3. 組織の管理者が RSC 権限をブロックしていないか確認します。
4. 適切なスコープを使用していることを確認します。チームには ChannelMessage.Read.Group、グループチャットには ChatMessage.Read.Chat を使用します。

​

参考資料

• Azure Bot を作成 - Azure Bot セットアップガイド
• Teams Developer Portal - Teams アプリの作成/管理
• Teams アプリ マニフェスト スキーマ
• RSC でチャネルメッセージを受信
• RSC 権限リファレンス
• Teams ボットのファイル処理（チャネル/グループには Graph が必要）
• プロアクティブ メッセージング
• @microsoft/teams.cli - ボット管理用 Teams CLI

​

関連

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