OpenClawのデータ保存場所とバックアップ戦略を徹底解説

新しいツールを使い始めるとき、一番気になるのは「自分のデータがどこにあるのか」ということではないでしょうか。特に AI ツールの場合、プライバシーやバックアップの方法を正しく理解しておくことは、安心して開発を進めるために欠かせません。

OpenClaw がデータをどのように扱い、どこに保存しているのか、その仕組みを整理しました。

OpenClaw のデータはすべてローカルに保存されますか？

いいえ、すべてではありません。OpenClaw の状態（State）はローカルに保存されますが、外部サービスを利用する際は、送信したデータがそのサービス側にも残ります。

• デフォルトでローカル保存: セッション、メモリファイル、設定、ワークスペースは Gateway を動かしているホストマシンに保存されます（~/.openclaw とワークスペースディレクトリ）。
• 仕組み上リモートになるもの: モデルプロバイダー（Anthropic、OpenAI など）に送信したメッセージは各社の API に送られます。また、チャットプラットフォーム（WhatsApp、Telegram、Slack など）を利用する場合、メッセージデータはそのプラットフォームのサーバーに保存されます。
• コントロール可能: ローカルモデルを使用すればプロンプトを自分のマシン内に留めることができます。ただし、チャネルの通信内容は依然として各チャネルのサーバーを経由します。

---

OpenClaw はどこにデータを保存しますか？

すべてのデータは $OPENCLAW_STATE_DIR（デフォルトは ~/.openclaw）の中に保存されます。

パス	用途
$OPENCLAW_STATE_DIR/openclaw.json	メイン設定ファイル (JSON5)
$OPENCLAW_STATE_DIR/credentials/oauth.json	レガシーな OAuth インポート用
$OPENCLAW_STATE_DIR/agents/<agentId>/agent/auth-profiles.json	認証プロファイル (OAuth + API キー)
$OPENCLAW_STATE_DIR/agents/<agentId>/agent/auth.json	実行時の認証キャッシュ
$OPENCLAW_STATE_DIR/credentials/	プロバイダーの状態（例: whatsapp/<accountId>/creds.json）
$OPENCLAW_STATE_DIR/agents/	エージェントごとの状態（agentDir + セッション）
$OPENCLAW_STATE_DIR/agents/<agentId>/sessions/	会話履歴と状態

ワークスペース（AGENTS.md、メモリファイル、スキルなど）はこれらとは別に管理され、agents.defaults.workspace（デフォルトは ~/.openclaw/workspace）で設定します。

---

AGENTS.md / SOUL.md / USER.md / MEMORY.md はどこに置くべきですか？

これらのファイルは ~/.openclaw ではなく、エージェントのワークスペース内に配置します。

• ワークスペース（エージェントごと）: AGENTS.md, SOUL.md, IDENTITY.md, USER.md, MEMORY.md, memory/YYYY-MM-DD.md, 任意で HEARTBEAT.md
• 状態ディレクトリ（~/.openclaw）: 設定、認証情報、認証プロファイル、セッション、ログ

デフォルトのワークスペースは ~/.openclaw/workspace ですが、以下のように設定を変更できます。

{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } }
}

---

推奨されるバックアップ戦略は何ですか？

エージェントのワークスペースをプライベートな Git リポジトリで管理し、安全な場所にバックアップすることをおすすめします。これにより、メモリや AGENTS/SOUL/USER ファイルを確実に保存できます。

ただし、~/.openclaw 以下の内容（認証情報、セッション、トークンなど）はリポジトリにコミットしないでください。完全に復元できるようにしたい場合は、ワークスペースと状態ディレクトリをそれぞれ個別にバックアップしてください。

---

OpenClaw を完全にアンインストールするにはどうすればよいですか？

詳細な手順については、専用のガイドを確認してください：Uninstall

---

エージェントはワークスペースの外でも動作しますか？

はい、動作します。ワークスペースは**デフォルトの作業ディレクトリ（cwd）**であり、メモリの基準点となる場所ですが、厳格なサンドボックスではありません。相対パスはワークスペース内で解決されますが、サンドボックス設定が有効でない限り、絶対パスを使ってホストマシンの他の場所にアクセスすることも可能です。

特定のリポジトリをデフォルトの作業ディレクトリにしたい場合は、そのエージェントの workspace をリポジトリのルートに設定してください。

{
  agents: {
    defaults: {
      workspace: "~/Projects/my-repo"
    }
  }
}

---

リモートモードの場合、セッションストアはどこにありますか？

セッションの状態は Gateway ホストが管理します。リモートモードで利用している場合、セッションストアは手元のノート PC ではなく、リモートマシン側に存在することに注意してください。

次のステップ

• エージェントの設定について詳しく学ぶ
• Gateway のセットアップを確認する

AI Setup Assistant