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

​

デフォルトの場所

• デフォルト: ~/.openclaw/workspace
• OPENCLAW_PROFILE が設定され、"default" でない場合、デフォルトは ~/.openclaw/workspace-<profile> になります。
• OPENCLAW_WORKSPACE_DIR が設定されている場合、上記の両方を上書きします。
• 明示的なワークスペースがない非デフォルトのエージェント（agents.entries.*）は、共有のデフォルトワークスペースではなく、<state-dir>/workspace-<agentId> に解決されます。

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

{ agents: { defaults: { skipBootstrap: true } } }

​

追加のワークスペースフォルダー

​

ワークスペースのファイル構成

​

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

• ~/.openclaw/openclaw.json（設定）
• ~/.openclaw/state/openclaw.sqlite（共有ワークスペースのセットアップ状態と証明）
• ~/.openclaw/agents/<agentId>/agent/auth-profiles.json（モデル認証プロファイル: OAuth + API キー）
• ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite（セッション行、トランスクリプト、エージェント単位のランタイム状態）
• ~/.openclaw/agents/<agentId>/agent/codex-home/（エージェント単位の Codex ランタイムアカウント、設定、Skills、plugins、ネイティブスレッド状態）
• ~/.openclaw/credentials/（チャンネル／プロバイダーの状態と旧 OAuth インポートデータ）
• ~/.openclaw/agents/<agentId>/sessions/（旧移行元とアーカイブ／サポート成果物）
• ~/.openclaw/skills/（管理対象の Skills）

​

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"

git branch -M main
git remote add origin <https-url>
git push -u origin main

gh auth login
gh repo create openclaw-workspace --private --source . --remote origin --push

git branch -M main
git remote add origin <https-url>
git push -u origin main

git status
git add .
git commit -m "Update memory"
git push

​

シークレットをコミットしない

.DS_Store
.env
**/*.key
**/*.pem
**/secrets*

​

ワークスペースを新しいマシンに移動する

​

高度な注記

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

​

関連項目

• Heartbeat - ワークスペースファイル HEARTBEAT.md
• サンドボックス化 - サンドボックス環境でのワークスペースへのアクセス
• セッション - セッションの保存パス
• 常設指示 - ワークスペースファイル内の永続的な指示