エージェントワークスペース
エージェントワークスペース：場所、レイアウト、バックアップ戦略。
ワークスペースはエージェントのホームです。これは
ファイルツールとワークスペースコンテキストに使用される唯一の場所です。プライベートに保ち、メモリとして扱ってください。
これは ''~/.openclaw/'' とは別で、後者は設定、認証情報、および
セッションを保存します。
重要：ワークスペースはデフォルトのcwdであり、ハードサンドボックスではありません。ツールは
ワークスペースに対して相対パスを解決しますが、絶対パスはまだ到達できます
サンドボックスが有効になっていない限り、ホスト上の他の場所に。分離が必要な場合は、
''''agents.defaults.sandbox''''（および/またはエージェントごとのサンドボックス設定）を使用してください。
サンドボックスが有効で ''workspaceAccess'' が ''"rw"'' でない場合、ツールは実行されます
''~/.openclaw/sandboxes'' 下のサンドボックスワークスペースで、ホストワークスペースではありません。
デフォルトの場所
- デフォルト：''~/.openclaw/workspace''
- ''OPENCLAW_PROFILE'' が ''"default"'' 以外に設定されている場合、デフォルトは
''~/.openclaw/workspace-<profile>''.
- ''~/.openclaw/openclaw.json'' で上書き：
{
agent: {
workspace: "~/.openclaw/workspace",
},
}''openclaw onboard''、''openclaw configure''、または ''openclaw setup'' が作成します
ワークスペースとブートストラップファイル（存在しない場合）のシード。
すでにワークスペースファイルを自分で管理している場合は、ブートストラップを無効にできます
ファイル作成：
{ agent: { skipBootstrap: true } }追加のワークスペースフォルダ
古いインストールでは ''~/openclaw'' が作成されている場合があります。複数のワークスペースを
保持すると、認証や状態のドリフトが混乱する可能性があります。1つしか
ワークスペースが一度にアクティブではありません。
推奨：1つのアクティブなワークスペースを保持してください。使用しなくなった場合
追加のフォルダは、アーカイブするかゴミ箱に移動してください（例：''trash ~/openclaw''）。
複数のワークスペースを意図的に保持する場合は、
''agents.defaults.workspace'' がアクティブなものを指していることを確認してください。
''openclaw doctor'' は、追加のワークスペースディレクトリが検出されると警告を発します。
ワークスペースファイルマッピング（各ファイルの意味）
これらはOpenClawがワークスペースで期待する標準ファイルです：
- ''AGENTS.md''
- エージェントの操作指示とメモリの使用方法。
- 各セッションの開始時にロードされます。
- ルール、優先順位、および「振る舞い方」の詳細を配置するのに適した場所。
- ''SOUL.md''
- ペルソナ、トーン、境界。
- セッションごとにロードされます。
- ''USER.md''
- ユーザーが誰で、どのように呼びかけるべきか。
- セッションごとにロードされます。
- ''IDENTITY.md''
- エージェントの名前、雰囲気、絵文字。
- ブートストラップ儀式中に作成/更新されます。
- ''TOOLS.md''
- ローカルツールと規則に関するメモ。
- ツールの可用性を制御しません。これは単なるガイダンスです。
- ''HEARTBEAT.md''
- オプションのハートビート実行チェックリスト。
- トークンの消費を避けるために短く保ってください。
- ''BOOT.md''
- 内部フックが有効な場合、ゲートウェイの再起動時に実行するオプションのスタートアップチェックリスト。
- 短く保ってください。アウトバウンド送信にはメッセージツールを使用してください。
- ''BOOTSTRAP.md''
- 一回限りの初回実行儀式。
- 新しいワークスペースに対してのみ作成されます。
- 儀式が完了したら削除してください。
- ''memory/YYYY-MM-DD.md''
- 日次メモリログ（1日1ファイル）。
- 今日+昨日のセッションの開始時に読むことをお勧めします。
- ''MEMORY.md''（オプション）
- キュレーションされた長期メモリ。
- プライマリプライベートセッションでのみロードされます（共有/グループコンテキストではありません）。
ワークフローと自動メモリ更新については、''メモリ''を参照してください。
- ''skills/''（オプション）
- ワークスペース固有のスキル。
- 名前の競合時にホスト/バンドルスキルを上書きします。
- ''canvas/''（オプション）
- ノード表示用のCanvas UIファイル（例：''canvas/index.html''）。
ブートストラップファイルが不足している場合、OpenClawは「ファイルが見つかりません」マーカーを注入します
セッションにして続行します。大きなブートストラップファイルは注入時に切り捨てられます。
''agents.defaults.bootstrapMaxChars'' を使用して制限を調整してください（デフォルト：20000）。
''openclaw setup'' は、既存のファイルを上書きせずに欠落しているデフォルトを再作成できます
ファイル。
ワークスペースにないもの
これらは ''~/.openclaw/'' の下にあり、ワークスペースリポジトリにコミットすべきではありません：
- ''~/.openclaw/openclaw.json'' (configuration)
- ''~/.openclaw/credentials/''（OAuthトークン、APIキー）
- ''~/.openclaw/agents/<agentId>/sessions/'' (session logs + metadata)
- ''~/.openclaw/skills/''（管理されたスキル）
セッションまたは設定を移行する必要がある場合は、別々にコピーして
バージョン管理から外してください。
Gitバックアップ（推奨、プライベート）
ワークスペースをプライベートメモリとして扱ってください。プライベート gitリポジトリに入れてください。
バックアップされ、回復可能になります。
ゲートウェイを実行しているマシンでこれらの手順を実行してください（つまり、
ワークスペースがある場所）。
#
1) リポジトリを初期化
gitがインストールされている場合、新しいワークスペースは自動的に初期化されます。この
ワークスペースがまだリポジトリでない場合は、実行してください：
cd ~/.openclaw/workspace git init git add AGENTS.md SOUL.md TOOLS.md IDENTITY.md USER.md HEARTBEAT.md memory/ git commit -m "Add agent workspace"
#
2) プライベートリモートを追加（初心者向けオプション）
オプションA：GitHub Web UI
1. GitHubで新しいプライベートリポジトリを作成します。
2. READMEで初期化しないでください（マージの競合を避けるため）。
3. HTTPSリモートURLをコピーします。
4. リモートを追加してプッシュ：
git branch -M main git remote add origin <https-url> git push -u origin main
オプションB：GitHub CLI (''gh'')
gh auth login gh repo create openclaw-workspace --private --source . --remote origin --push
オプションC：GitLab Web UI
1. GitLabで新しいプライベートリポジトリを作成します。
2. READMEで初期化しないでください（マージの競合を避けるため）。
3. HTTPSリモートURLをコピーします。
4. リモートを追加してプッシュ：
git branch -M main git remote add origin <https-url> git push -u origin main
#
3) 継続的な更新
git status git add . git commit -m "Update memory" git push
シークレットを漏らさないでください
プライベートリポジトリであっても、ワークスペースにシークレットを保存することは避けてください：
- APIキー、OAuthトークン、パスワード、またはプライベート認証情報。
- ''~/.openclaw/'' 以下のすべて。
- チャットまたは機密の添付ファイルの生のダンプ。
機密の参照を保存する必要がある場合は、プレースホルダーを使用し、実際の参照を
他の場所（パスワードマネージャー、環境変数、または ''~/.openclaw/''）に保持してください。
推奨される ''.gitignore'' スターター：
.DS_Store .env **/*.key **/*.pem **/secrets*
ワークスペースを新しいマシンに移動
1. リポジトリを目的のパスにクローンします（デフォルト ''~/.openclaw/workspace''）。
2. ''agents.defaults.workspace'' を ''~/.openclaw/openclaw.json'' のそのパスに設定します。
3. Run ''openclaw setup --workspace <path>'' to seed any missing files.
4. If you need sessions, copy ''~/.openclaw/agents/<agentId>/sessions/'' from the
古いマシンから別々に。
高度なメモ
- マルチエージェントルーティングは、エージェントごとに異なるワークスペースを使用できます。参照してください
''チャネルルーティング'' ルーティング設定用。
- ''agents.defaults.sandbox'' が有効になっている場合、非プライマリセッションはセッションごとのサンドボックスを使用できます
''agents.defaults.sandbox.workspaceRoot'' 下のワークスペース。