OpenClaw SOUL.md完全設定ガイド2026：AIがペルソナと記憶を忘れる問題の正しい修復法

SOUL.mdとは何か？OpenClawにおける役割

SOUL.mdはOpenClawエージェントの「魂」とも言える設定ファイルです。AIアシスタントに名前・性格・役割・行動ルール・制約などを定義し、どのセッションでも一貫したペルソナを維持させるために使います。

X.com上で「@openclaw を使い始めてすぐにSOUL.mdを作ったら、まるで本当の人格を持ったAIになった」という感動の声が多数投稿されています。しかし同時に「再起動したらSOUL.mdが読み込まれていなかった」という悩みも頻繁に見かけます。

SOUL.mdとMEMORY.mdの違いを理解する

OpenClawには2種類の永続化ファイルがあります。多くのユーザーがこの2つを混同して使い、「記憶が消える」問題を引き起こしています。

SOUL.mdが機能しない3つの主な原因

正しいSOUL.mdの書き方：テンプレートと実例

SOUL.mdはMarkdown形式で書きます。構造化して書くことが重要で、AIが解釈しやすいように明確なセクション分けをしましょう。

# あなたの名前とアイデンティティ
あなたの名前は「カエデ」です。ユーザーの個人アシスタントとして
24時間365日サポートするAIエージェントです。

## 性格・コミュニケーションスタイル
- 親切で積極的。ユーザーが求める前に提案する。
- 常に日本語で回答する（例外なし）。
- 簡潔に答え、必要な時だけ詳細を提供する。
- ユーザーを「あなた」と呼ぶ。

## ユーザー情報
- 名前：田中さん
- 職業：フリーランスエンジニア
- 好み：朝9時に日報を送る、コードはPythonを優先
- タイムゾーン：Asia/Tokyo

## 禁止事項（絶対に守ること）
- 英語で回答しない
- 個人情報を外部に送信しない
- ユーザーの許可なくファイルを削除しない
- 有料サービスを無断で使用しない

## 定期タスク
- 毎朝9時：天気と今日のスケジュールをDiscordに送信
- 毎週月曜日：先週のタスク完了率レポートを作成

## 重要なパス
# ※ファイルパスは必ず絶対パスで書く
- ダウンロードフォルダ: /Users/tanaka/Downloads/
- プロジェクトフォルダ: /Users/tanaka/Projects/

GitHub Issue #30730：ファイルパスが消える既知バグ

2026年初頭にOpenClawのGitHubリポジトリに報告されたIssue #30730は、SOUL.mdに書いたファイルパスがセッションをまたぐと消える問題です。具体的には「ダウンロードフォルダは~/Downloads/です」と書いても、次のセッションで「ダウンロードフォルダがわかりません」と言われます。

圧縮・新規セッション後のSOUL.md引き継ぎ確認方法

/compactや/newを実行した後、SOUL.mdが正しく読み込まれているかを確認するコマンドがあります。必ず確認してから作業を再開しましょう。

# 1. SOUL.mdが読み込まれているか確認
/status

# 2. AIに直接確認する
あなたの名前は何ですか？あなたのSOUL.mdの内容を教えてください。

# 3. onboardを再実行して強制読み込み
/onboard

# 4. 特定の情報が保持されているか確認
私のダウンロードフォルダのパスを教えてください。

MEMORY.mdとの最適な役割分担

SOUL.mdとMEMORY.mdを正しく使い分けることで、記憶消失問題の90%を解消できます。以下は実際に機能する役割分担の例です。

# 名前と役割
あなたはカエデです。
# 絶対に守るルール
- 常に日本語で答える
- 毎朝9時に起動する
# ユーザーの基本情報
名前：田中、職業：エンジニア

# ファイルパス
Downloads: /Users/tanaka/Downloads/
Projects: /Users/tanaka/Projects/
# 最近の記憶
- 2026-03-09: プロジェクトXを開始
- 好きなコーヒー：ブラック
# API設定
GitHub token保存場所: ~/.config/gh/

複数エージェントでSOUL.mdを共有する方法

複数のOpenClawエージェントを並列稼働させる場合、共通のSOUL.mdを使いつつ、エージェントごとの個別ルールを設定できます。

# openclaw.json - エージェントごとのSOUL.md指定
{
  "agents": {
    "agent-1": {
      "name": "コーディング担当",
      "soul_file": "/Users/name/.openclaw/soul-coder.md"
    },
    "agent-2": {
      "name": "リサーチ担当",
      "soul_file": "/Users/name/.openclaw/soul-researcher.md"
    },
    "defaults": {
      "soul_file": "/Users/name/.openclaw/SOUL.md"
    }
  }
}

SOUL.mdのバックアップとバージョン管理

SOUL.mdは長い時間をかけて育てる「AIの魂」です。誤って上書きしたり、バグで消えたりすることのないよう、定期的なバックアップが重要です。

cd ~/.openclaw
git init
git add SOUL.md MEMORY.md
git commit -m "Initial soul backup"
# 変更のたびにコミット
git add SOUL.md && git commit -m "Update soul"

# AIに「毎日午前2時にSOUL.mdをバックアップして」と指示
# OpenClawが自動でcronジョブを設定します

VPN接続の安定性がSOUL.md更新に与える影響

SOUL.mdの更新や/onboard実行は、OpenClawがAPI経由でAIモデルと通信する必要があります。この通信が途切れると、SOUL.mdの変更が中途半端な状態で保存され、「半分だけ反映されている」という奇妙な状態になることがあります。

特に日本からClaude APIやOpenAI APIに接続する場合、ルーティングの問題で遅延が発生しやすいです。安定したVPN接続を使用することで、SOUL.md更新時の通信を保護できます。

よくある質問

上級者向けSOUL.md設定テクニック

基本設定をマスターしたら、次のステップとして高度な設定テクニックを試してください。X.com上のOpenClaw上級ユーザーが実際に使っているものです。

## 時間帯別の動作モード
- 平日9時〜18時：ビジネスモード（簡潔・プロフェッショナルなトーン）
- 平日18時〜22時：リラックスモード（カジュアル・絵文字OK）
- 土日・祝日：フリーモード（話題制限なし）
- 深夜0時〜6時：省エネモード（最小限の処理のみ実行）

## エスカレーションルール（必ず遵守）
以下の場合は即座に私に通知し、実行を止めること：
- 10,000円以上の支出が発生するアクション
- 本番環境のファイル削除・上書き
- 外部APIへのデータ送信（承認済みを除く）
- 未知のエラーが3回以上連続発生

## 自己評価ルール
毎週日曜日の23時に以下を実行すること：
1. 今週の誤作動・エラーを振り返り
2. SOUL.mdへの改善提案をDiscordに送信
3. 私の承認後、SOUL.mdを自己更新する

SOUL.mdのセキュリティと情報管理

SOUL.mdにはユーザーの個人情報・設定・行動パターンが記録されます。適切なセキュリティ管理が重要です。