English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Fundamentals

Agent ワークスペース

ワークスペースはエージェントのホームです。これはファイルツールとワークスペースコンテキストに使われる唯一の作業ディレクトリです。非公開に保ち、メモリとして扱ってください。

これは、設定、認証情報、セッションを保存する ~/.openclaw/ とは別です。

デフォルトの場所

  • デフォルト: ~/.openclaw/workspace
  • OPENCLAW_PROFILE が設定され、かつ "default" でない場合、デフォルトは ~/.openclaw/workspace-<profile> になります。
  • ~/.openclaw/openclaw.json で上書きします:
json5
{  agents: {    defaults: {      workspace: "~/.openclaw/workspace",    },  },}

openclaw onboard、openclaw configure、または openclaw setup は、ワークスペースを作成し、不足している場合はブートストラップファイルを初期配置します。

ワークスペースファイルをすでに自分で管理している場合は、ブートストラップファイルの作成を無効にできます:

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

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

古いインストールでは ~/openclaw が作成されている場合があります。複数のワークスペースディレクトリを残しておくと、同時にアクティブになるワークスペースは 1 つだけであるため、認証や状態のずれで混乱することがあります。

ワークスペースファイルマップ

これらは、OpenClaw がワークスペース内にあることを想定する標準ファイルです:

AGENTS.md - operating instructions

エージェントの操作指示と、メモリの使い方です。各セッションの開始時に読み込まれます。ルール、優先順位、「どう振る舞うか」の詳細を書くのに適しています。

SOUL.md - persona and tone

ペルソナ、トーン、境界です。各セッションで読み込まれます。ガイド: SOUL.md パーソナリティガイド。

USER.md - who the user is

ユーザーが誰で、どのように呼びかけるかです。各セッションで読み込まれます。

IDENTITY.md - name, vibe, emoji

エージェントの名前、雰囲気、絵文字です。ブートストラップ儀式中に作成/更新されます。

TOOLS.md - local tool conventions

ローカルツールと規約に関するメモです。ツールの利用可否は制御せず、単なるガイダンスです。

HEARTBEAT.md - heartbeat checklist

Heartbeat 実行用の任意の小さなチェックリストです。トークン消費を避けるため短く保ってください。

BOOT.md - startup checklist

Gateway の再起動時に自動実行される任意の起動チェックリストです（内部フックが有効な場合）。短く保ち、外向き送信には message ツールを使ってください。

BOOTSTRAP.md - first-run ritual

初回実行時だけの儀式です。新規ワークスペースにのみ作成されます。儀式が完了したら削除してください。

memory/YYYY-MM-DD.md - daily memory log

日次メモリログ（1 日につき 1 ファイル）です。セッション開始時に今日と昨日を読むことを推奨します。

MEMORY.md - curated long-term memory (optional)

整理された長期メモリ: 永続的な事実、好み、決定、短い要約です。詳細なログは memory/YYYY-MM-DD.md に保持し、メモリツールが必要に応じて取得できるようにしてください。各プロンプトへ注入しないためです。MEMORY.md はメインの非公開セッションでのみ読み込みます（共有/グループコンテキストでは読み込まない）。ワークフローと自動メモリフラッシュについては メモリ を参照してください。

skills/ - workspace skills (optional)

ワークスペース固有の Skills です。そのワークスペースで最も優先度の高い Skill の場所です。名前が衝突した場合、プロジェクトエージェントの Skills、個人エージェントの Skills、管理対象 Skills、同梱 Skills、skills.load.extraDirs を上書きします。

canvas/ - Canvas UI files (optional)

ノード表示用の Canvas UI ファイルです（例: canvas/index.html）。

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

これらは ~/.openclaw/ の下にあり、ワークスペースリポジトリへコミットしてはいけません:

  • ~/.openclaw/openclaw.json（設定）
  • ~/.openclaw/agents/<agentId>/agent/auth-profiles.json（モデル認証プロファイル: OAuth + API キー）
  • ~/.openclaw/agents/<agentId>/agent/codex-home/（エージェントごとの Codex ランタイムアカウント、設定、Skills、Plugin、ネイティブスレッド状態）
  • ~/.openclaw/credentials/（チャンネル/プロバイダー状態とレガシー OAuth インポートデータ）
  • ~/.openclaw/agents/<agentId>/sessions/（セッション文字起こし + メタデータ）
  • ~/.openclaw/skills/（管理対象 Skills）

セッションや設定を移行する必要がある場合は、別途コピーし、バージョン管理の対象外にしてください。

Git バックアップ（推奨、非公開）

ワークスペースを非公開メモリとして扱ってください。バックアップと復元ができるよう、private git リポジトリに入れてください。

これらの手順は、Gateway が動作するマシン（つまりワークスペースが存在する場所）で実行します。

  • Initialize the repo

    git がインストールされている場合、新規ワークスペースは自動的に初期化されます。このワークスペースがまだリポジトリでない場合は、次を実行します:

    bash
    cd ~/.openclaw/workspacegit initgit add AGENTS.md SOUL.md TOOLS.md IDENTITY.md USER.md HEARTBEAT.md memory/git commit -m "Add agent workspace"

  • Add a private remote

    GitHub web UI

    1. GitHub で新しい private リポジトリを作成します。
    2. README で初期化しないでください（マージ競合を避けるため）。
    3. HTTPS リモート URL をコピーします。
    4. リモートを追加して push します:
    bash
    git branch -M maingit remote add origin <https-url>git push -u origin main

    GitHub CLI (gh)

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

    GitLab web UI

    1. GitLab で新しい private リポジトリを作成します。
    2. README で初期化しないでください（マージ競合を避けるため）。
    3. HTTPS リモート URL をコピーします。
    4. リモートを追加して push します:
    bash
    git branch -M maingit remote add origin <https-url>git push -u origin main

  • Ongoing updates

    bash
    git statusgit add .git commit -m "Update memory"git push

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

    推奨される .gitignore スターター:

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

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

  • Clone the repo

    リポジトリを目的のパス（デフォルトは ~/.openclaw/workspace）に clone します。

  • Update config

    ~/.openclaw/openclaw.json で agents.defaults.workspace をそのパスに設定します。

  • Seed missing files

    不足しているファイルをシードするには、openclaw setup --workspace <path> を実行します。

  • Copy sessions (optional)

    セッションが必要な場合は、古いマシンから ~/.openclaw/agents/<agentId>/sessions/ を別途コピーします。

    • 高度なメモ

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

    関連

    Was this useful?
    On this page

    On this page