【最新版】OpenClawのAgent Workspaceとは？初心者向けにやさしく解説

Agent Workspaceって何？（まずイメージ）

Agent Workspaceは、OpenClawのAIにとっての作業机（ホームフォルダ）です。 ファイルを読む/書く系のツールや、「workspace内のファイルをコンテキストとして読み込む」仕組みの多くは、ここを基準に動きます。

ここはこういう意味：
あなたが「このファイルを読んで」と頼んだとき、AIが探しに行く“起点”が workspace です。

イメージ：AIに渡す“会社のデスク”を1つ決めて、そこだけ整頓する感じ。 デスクが散らかると、AIも人間も迷子になります。

デフォルトの場所はどこ？

OpenClawのワークスペースは、デフォルトでは次の場所です。

• デフォルト：~/.openclaw/workspace

ちなみに、プロファイル（OPENCLAW_PROFILE）を使っている場合は、workspaceが別の場所（例：~/.openclaw/workspace-<profile>）になることがあります。

workspaceは「デフォルトcwd」だけ（＝完全な隔離ではない）

公式ドキュメントでも強調されていますが、workspaceは“デフォルトの作業ディレクトリ（cwd）”です。 つまり「相対パスはworkspace基準で解決する」けど、状況によっては絶対パス経由で別の場所に触れてしまう余地があります。

ここはこういう意味：
「workspaceを決めたから安全」というより、安全のための“整理の中心”と考えるのが正解です。

じゃあどうする？というと、隔離したい（検証したい・本番を触らせたくない）なら、sandbox を使います。

workspaceの場所を変える（設定）

workspaceは設定で上書きできます。 “だいたいこういう形”だけ覚えればOKです（あなたの環境に合わせてパスは調整してください）。

{
  agent: {
    workspace: "~/.openclaw/workspace"
  }
}

ここはこういう意味：
「AIの作業机はここ」と、OpenClawに明示しているだけです。

workspaceの中にある“定番ファイル”は何のため？

workspaceには、OpenClawが毎回の実行で参照する“運用ファイル”が置かれます。 初心者がまず覚えるなら、次の6つで十分です。

• AGENTS.md：運用ルール（AIの振る舞い・メモ運用）
• SOUL.md：口調・境界線（何をしないか）
• USER.md：ユーザー情報（呼び方など）
• TOOLS.md：ローカル手順メモ（“使えるツール”を増やすものではない）
• memory/：日付ごとのメモ（今日/昨日を読む運用が安定）
• MEMORY.md（任意）：長期メモ（プライベートなメインセッションでだけ読むのが推奨）

イメージ：“AIの取扱説明書”を同じ机の上に置いておく感じです。

よくある落とし穴：workspaceが複数ある

過去の導入で ~/openclaw のような別フォルダが残っていると、「どっちが本物？」となりがちです。 workspaceが分散すると、設定や状態がズレて混乱しやすくなります。

ここはこういう意味：
“引き出しが2つある机”だと、資料が片方に入ったまま見つからない、みたいな事故が起きます。 基本はworkspaceは1つに寄せるのが安全です。

Gitでバックアップする（ただし必ずprivate）

workspaceは「AIの記憶」に近いので、バックアップがあると安心です。 ただし公開リポジトリはNG（個人情報が混ざる可能性がある）なので、必ずprivateで。

最小の流れだけ載せます。

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

ここはこういう意味：
「いつでも戻せる状態」にしておくと、運用ルールやメモの整理が怖くなくなります。

まとめ

• Agent Workspaceは、OpenClawのAIが作業する“ホームフォルダ”
• workspaceは便利な基準点だが、完全な隔離ではない（隔離したいならsandbox）
• 運用は「workspaceは1つ」「機密は置かない」「privateでバックアップ」が安定

参考

• https://docs.openclaw.ai/concepts/agent-workspace.md