① インストールとゲートウェイ役割
ゲートウェイ 1 台に OpenClaw を入れ、外向き HTTPS はここだけ。各 Mac はキューへ載せ、Teams URL は保持しない。doctor で TLS・DNS・プロキシを先に潰し、再試行の考え方は タスクキュー再試行 と揃えます。
- ゲートウェイのみ
HTTPS_PROXY/許可リスト、Runner 直 POST は FW で拒否。 - 秘密は
/etc/openclaw/secrets.d/teams/に0440で分離。
② チャンネル紐付けと Workflows/権限
対象チーム/チャンネルを決め、Workflows の Webhook テンプレで URL を発行(従来 URL と非互換のため差し替え必須)。テナントでフロー作成が制限される場合はチャンネル管理者/承認を確保。team_id・環境名を設定に残し、URL はログに出しません。
③ 「ストリーミング風」要約と多ノード摘要
親投稿に run 要約(ブランチ・provider_run_id・成否)、返信にフェーズ別短文と mesh_node_id 行を順 POST すれば、チャット上で「流れている」ように見せられます。多ノード摘要は同一スレッドへ集約。Card はテナントが通る最小キーから。
④ トークン轮换と失敗再試行
URL はbearer。漏えい時は Workflows で再発行しゲートウェイのみ差し替え。429/一時 5xx のみ指数バックオフ、400・401・無効 404 は修正まで再試行しない。冪等は provider_run_id + state。
⑤ よくある HTTP/運用エラー
| 症状 | 切り分け |
|---|---|
404 on POST | 旧コネクタ URL のまま、またはフロー削除。新 Workflows URL へ更新。 |
400 | Card/JSON が非対応。最小ペイロードで切り分け。 |
| ゲートウェイだけ失敗 | プロキシが *.webhook.office.com 等を落としていないか、企業 CA を JVM/ランタイムが信頼しているか。 |
| 投稿不可 | 共有/プライベートのポリシー、ワークフロー権限不足。 |
まとめ・次の一手(ログイン不要)
Workflows URL+ゲートウェイ単一+スレッド要約で多ノードを一チャンネルに揃えるのが実戦パターン。OpenClaw 特集・ブログ一覧 参照。