運用でつまずきやすい点
- 権限過多トークンの散在でローテーションと監査が破綻しがち。
- 共有作業ディレクトリで要約キャッシュがノード間衝突する。
- 無制限リトライがレート制限や二重投入を招き、タイムアウトと真の失敗の見分けが曖昧になる。
インストール・ゲートウェイ・隔離のチェックリスト
全ノードで同順・同バージョンとし、差分はノード ID とデータパスのみにします。パス設計は設定・ログ分離を参照してください。
- インストール: 同一ビルド・依存・設定リポジトリ。検証と本番バンドルの混在を避ける。
- ゲートウェイ: 外向きはゲートウェイのみ。HMAC/mTLS、許可 IP、レートとボディ上限を必須化。
- ディレクトリ隔離: ノード別ルート(例
…/work/<node-id>)に要約・中間 JSON・ログを閉じる。dir0750、トークン0440目安。
Webhook と定時トリガの判断
Webhook 運用と整合させ、鮮度と負荷平準化のバランスで選びます。
| 観点 | Webhook | 定時(cron 等) |
|---|---|---|
| レイテンシ | プッシュ直後 | 間隔依存 |
| 負荷 | バースト(ゲートウェイで平滑化) | 分散しやすい |
| 冪等性 | 重複配送に耐える設計 | 処理済み ID 照合 |
最小権限トークンと失敗リトライテンプレ
ノード最小権限に合わせ、要約用トークンは読み取りと PR 参照に限定。投稿が要る場合のみ短期トークンを別経路で。リトライはキュー・リトライ記事に沿い、最大五回・指数バックオフ・デッドレターをテンプレ化し全ノードで同一設定から読み込みます。
- バックオフ目安:一秒・二秒・四秒+ジッタ。
- タイムアウト目安:差分のみ三十〜六十秒、大規模は分割取得。
- ログにジョブ ID・コミット SHA・トークン種別(値はマスク)。
再現手順(五ステップ)
- 隔離ディレクトリ作成。 ノード別作業・ログルートと権限を統一。
- 導入と単一設定源。 同一バージョン、要約スキルとモデル設定を一元化。
- ゲートウェイに Webhook/定時。 署名・レート有効、PR 番号とリポジトリ ID を必須フィールドに。
- 最小スコープトークン注入。 環境別ファイル、0440 等で読み手のみに限定。
- リトライテンプレの検証。 タイムアウトを意図的に起こしキューと通知を確認。
401・タイムアウト FAQ
| 症状 | まず確認すること |
|---|---|
| Git 側 401 | 失効・時刻ずれ・スコープ不足。再発行し全ノードの注入を同期更新。 |
| ゲートウェイ 401 | 署名不一致、ヘッダ誤り、環境 URL 取り違え。 |
| タイムアウト | 大差分・レート待ち・CPU 飽和を疑う。値見直し、分割取得、同時実行上限を下げる。 |
| リトライ悪化 | 四二九で即再試行していないか。バックオフと上限をテンプレ固定、デッドレターで人手へ。 |
ログイン不要の案内
MeshMac ノードで OpenClaw のレビュー自動化を試す
専用 Mac ノードの選定・料金はトップからご覧いただけます。OpenClaw 特集とブログ一覧で関連手順を続けて参照してください(いずれもログイン不要です)。
Code Review 要約
最小権限トークン
リトライテンプレ