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

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

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

これは、設定、認証情報、セッションを保存する ~/.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 - 操作手順

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

SOUL.md - ペルソナとトーン

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

USER.md - ユーザーについて

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

IDENTITY.md - 名前、雰囲気、絵文字

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

TOOLS.md - ローカルツールの規約

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

HEARTBEAT.md - Heartbeat チェックリスト

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

BOOT.md - 起動チェックリスト

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

BOOTSTRAP.md - 初回実行の儀式

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

memory/YYYY-MM-DD.md - 日次メモリログ

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

MEMORY.md - 整理済みの長期メモリ（任意）

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

skills/ - ワークスペース Skills（任意）

ワークスペース固有の Skills です。そのワークスペースで最優先されるスキル配置場所です。名前が衝突する場合、プロジェクトエージェント Skills、個人エージェント Skills、管理対象 Skills、バンドル Skills、skills.load.extraDirs を上書きします。

canvas/ - Canvas UI ファイル（任意）

ノード表示用の 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、plugins、ネイティブスレッド状態）
  • ~/.openclaw/credentials/（チャンネル/プロバイダー状態とレガシー OAuth インポートデータ）
  • ~/.openclaw/agents/<agentId>/sessions/（セッショントランスクリプト + メタデータ）
  • ~/.openclaw/skills/（管理対象 Skills）

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

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

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

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

  • リポジトリを初期化する

    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"

  • private リモートを追加する

    GitHub Web UI

    1. GitHub で新しい private リポジトリを作成します。
    2. README では初期化しないでください（マージコンフリクトを避けるため）。
    3. HTTPS リモート URL をコピーします。
    4. リモートを追加してプッシュします。
    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. リモートを追加してプッシュします。
    bash
    git branch -M maingit remote add origin <https-url>git push -u origin main

  • 継続的な更新

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

    • 秘密情報をコミットしない

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

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

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

  • リポジトリをクローンする

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

  • 設定を更新する

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

  • 欠けているファイルを初期配置する

    欠けているファイルを初期配置するには、openclaw setup --workspace <path> を実行します。

  • セッションをコピーする（任意）

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

    • 高度なメモ

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

    関連

    Was this useful?