OpenClaw トラブルシューティング: リセット方法5段階

不安定なセットアップのためのOpenClawリセット手順

OpenClawのセットアップが不安定になった場合（スキルがトークンを消費し続ける、エージェントが誤った完了を報告する、アップデートで接続が切れるなど）、最小構成への完全なリセットを行うことで根本原因を特定できます。このアプローチは、複雑さを取り除くことで問題を切り分けます。

5段階のリセットプロセス

ステップ1: すべてのスキルを削除する（60秒）

サイレントループ、トークン消費、コンテキスト注入、設定上書き、マルウェアなどの一般的な不安定要因を排除するため、すべてのスキルをバックアップに移動します：

mkdir ~/.openclaw/skills-backup
mv ~/.openclaw/agents/*/skills/* ~/.openclaw/skills-backup/

これにより、コアエージェントの機能をテストしながら、後で復元するためにスキルを保存できます。

ステップ2: Claude Sonnetに切り替える（30秒）

モデル関連の問題を排除するため、AIモデル設定を変更します：

{
  "ai": {
    "model": "claude-sonnet-4-5-20250929"
  }
}

Sonnetは、安価で信頼性が高く、ツール呼び出しとの一貫性があるため推奨されます。Sonnetでは動作するが、Opus、GPT-5.4、またはローカルモデルでは動作しない場合、問題はモデルにありました。

ステップ3: セッションをクリアする（15秒）

破損している可能性のある会話履歴を削除します：

rm -rf ~/.openclaw/agents/*/sessions/*

これはSOUL.md、メモリ、USER.md、または永続的な設定には影響せず、アップデートやモデル切り替え後に破損する可能性のあるセッションデータのみを削除します。

ステップ4: SOUL.mdを簡素化する（60秒）

現在のSOUL.mdを確認し、必要に応じて最小バージョンに置き換えます：

cat ~/.openclaw/agents/*/SOUL.md

この5行バージョンに置き換えます：

be direct. no filler. match my tone.
if I ask a question, answer it first.
never say "absolutely", "great question", or "I'd be happy to."
if you don't know something, say so.
if a task will cost significant tokens, tell me before doing it.

今後1週間で気になる点に基づいて、徐々に指示を追加していきます。

ステップ5: 再起動してテストする（30秒）

OpenClawを再起動し、基本的なメッセージを送信します：

openclaw stop
openclaw start

「今日は何日？」や「この記事を要約して」といったURL付きの簡単なクエリでテストします。奇妙な動作なく正しく応答すれば、コアは機能しています。問題は削除したものから発生していました。コンポーネントを1つずつ追加し、それぞれの追加後にテストします。

これが有効な理由

ほとんどのOpenClawセットアップは、スキル、エージェント、cronジョブ、モデル切り替え、設定調整を蓄積し、1つのコンポーネントが崩壊を引き起こすまで続きます。すべてが同時に追加されたため、問題のある部分を特定することは不可能になります。最小構成にまで削ぎ落とし、段階的に再構築することで、安定したセットアップが実現します。

このリセットを実施した後、あるユーザーは、1つのエージェント、Sonnet、4つのスキル（ウェブ検索、デイリーブリーフィング、メモ作成、メールトリアージ用のカスタムPythonスクリプト）で安定したセットアップを報告し、月額10ドル未満で4週間以上問題なく動作しています。

📖 Read the full source: r/clawdbot