メインコンテンツへスキップ

​
エージェント ワークスペース

ワークスペースはエージェントの家です。 ワークスペースはエージェントのホームです。ファイル ツールおよびワークスペース コンテキストで使用される唯一の作業ディレクトリです。プライベートに保ち、メモリとして扱ってください。 プライベートにしておき、メモリとして扱います。 これは、設定、資格情報、セッションを保存する ~/.openclaw/ とは別です。 重要： ワークスペースは デフォルトの cwd で、ハードサンドボックスではありません。 12. 12. ツールは相対パスをワークスペースに対して解決しますが、サンドボックスが有効でない限り、絶対パスはホスト上の他の場所にも到達できます。 分離が必要な場合は、 agents.defaults.sandbox (または per‐agent sandbox 設定) を使用してください。 重要: ワークスペースは デフォルトの 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)。 推奨: 有効なワークスペースは 1 つに保ってください。追加のフォルダーを使用しなくなった場合は、アーカイブするかゴミ箱に移動してください（例: trash ~/openclaw）。意図的に複数のワークスペースを保持する場合は、agents.defaults.workspace がアクティブなものを指していることを確認してください。 openclaw doctor は、追加のワークスペース ディレクトリを検出すると警告します。

​
ワークスペース ファイル マップ（各ファイルの意味）

以下は、OpenClaw がワークスペース内に期待する標準ファイルです。
  • AGENTS.md
    • エージェントの運用指示と、メモリの使用方法。
    • 各セッションの開始時に読み込まれます。
    • ルール、優先順位、「どのように振る舞うか」の詳細に適した場所です。
  • SOUL.md
    • ペルソナ、トーン、境界。
    • 各セッションで読み込まれます。
  • USER.md
    • ユーザーが誰で、どのように呼びかけるか。
    • 各セッションで読み込まれます。
  • IDENTITY.md
    • エージェントの名前、雰囲気、絵文字。
    • ブートストラップの儀式中に作成/更新されます。
  • TOOLS.md
    • ローカル ツールや慣習に関するメモ。
    • ツールの可用性を制御するものではなく、ガイダンスのみです。
  • HEARTBEAT.md
    • ハートビート実行用の任意の小さなチェックリスト。
    • トークン消費を避けるため、短く保ってください。
  • BOOT.md
    • 内部フックが有効な場合に、Gateway 再起動時に実行される任意の起動チェックリスト。
    • 短く保ち、送信には message ツールを使用してください。
  • BOOTSTRAP.md
    • ワンタイムファーストランの儀式。
    • 新規ワークスペースにのみ作成されます。
    • 儀式が完了した後に削除します。
  • memory/YYYY-MM-DD.md
    • 日次メモリ ログ（1 日 1 ファイル）。
    • セッション開始時に「今日＋昨日」を読むことを推奨します。
  • MEMORY.md（任意）
    • キュレーションされた長期メモリ。
    • メインのプライベート セッションでのみ読み込みます（共有／グループ コンテキストでは不可）。
ワークフローと自動メモリ フラッシュについては Memory を参照してください。
  • skills/（任意）
    • ワークスペース固有の Skills。
    • 名前が衝突した場合、管理／同梱された Skills を上書きします。
  • canvas/（任意）
    • ノード表示用の Canvas UI ファイル（例: canvas/index.html）。
ブートストラップファイルがない場合、OpenClawはセッションに「不足しているファイル」マーカーを 挿入して続行します。 agents.defaults.bootstrapMaxChars で制限を調整します (デフォルト: 20000)。 openclaw setupは既存の ファイルを上書きすることなく、不足しているデフォルトを再現できます。 agents.defaults.bootstrapMaxChars で制限を調整します (デフォルト: 20000)。 openclaw setupは既存の ファイルを上書きすることなく、不足しているデフォルトを再現できます。

​
ワークスペースに含まれないもの

以下は ~/.openclaw/ 配下にあり、ワークスペース リポジトリにコミット すべきではありません。
  • ~/.openclaw/openclaw.json（設定）
  • ~/.openclaw/credentials/（OAuth トークン、API キー）
  • ~/.openclaw/agents/<agentId>/sessions/（セッションのトランスクリプト＋メタデータ）
  • ~/.openclaw/skills/（管理された Skills）
セッションや設定を移行する必要がある場合は、別途コピーし、バージョン管理から除外してください。

​
Git バックアップ（推奨、プライベート）

ワークスペースをプライベートメモリとして扱います。 ワークスペースはプライベート メモリとして扱ってください。プライベート な git リポジトリに入れて、バックアップおよび復旧可能にします。 以下の手順は Gateway（ゲートウェイ）が稼働しているマシンで実行してください（そこにワークスペースがあります）。

​
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. リモートを追加して push します。
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. リモートを追加して push します。
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. リポジトリを目的のパスに clone します（デフォルトは ~/.openclaw/workspace）。
  2. ~/.openclaw/openclaw.json で agents.defaults.workspace をそのパスに設定します。
  3. openclaw setup --workspace <path> を実行して、欠落しているファイルをシードします。
  4. セッションが必要な場合は、~/.openclaw/agents/<agentId>/sessions/ を旧マシンから別途コピーします。

​
高度な注意点

  • マルチエージェント ルーティングでは、エージェントごとに異なるワークスペースを使用できます。ルーティング設定については Channel routing を参照してください。 ルーティング設定については、 Channel routingを参照してください。 ルーティング設定については、 Channel routingを参照してください。
  • agents.defaults.sandbox が有効な場合、メイン以外のセッションは agents.defaults.sandbox.workspaceRoot 配下のセッション単位のサンドボックス ワークスペースを使用できます。