OpenClawワークスペース設定：2ヶ月間の使用から得た教訓

OpenClawユーザーが、AIコーディングエージェントを2ヶ月間使用した後の詳細な教訓を共有し、ツール自体よりもワークスペースの設定が重要であることを強調しました。開発者は、標準的なセットアップと比較して、適切に構築されたワークスペースが体験を5〜10倍向上させることを発見しました。

SOUL.mdの設定

「親切でプロフェッショナルであること」のような一般的な指示は、ほとんど影響を与えません。効果的なSOUL.mdファイルは以下のようにすべきです：

• 「答えを先に、文脈は後で」や「知らない場合はそう言い、でっち上げない」などの具体的な行動を含める
• 最大50〜150行に留める（各行がコンテキストウィンドウのトークンを消費するため）
• 通常のシナリオではなく、エッジケースに焦点を当てる：エージェントが何かを知らないとき、リクエストが範囲外のとき、優先順位が競合するときの対応
• 各行をテストする：削除した場合、エージェントの行動は変わるか？変わらない場合は削除する

標準作業手順としてのAGENTS.md

このファイルは「あなたは誰か」（SOUL.mdの役割）ではなく、「どのように働くか」に答えるべきです。重要な洞察：

• 追加された最も価値のあるルール：「重要なタブーの前に、必ずmemory_searchを実行する」ことで推測を防ぐ
• エージェントがミスをした場合、再発防止のルールを追加し、肯定的な指示よりも否定的な指示（「Yを確認せずにXをしない」）の方が効果的であることが多い
• ブートストラップファイルのルールはあくまで助言であり、モデルは強制されるのではなく、求められたから従う
• 絶対に破れないルールについては、強い言葉のマークダウンに頼るのではなく、ツールポリシーとサンドボックス設定を使用する

MEMORY.mdの管理

このファイルはすべてのセッションで読み込まれるため、永続的に保持する必要がある情報のみを含めるべきです：

• 重要な決定、ユーザーの好み、運用上の教訓、ミスから学んだルールを含める
• 日々の情報は、エージェントが必要に応じて検索するmemory/YYYY-MM-DD.mdファイルに入れる
• 厳しい制限：ファイルあたり20,000文字、すべてのブートストラップファイル全体で150,000文字を超えると、警告なしに切り詰められる
• チャットで入力された指示は、コンテキスト圧縮が発生すると保持されない
• 誤って上書きされたMEMORYファイルをコミット履歴から復元するために、ワークスペースをgitに接続する

USER.mdとスキルの最適化

USER.mdファイルは過小評価されています—背景、好み、タイムゾーン、作業コンテキストを含めることで、繰り返しを減らし、トークンを節約できます。スキルについては：

• 30のスキルがインストールされていても、すべてのスキルファイルがすべてのプロンプトに注入されるわけではないが、スキルリスト自体がコンテキストを消費する
• 15以上のスキルから5つに減らすと、出力品質が顕著に向上した
• テスト：もしそのスキルが明日なくなったら、気づくか？気づかないならアンインストールする

不適切な設定による一般的な問題

ペルソナ設定がしっかりしていない場合、以下の問題がすぐに発生します：

• エージェントが常に逸脱し、終わりのないループで絶えず修正が必要になる
• スクリプトで済むのにブラウザを開くなど、非効率な行動でトークンが浪費される
• 読み込まれたスキルが多すぎて、コンテキストが肥大化し、適切な機能を妨げる
• 同じタスクに対してセッションごとに出力が一貫しない

eコマースで働くこの開発者は、利用可能なペルソナのほとんどが不十分であると感じた後、製品調達とShopify運用のペルソナを作成しました。すべての業界にはペルソナにパッケージ化できるワークフローがあるが、良いリソースは有料プラットフォーム、GitHub、ランダムなブログ、古い投稿に散らばっており、多くの「ペルソナ」は単一のSOULファイルで、そのままでは使用できないと指摘しています。