OpenClaw のリトライと故障自己復旧の概要
OpenClaw はリモート Mac 上で依存取得やタスク実行を自動化するエージェントです。ネットの瞬断で依存プルが失敗することがあるため、リトライ戦略（試行回数・待機時間）を設定すると人手なしで復旧できます。本稿では attempts・minDelay・maxDelay、依存プル失敗時の自動リトライ、status／doctor による排錯まで扱います。
リモート Mac でのインストールと最小構成
Homebrew（brew install openclaw）または npm で導入し、設定に API キー・ゲートウェイ URL を書き、openclaw --version と openclaw status で動作確認してください。CI ではジョブ先頭で入れるかイメージに含めると再現しやすいです。
リトライ戦略の設定（attempts／minDelay／maxDelay）と例
試行回数（attempts）と待機時間の下限・上限（minDelay／maxDelay）で制御します。CI では attempts 3〜5、minDelay 2〜5 秒、maxDelay 30〜60 秒がバランス良いです。
| パラメータ | 推奨 | 説明 |
|---|---|---|
| attempts | 3〜5 | 最大試行回数 |
| minDelay | 2s〜5s | リトライ間の最小待機 |
| maxDelay | 30s〜60s | 指数バックオフ上限 |
例：retry: { attempts: 4, minDelay: "3s", maxDelay: "45s" }
依存プル失敗時の自動リトライ設定
依存取得タスクに onFailure: retry と retry ブロック（attempts／minDelay／maxDelay）を追加します。CI のジョブリトライと重複しないよう、どちらか一方でリトライするよう統一してください。
retry: { attempts: 4, minDelay: "3s", maxDelay: "45s" }をタスク定義に追加- 依存取得タスクに
onFailure: retryを指定
openclaw status／doctor によるトラブルシュートとよくあるエラー
openclaw status で接続状態、openclaw doctor で設定・API キー・ネットワークを確認します。
- 接続エラー／タイムアウト：minDelay を増やす、プロキシ・ファイアウォールを確認
- 401／403：
openclaw doctorで API キー・URL を確認 - 依存プルが繰り返し失敗：attempts を増やすか、レジストリ・キャッシュを確認
再現可能な手順のまとめ
- OpenClaw をインストールし
openclaw --version／statusで確認 - リトライ戦略を設定し依存取得タスクに適用、
onFailure: retryを設定 - 問題時は
openclaw status／doctorで切り分け
以上でリモート Mac 上で OpenClaw のリトライと故障自己復旧を設定できます。安定した CI ノードには MacPull のクラウド Mac もご検討ください。ログイン不要で料金・購入を確認でき、OpenClaw インストール・トラブルシュートの記事もご参照ください。