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   # ログイン済みであることを確認し、テナント情報を表示

# 初回のみのセットアップ（セッション間で永続する URL）:
devtunnel create my-openclaw-bot --allow-anonymous
devtunnel port create my-openclaw-bot -p 3978 --protocol auto

# 開発セッションごと:
devtunnel host my-openclaw-bot
# エンドポイント: 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 のような静的送信者アクセスグループを使用してください。
• 許可リストでは 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 とチャネル IDを参照）。
• groupPolicy="allowlist" でチーム許可リストが存在する場合、列挙されたチーム/チャネルのみが受け入れられます（メンション必須）。
• 設定ウィザードは Team/Channel エントリを受け付け、それらを保存します。
• 起動時に OpenClaw は、Graph 権限で許可されている場合、チーム/チャネルおよびユーザー許可リストの名前を 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. ボットの Pod/VM にマネージド ID（システム割り当てまたはユーザー割り当て）があります。
2. フェデレーション ID 認証情報によって、マネージド ID と Entra ID アプリ登録がリンクされます。
3. 実行時に、OpenClaw は @azure/identity を使用して Azure IMDS エンドポイントからトークンを取得します。
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 ワークロード ID の設定

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 に対するエグレスルールを追加します。

​

認証タイプの比較

​

ローカル開発（トンネリング）

# 初回のみの設定：
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 ログを確認します。

​

環境変数

​

メンバー情報アクション

• ChannelSettings.Read.Group および TeamMember.Read.Group RSC アクセス許可（推奨マニフェストにすでに含まれています）。

​

履歴コンテキスト

• channels.msteams.historyLimit は、プロンプトに組み込む最近のチャネル/グループメッセージ数を制御します。messages.groupChat.historyLimit にフォールバックし、その後デフォルト値の 50 が使用されます。無効にするには 0 を設定します。
• 取得したスレッド履歴は送信者許可リスト（allowFrom / groupAllowFrom）でフィルタリングされるため、スレッドコンテキストの初期投入には許可された送信者からのメッセージのみが含まれます。
• 引用された添付ファイルのコンテキスト（返信自体の添付ファイルにある Skype Reply スキーマの HTML から解析）はフィルタリングされずに渡されます。現在、送信者許可リストのフィルターが適用されるのはスレッド履歴の初期投入だけです。
• DM 履歴は channels.msteams.dmHistoryLimit（ユーザーターン数）で制限できます。ユーザーごとのオーバーライド：channels.msteams.dms["<user_id>"].historyLimit。

​

現在の Teams RSC アクセス許可（マニフェスト）

• ChannelMessage.Read.Group（Application）- @メンションなしですべてのチャネルメッセージを受信
• 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）- @メンションなしですべてのグループチャットメッセージを受信

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 が必要です。
• authorization.permissions.resourceSpecific には、チャネル通信のためのチャネル読み取り/送信を含める必要があります。

​

既存アプリの更新

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

​

機能：RSC のみと Graph の比較

​

Teams RSC のみの場合（アプリはインストール済み、Graph API アクセス許可なし）

• チャネルメッセージのテキストコンテンツの読み取り。
• チャネルメッセージのテキストコンテンツの送信。
• **パーソナル（DM）**ファイル添付の受信。

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

​

Teams RSC + Microsoft Graph Application アクセス許可の場合

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

​

RSC と Graph API の比較

​

Graph を利用したメディアと履歴

1. Entra ID (Azure AD) の App Registration → Graph の Application permissions を追加:
   • チャネルの添付ファイルとチャネル履歴には ChannelMessage.Read.All。
   • グループチャットの添付ファイルとグループチャット履歴には Chat.Read.All。
   • 添付ファイルのバイトデータを SharePoint/OneDrive ストレージからダウンロードする必要がある場合は Files.Read.All。履歴のみのセットアップでは不要です。
2. テナントに対して Grant admin consent を実行します。
3. Teams アプリの manifest version を上げ、再アップロードして、Teams にアプリを再インストールします。
4. キャッシュされたアプリメタデータを消去するため、Teams を完全に終了して再起動します。

​

チャネル／グループのファイル復元 (graphMediaFallback)

{
  channels: {
    msteams: {
      graphMediaFallback: true,
    },
  },
}

​

既知の制限事項

​

Webhook のタイムアウト

​

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"
    }
  }
}

​

書式設定

• 基本的な書式設定は機能します: 太字、斜体、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 で設定します。中国では 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 では設定してください。保存された会話参照が 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.streaming.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.graphMediaFallback: チャネル/グループの HTML にファイルマーカーがない場合に、Graph でメッセージを検索する機能を有効化します（デフォルトは false。チャネル/グループのファイル復旧を参照）。
• 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>

​

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

• スレッドスタイルのチャネルで thread → 返信が不自然にネストされて表示されます。
• 投稿スタイルのチャネルで 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 のアクセス許可が必要です。
• ファイルを明示的に先に送信する場合は、action=upload-file を media / filePath / path とともに使用します。省略可能な message は付随するテキスト/コメントになり、filename（または title）はアップロード名を上書きします。

​

グループチャットでのファイル送信

​

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

​

セットアップ

1. Entra ID（Azure AD）→ App Registration で Graph API のアクセス許可を追加:
   • Sites.ReadWrite.All（Application）- SharePoint にファイルをアップロードします。
   • ChatMember.Read.All（Application）- グループチャットでのファイル送信に使用する、最小権限のテナント全体のアクセス許可。Chat.Read.All も使用でき、グループチャット履歴が有効な場合はすでにこの用途をカバーします。チャットごとの代替手段として、ChatMember.Read.Chat のリソース固有の同意アクセス許可を使用します。
2. テナントの 管理者の同意を付与します。
3. SharePoint サイト ID を取得:
   # Graph Explorer または有効なトークンを使用した curl 経由:
   curl -H "Authorization: Bearer $TOKEN" \
     "https://graph.microsoft.com/v1.0/sites/{hostname}:/{site-path}"
   
   # 例: "contoso.sharepoint.com/sites/BotFiles" にあるサイトの場合
   curl -H "Authorization: Bearer $TOKEN" \
     "https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com:/sites/BotFiles"
   
   # レスポンスに含まれるもの: "id": "contoso.sharepoint.com,guid1,guid2"
   
4. OpenClaw を設定する:
   {
     channels: {
       msteams: {
         // ... その他の設定 ...
         sharePointSiteId: "contoso.sharepoint.com,guid1,guid2",
       },
     },
   }
   

​

共有の動作

​

フォールバックの動作

​

ファイルの保存場所

​

投票（Adaptive Cards）

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

​

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

{
  action: "send",
  channel: "msteams",
  target: "user:<id>",
  presentation: {
    title: "こんにちは",
    blocks: [{ type: "text", text: "こんにちは！" }],
  },
}

openclaw message send --channel msteams \
  --target "conversation:19:abc...@thread.tacv2" \
  --presentation '{"title":"こんにちは","blocks":[{"type":"text","text":"こんにちは！"}]}'

​

ターゲット形式

# ID を指定してユーザーに送信
openclaw message send --channel msteams --target "user:40a1a0ed-..." --message "こんにちは"

# 表示名を指定してユーザーに送信（Graph API 検索が実行される）
openclaw message send --channel msteams --target "user:John Smith" --message "こんにちは"

# グループチャットまたはチャネルに送信
openclaw message send --channel msteams --target "conversation:19:abc...@thread.tacv2" --message "こんにちは"

# 会話にプレゼンテーションカードを送信
openclaw message send --channel msteams --target "conversation:19:abc...@thread.tacv2" \
  --presentation '{"title":"こんにちは","blocks":[{"type":"text","text":"こんにちは"}]}'

{
  action: "send",
  channel: "msteams",
  target: "user:John Smith",
  message: "こんにちは！",
}

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

​

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

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

​

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

https://teams.microsoft.com/l/team/19%3ABk4j...%40thread.tacv2/conversations?groupId=...
                                    └────────────────────────────┘
                                    チーム会話 ID（URL デコードする）

https://teams.microsoft.com/l/channel/19%3A15bc...%40thread.tacv2/ChannelName?groupId=...
                                      └─────────────────────────┘
                                      チャネル ID（URL デコードする）

• チームキー = /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 認証とペアリングの流れ
• グループ - グループチャットの動作とメンションによる制御
• チャンネルルーティング - メッセージのセッションルーティング
• セキュリティ - アクセスモデルと堅牢化