OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Developer and self-hosted

Mattermost

ステータス: ダウンロード可能なPlugin（ボットトークン + WebSocketイベント）。チャンネル、プライベートチャンネル、グループDM、DMをサポートしています。Mattermostはセルフホスト可能なチームメッセージングプラットフォームです（mattermost.com）。

インストール

npmレジストリ

bash
openclaw plugins install @openclaw/mattermost

ローカルチェックアウト

bash
openclaw plugins install ./path/to/local/mattermost-plugin

詳細: Plugin

クイックセットアップ

  • Pluginが利用可能であることを確認

    上記のコマンドで@openclaw/mattermostをインストールし、Gatewayがすでに実行中の場合は再起動します。

  • Mattermostボットを作成

    Mattermostボットアカウントを作成し、ボットトークンをコピーして、ボットが読み取る必要のあるチームとチャンネルに追加します。

  • ベースURLをコピー

    MattermostのベースURL（例: https://chat.example.com）をコピーします。末尾の/api/v4は自動的に削除されます。

  • OpenClawを設定してGatewayを起動

    最小構成:

    json5
    {  channels: {    mattermost: {      enabled: true,      botToken: "mm-token",      baseUrl: "https://chat.example.com",      dmPolicy: "pairing",    },  },}

    非対話型の代替手段:

    bash
    openclaw channels add --channel mattermost --bot-token <token> --http-url https://chat.example.com

    • ネイティブスラッシュコマンド

    ネイティブスラッシュコマンドはオプトインです。有効にすると、OpenClawはボットが所属するすべてのチームにoc_*スラッシュコマンドを登録し、GatewayのHTTPサーバーでコールバックPOSTを受信します。

    json5
    {  channels: {    mattermost: {      commands: {        native: true,        nativeSkills: true,        callbackPath: "/api/channels/mattermost/command",        // MattermostがGatewayに直接到達できない場合に使用します（リバースプロキシ/公開URL）。        callbackUrl: "https://gateway.example.com/api/channels/mattermost/command",      },    },  },}

    登録されるコマンド: /oc_status、/oc_model、/oc_models、/oc_new、/oc_help、/oc_think、/oc_reasoning、/oc_verbose、/oc_queue。nativeSkills: trueの場合、スキルコマンドも/oc_<skill>として登録されます。

    動作上の注意
    • nativeとnativeSkillsのデフォルトは"auto"であり、Mattermostでは無効として解決されます。明示的にtrueに設定してください。
    • callbackPathのデフォルトは/api/channels/mattermost/commandです。
    • callbackUrlを省略すると、OpenClawはhttp://<gateway.customBindHost or localhost>:<gateway.port, default 18789><callbackPath>を生成します。ワイルドカードのバインドホスト（0.0.0.0、::）ではlocalhostにフォールバックします。
    • 複数アカウントのセットアップでは、commandsをトップレベルまたはchannels.mattermost.accounts.<id>.commandsの下に設定できます（アカウントの値がトップレベルのフィールドを上書きします）。
    • 他の連携によって作成された同じトリガーの既存スラッシュコマンドには変更を加えません（登録時にスキップします）。ボットが作成したコマンドは、コールバックURLが変化すると更新または再作成されます。
    • コマンドコールバックは、OpenClawがoc_*コマンドを登録したときにMattermostから返されるコマンドごとのトークンで検証されます。
    • OpenClawは各コールバックを受け入れる前に現在のMattermostコマンド登録を更新するため、削除または再生成されたスラッシュコマンドの古いトークンは、Gatewayを再起動しなくても受け入れられなくなります。
    • Mattermost APIでコマンドが現在も有効であることを確認できない場合、コールバック検証は安全側に失敗します。失敗した検証は短時間キャッシュされ、同時ルックアップは統合され、リプレイ負荷を制限するため、新しいルックアップの開始はコマンドごとにレート制限されます。
    • 登録に失敗した場合、起動が部分的にしか完了していない場合、またはコールバックトークンが解決されたコマンドの登録済みトークンと一致しない場合、スラッシュコールバックは安全側に失敗します（あるコマンドで有効なトークンを使用して、別のコマンドの上流検証に到達することはできません）。
    • 受け入れられたコールバックには、一時的な「処理中...」という返信で受信確認が行われます。実際の回答は通常のメッセージとして届きます。
    到達可能性の要件

    コールバックエンドポイントはMattermostサーバーから到達可能でなければなりません。

    • MattermostがOpenClawと同じホスト/ネットワーク名前空間で実行されている場合を除き、callbackUrlをlocalhostに設定しないでください。
    • MattermostのベースURLが/api/channels/mattermost/commandをOpenClawへリバースプロキシしている場合を除き、callbackUrlをそのベースURLに設定しないでください。
    • 簡単な確認方法はcurl https://<gateway-host>/api/channels/mattermost/commandです。GETに対して、404ではなくOpenClawから405 Method Not Allowedが返される必要があります。
    Mattermostの送信許可リスト

    コールバック先がプライベート/tailnet/内部アドレスの場合は、コールバックのホスト/ドメインを含むようにMattermostのServiceSettings.AllowedUntrustedInternalConnectionsを設定します。

    完全なURLではなく、ホスト/ドメインのエントリを使用してください。

    • 良い例: gateway.tailnet-name.ts.net
    • 悪い例: https://gateway.tailnet-name.ts.net

    環境変数（デフォルトアカウント）

    環境変数を使用する場合は、Gatewayホストで次を設定します。

    • MATTERMOST_BOT_TOKEN=...
    • MATTERMOST_URL=https://chat.example.com

    チャットモード

    MattermostはDMに自動的に応答します。チャンネルでの動作はchatmodeによって制御されます。

    oncall（デフォルト）

    チャンネルで@メンションされた場合にのみ応答します。

    onmessage

    すべてのチャンネルメッセージに応答します。

    onchar

    メッセージがトリガープレフィックスで始まる場合に応答します。

    設定例:

    json5
    {  channels: {    mattermost: {      chatmode: "onchar",      oncharPrefixes: [">", "!"], // デフォルト    },  },}

    注意:

    • oncharでも、明示的な@メンションには応答します。
    • channels.mattermost.requireMentionも引き続き考慮されますが、chatmodeが推奨されます。チャンネル単位のgroups.<channelId>.requireMention設定が両方より優先されます。
    • ボットがチャンネルスレッド内で表示される返信を送信した後は、同じスレッド内の以降のメッセージに、新たな@メンションやoncharプレフィックスがなくても応答するため、複数ターンのスレッド会話が継続します。参加状態は、そのスレッドでボットが最後に返信してから7日間記憶され、Gatewayの再起動後も保持されます。ボットが確認しただけのスレッドには影響しません。再び明示的なメンションを必須にするには、新しいトップレベルメッセージを開始してください。

    スレッドとセッション

    channels.mattermost.replyToModeを使用して、チャンネルおよびグループへの返信をメインチャンネルに残すか、トリガーとなった投稿の下にスレッドを開始するかを制御します。

    • off（デフォルト）: 受信投稿がすでにスレッド内にある場合にのみ、スレッド内で返信します。
    • first: トップレベルのチャンネル/グループ投稿では、その投稿の下にスレッドを開始し、会話をスレッドスコープのセッションにルーティングします。
    • allとbatched: 現在のMattermostではfirstと同じ動作です。Mattermostにスレッドルートが作成されると、後続のチャンクとメディアも同じスレッド内で続行されるためです。
    • replyToModeが設定されている場合でも、ダイレクトメッセージのデフォルトはoffです。

    channels.mattermost.replyToModeByChatTypeを使用すると、direct、group、またはchannelチャットのモードを上書きできます。ダイレクトメッセージでスレッドを使用するには、directを設定します。

    • off（デフォルト）: ダイレクトメッセージは、1つの継続セッション内でスレッド化されないまま維持されます。
    • first、all、またはbatched: トップレベルのダイレクトメッセージごとに、新しい独立したセッションに対応するMattermostスレッドを開始します。
    json5
    {  channels: {    mattermost: {      replyToMode: "all",      replyToModeByChatType: {        direct: "first",      },    },  },}

    注意:

    • スレッドスコープのセッションでは、トリガーとなった投稿IDをスレッドルートとして使用します。
    • 現在、firstとallは同等です。Mattermostにスレッドルートが作成されると、後続のチャンクとメディアも同じスレッド内で続行されるためです。
    • チャット種別ごとの上書きはreplyToModeより優先されます。directの上書きがない場合、既存のデプロイではフラットでスレッド化されないDMが維持されます。

    アクセス制御（DM）

    • デフォルト: channels.mattermost.dmPolicy = "pairing"（不明な送信者にはペアリングコードが送られます）。その他の値: allowlist、open、disabled。
    • 次のコマンドで承認します。
      • openclaw pairing list mattermost
      • openclaw pairing approve mattermost &lt;CODE&gt;
    • 公開DM: channels.mattermost.dmPolicy="open"とchannels.mattermost.allowFrom=["*"]を使用します（設定スキーマでワイルドカードが必須です）。
    • channels.mattermost.allowFromにはユーザーID（推奨）とaccessGroup:<name>エントリを指定できます。アクセスグループを参照してください。

    チャンネル（グループ）

    • デフォルト: channels.mattermost.groupPolicy = "allowlist"（メンション必須）。
    • channels.mattermost.groupAllowFromで送信者を許可リストに追加します（ユーザーIDを推奨）。
    • channels.mattermost.groupAllowFromにはaccessGroup:<name>エントリを指定できます。アクセスグループを参照してください。
    • チャンネル単位のメンション上書きはchannels.mattermost.groups.<channelId>.requireMentionの下に設定します。デフォルトの場合はchannels.mattermost.groups["*"].requireMentionを使用します。
    • @username照合は変更される可能性があり、channels.mattermost.dangerouslyAllowNameMatching: trueの場合にのみ有効です。
    • オープンチャンネル: channels.mattermost.groupPolicy="open"（メンション必須）。
    • 解決順序: channels.mattermost.groupPolicy、次にchannels.defaults.groupPolicy、最後に"allowlist"。
    • ランタイムの注意: channels.mattermostセクションが完全に存在しない場合、グループのチェックではランタイムが安全側に失敗し、groupPolicy="allowlist"を使用します（channels.defaults.groupPolicyが設定されている場合でも同様です）。また、一度だけ警告をログに記録します。

    例:

    json5
    {  channels: {    mattermost: {      groupPolicy: "open",      groups: {        "*": { requireMention: true },        "team-channel-id": { requireMention: false },      },    },  },}

    送信先

    openclaw message sendまたはCron/Webhookでは、次の送信先形式を使用します。

    送信先 配信先
    channel:<id> IDで指定したチャンネル
    channel:<name>または#channel-name 名前で指定したチャンネル。ボットが所属するチーム全体から検索
    user:<id>またはmattermost:<id> そのユーザーとのDM
    @username DM（Mattermost APIでユーザー名を解決）

    送信では、1つのメッセージにつき最大1つの添付ファイルをサポートします。複数のファイルは別々に送信してください。

    DMチャンネルの再試行

    OpenClawがMattermostのDM送信先に送信する際、最初にダイレクトチャンネルを解決する必要がある場合は、一時的なダイレクトチャンネル作成エラーをデフォルトで再試行します。

    Mattermost Plugin全体でこの動作を調整するにはchannels.mattermost.dmChannelRetryを使用し、1つのアカウントに対して調整するにはchannels.mattermost.accounts.<id>.dmChannelRetryを使用します。デフォルト:

    json5
    {  channels: {    mattermost: {      dmChannelRetry: {        maxRetries: 3,        initialDelayMs: 1000,        maxDelayMs: 10000,        timeoutMs: 30000,      },    },  },}

    注記:

    • これは DM チャンネルの作成 (/api/v4/channels/direct) にのみ適用され、すべての Mattermost API 呼び出しには適用されません。
    • 再試行ではジッター付き指数バックオフを使用し、レート制限、5xx レスポンス、ネットワークエラー、タイムアウトエラーなどの一時的な障害に適用されます。
    • 429 以外の 4xx クライアントエラーは永続的なエラーとして扱われ、再試行されません。

    プレビューストリーミング

    Mattermost は、思考、ツールアクティビティ、返信の部分的なテキストを 下書きプレビュー投稿 にストリーミングし、最終回答を安全に送信できるようになると、その投稿をその場で確定します。partial モードでは、チャンクごとのメッセージでチャンネルを埋め尽くすのではなく、同じ投稿 ID のプレビューを更新します。block モードでは、プレビューが完成済みテキストとツールアクティビティのブロック間で切り替わるため、以前のブロックは次のブロックで上書きされず、それぞれ独立した投稿として表示され続けます。メディアまたはエラーを含む最終応答では、保留中のプレビュー編集をキャンセルし、破棄されるプレビュー投稿を確定する代わりに通常の配信を使用します。

    プレビューストリーミングは、デフォルトで partial モードが 有効 です。channels.mattermost.streaming（モード文字列、真偽値、または { mode: "progress" } のようなオブジェクト）で設定します。

    json5
    {  channels: {    mattermost: {      streaming: "partial", // off | partial | block | progress    },  },}
    ストリーミングモード
    • partial（デフォルト）: 返信が増えるにつれて編集され、最後に完全な回答で確定される単一のプレビュー投稿です。
    • block は、完成済みテキストとツールアクティビティのブロック間でプレビューを切り替えるため、各ブロックはその場で上書きされず、それぞれ独立した投稿として表示され続けます。並行または連続するツール更新は、現在のツールアクティビティ投稿を共有します。
    • progress は生成中にステータスプレビューを表示し、完了時にのみ最終回答を投稿します。
    • off はプレビューストリーミングを無効にします。blockStreaming: true の場合、完成したアシスタントブロックは、単一に統合された最終投稿ではなく、通常のブロック返信（個別の投稿）として引き続き配信されます。
    ストリーミング動作に関する注記
    • ストリームをその場で確定できない場合（たとえばストリーミング中に投稿が削除された場合）、返信が失われないように、OpenClaw は新しい最終投稿の送信にフォールバックします。
    • 思考のみのペイロードは、> Thinking の引用ブロックとして届くテキストを含め、チャンネル投稿から抑制されます。他のサーフェスで思考を表示するには /reasoning on を設定してください。Mattermost の最終投稿には回答のみが残ります。
    • チャンネルマッピングの対応表については、ストリーミングを参照してください。

    リアクション（メッセージツール）

    • channel=mattermost を指定して message action=react を使用します。
    • messageId は Mattermost の投稿 ID です。
    • emoji には thumbsup や :+1: のような名前を指定できます（コロンは省略可能です）。
    • リアクションを削除するには remove=true（真偽値）を設定します。
    • リアクションの追加および削除イベントは、メッセージと同じ DM／グループポリシーチェックに従い、システムイベントとしてルーティング先のエージェントセッションに転送されます。

    例:

    text
    message action=react channel=mattermost target=channel:<channelId> messageId=<postId> emoji=thumbsupmessage action=react channel=mattermost target=channel:<channelId> messageId=<postId> emoji=thumbsup remove=true

    設定:

    • channels.mattermost.actions.reactions: リアクションアクションを有効化／無効化します（デフォルトは true）。
    • アカウント単位の上書き: channels.mattermost.accounts.<id>.actions.reactions。

    インタラクティブボタン（メッセージツール）

    クリック可能なボタンを含むメッセージを送信します。ユーザーがボタンをクリックすると、エージェントは選択内容を受信して応答できます。

    ボタンは、セマンティックな presentation ペイロード（通常のエージェント返信および message action=send）から生成されます。OpenClaw は値ボタンを Mattermost のインタラクティブボタンとしてレンダリングし、URL ボタンをメッセージテキスト内に表示したままにし、選択メニューを読みやすいテキストに変換します。

    text
    message action=send channel=mattermost target=channel:<channelId> presentation={"blocks":[{"type":"buttons","buttons":[{"label":"Yes","value":"yes"},{"label":"No","value":"no"}]}]}

    プレゼンテーションボタンのフィールド:

    labelstringrequired

    表示ラベル（別名: text）。

    valuestring

    クリック時に返送され、アクション ID として使用される値（別名: callback_data、callbackData）。url が設定されていないクリック可能なボタンでは必須です。

    urlstring

    リンクボタン。インタラクティブボタンではなく、メッセージ本文内に label: url テキストとしてレンダリングされます。

    style"primary" | "secondary" | "success" | "danger"

    ボタンのスタイル。Mattermost は、サポートしていない値にデフォルトのスタイルを適用します。

    エージェントのシステムプロンプトでボタン対応を通知するには、チャンネル機能に inlineButtons を追加します。

    json5
    {  channels: {    mattermost: {      capabilities: ["inlineButtons"],    },  },}

    ユーザーがボタンをクリックした場合:

  • アクセスチェック

    クリックしたユーザーは、メッセージ送信者と同じ DM／グループポリシーチェックに合格する必要があります。権限のないクリックには一時的な通知が表示され、無視されます。

  • ボタンを確認表示に置換

    すべてのボタンが確認行（例: 「✓ Yes selected by @user」）に置き換えられます。

  • エージェントが選択内容を受信

    エージェントは選択内容を受信メッセージ（およびシステムイベント）として受け取り、応答します。

    • 実装上の注記
    • ボタンのコールバックでは HMAC-SHA256 検証を使用します（自動で行われ、設定は不要です）。
    • クリック時には添付ブロック全体が置き換えられるため、すべてのボタンがまとめて削除されます。部分的な削除はできません。
    • ハイフンまたはアンダースコアを含むアクション ID は自動的にサニタイズされます（Mattermost のルーティング制限）。
    • action_id が元の投稿上のアクションと一致しないクリックは、403（「Unknown action」）で拒否されます。
    設定と到達可能性
    • channels.mattermost.capabilities: 機能文字列の配列。エージェントのシステムプロンプトでボタンツールの説明を有効にするには、"inlineButtons" を追加します。
    • channels.mattermost.interactions.callbackBaseUrl: ボタンコールバック用の外部ベース URL（例: https://gateway.example.com）。Mattermost から Gateway のバインド先ホストに直接到達できない場合に使用します。
    • 複数アカウント構成では、channels.mattermost.accounts.<id>.interactions.callbackBaseUrl に同じフィールドを設定することもできます。
    • interactions.callbackBaseUrl を省略すると、OpenClaw は gateway.customBindHost + gateway.port（デフォルトは 18789）からコールバック URL を導出し、その後 http://localhost:<port> にフォールバックします。コールバックパスは /mattermost/interactions/<accountId> です。
    • 到達可能性の規則: ボタンのコールバック URL は Mattermost サーバーから到達可能でなければなりません。localhost が機能するのは、Mattermost と OpenClaw が同じホスト／ネットワーク名前空間で実行されている場合のみです。
    • channels.mattermost.interactions.allowedSourceIps: ボタンコールバックの送信元 IP 許可リスト。これを設定しない場合、ループバック送信元（127.0.0.1、::1）のみが受け入れられるため、リモートの Mattermost サーバーをここで許可しないと、そのクリックは 403 で拒否されます。リバースプロキシの背後にある場合は、転送ヘッダーから実際のクライアント IP を導出できるように gateway.trustedProxies も設定します。
    • コールバック先がプライベート／tailnet／内部の場合は、そのホスト／ドメインを Mattermost の ServiceSettings.AllowedUntrustedInternalConnections に追加します。

    API の直接統合（外部スクリプト）

    外部スクリプトや Webhook は、エージェントの message ツールを経由せず、Mattermost REST API を介してボタンを直接投稿できます。可能な場合は Plugin の buildButtonAttachments() を使用してください。生の JSON を投稿する場合は、次の規則に従ってください。

    ペイロード構造:

    json5
    {  channel_id: "<channelId>",  message: "Choose an option:",  props: {    attachments: [      {        actions: [          {            id: "mybutton01", // alphanumeric only - see below            type: "button", // required, or clicks are silently ignored            name: "Approve", // display label            style: "primary", // optional: "default", "primary", "danger"            integration: {              url: "https://gateway.example.com/mattermost/interactions/default",              context: {                action_id: "mybutton01", // must match button id                action: "approve",                // ... any custom fields ...                _token: "<hmac>", // see HMAC section below              },            },          },        ],      },    ],  },}

    HMAC トークンの生成

    Gateway は HMAC-SHA256 を使用してボタンのクリックを検証します。外部スクリプトは、Gateway の検証ロジックと一致するトークンを生成する必要があります。

  • ボットトークンからシークレットを導出

    HMAC-SHA256(key="openclaw-mattermost-interactions", data=botToken) を実行し、16 進数でエンコードします。

  • コンテキストオブジェクトを構築

    _token 以外 のすべてのフィールドを含むコンテキストオブジェクトを構築します。

  • ソート済みキーでシリアライズ

    再帰的にソートされたキーを使用し、空白なしでシリアライズします（Gateway はネストされたオブジェクトも正規化し、コンパクトな JSON を生成します）。

  • ペイロードに署名

    HMAC-SHA256(key=secret, data=serializedContext)

  • トークンを追加

    生成された 16 進ダイジェストをコンテキストの _token として追加します。

    • Python の例:

    python
     secret = hmac.new(    b"openclaw-mattermost-interactions",    bot_token.encode(), hashlib.sha256).hexdigest() ctx = {"action_id": "mybutton01", "action": "approve"}payload = json.dumps(ctx, sort_keys=True, separators=(",", ":"))token = hmac.new(secret.encode(), payload.encode(), hashlib.sha256).hexdigest() context = {**ctx, "_token": token}
    よくある HMAC の落とし穴
    • Python の json.dumps はデフォルトで空白を追加します（{"key": "val"}）。JavaScript のコンパクトな出力（{"key":"val"}）に一致させるには、separators=(",", ":") を使用します。
    • 常に（_token を除く）すべてのコンテキストフィールドに署名してください。Gateway は _token を取り除いた後、残りのすべてに署名します。一部のフィールドだけに署名すると、通知なく検証に失敗します。
    • sort_keys=True を使用してください。Gateway は署名前にキーをソートし、Mattermost はペイロードの保存時にコンテキストフィールドを並べ替える場合があります。
    • ランダムなバイトではなく、ボットトークンからシークレットを導出してください（決定論的）。シークレットは、ボタンを作成するプロセスと検証を行う Gateway で同一でなければなりません。

    ディレクトリアダプター

    Mattermost Plugin には、Mattermost API を介してチャンネル名とユーザー名を解決するディレクトリアダプターが含まれています。これにより、openclaw message send および Cron／Webhook 配信で #channel-name と @username を対象として使用できます。

    設定は不要です。アダプターはアカウント設定のボットトークンを使用します。

    複数アカウント

    Mattermost は channels.mattermost.accounts 配下で複数のアカウントをサポートします。

    json5
    {  channels: {    mattermost: {      accounts: {        default: { name: "Primary", botToken: "mm-token", baseUrl: "https://chat.example.com" },        alerts: { name: "Alerts", botToken: "mm-token-2", baseUrl: "https://alerts.example.com" },      },    },  },}

    アカウントの値はトップレベルのフィールドを上書きします。アカウントが指定されていない場合に使用するアカウントは、channels.mattermost.defaultAccountで選択します。

    トラブルシューティング

    チャンネルで応答がない

    ボットがチャンネルに参加していることを確認し、ボットをメンションする（oncall）か、トリガープレフィックスを使用する（onchar）か、chatmode: "onmessage"を設定してください。

    認証または複数アカウントのエラー
    • ボットトークン、ベースURL、およびアカウントが有効になっているかを確認します。
    • 複数アカウントの問題: 環境変数はdefaultアカウントにのみ適用されます。
    • プライベート/LAN上のMattermostホストでは、network.dangerouslyAllowPrivateNetwork: trueが必要です（SSRFガードはデフォルトでプライベートIPをブロックします）。
    ネイティブのスラッシュコマンドが失敗する
    • Unauthorized: invalid command token.: OpenClawがコールバックトークンを受け入れませんでした。一般的な原因:
      • 起動時にスラッシュコマンドの登録が失敗したか、一部しか完了しなかった
      • コールバックが誤ったGateway/アカウントに到達している
      • Mattermostに、以前のコールバック先を指す古いコマンドが残っている
      • スラッシュコマンドを再有効化せずにGatewayが再起動された
    • ネイティブのスラッシュコマンドが動作しなくなった場合は、ログでmattermost: failed to register slash commandsまたはmattermost: native slash commands enabled but no commands could be registeredを確認します。
    • callbackUrlが省略され、コールバックがhttp://localhost:18789/...のようなループバックURLに解決されたという警告がログに表示される場合、そのURLには、MattermostがOpenClawと同じホスト/ネットワーク名前空間で実行されている場合にしか到達できない可能性があります。代わりに、外部から到達可能なcommands.callbackUrlを明示的に設定してください。
    ボタンの問題
    • ボタンが白いボックスとして表示される、またはまったく表示されない: ボタンデータが不正です。各プレゼンテーションボタンにはlabelとvalueが必要です（どちらかが欠けているボタンは破棄されます）。
    • ボタンは表示されるが、クリックしても何も起きない: MattermostサーバーからGatewayに到達可能であること、MattermostサーバーのIPがchannels.mattermost.interactions.allowedSourceIpsに含まれていること（これを指定しない場合はループバックのみ受け入れられます）、およびプライベートなターゲットの場合はServiceSettings.AllowedUntrustedInternalConnectionsにコールバックホストが含まれていることを確認します。
    • ボタンをクリックすると404が返される: ボタンのidにハイフンまたはアンダースコアが含まれている可能性があります。Mattermostのアクションルーターは英数字以外のIDを処理できません。[a-zA-Z0-9]のみを使用してください。
    • Gatewayのログにrejected callback sourceと表示される: クリック元のIPがinteractions.allowedSourceIpsの範囲外です。Mattermostサーバーまたはイングレスを許可リストに追加し、リバースプロキシの背後ではgateway.trustedProxiesを設定してください。
    • Gatewayのログにinvalid _tokenと表示される: HMACが一致していません。コンテキストフィールドの一部ではなくすべてに署名していること、キーをソートしていること、およびコンパクトなJSON（空白なし）を使用していることを確認してください。上記のHMACセクションを参照してください。
    • Gatewayのログにmissing _token in contextと表示される: ボタンのコンテキストに_tokenフィールドがありません。インテグレーションペイロードを構築するときに、このフィールドが含まれていることを確認してください。
    • GatewayがUnknown actionでクリックを拒否する: context.action_idが投稿上のどのアクションのidとも一致していません。両方に同じサニタイズ済みの値を設定してください。
    • エージェントがボタンを提示しない: Mattermostチャンネル設定にcapabilities: ["inlineButtons"]を追加してください。

    関連項目

    Was this useful?
    On this page

    On this page