OpenClawのworkspaceとは？構造と運用を整理

OpenClawのworkspaceは、AGENTS.mdやSOUL.md、MEMORY.mdなどを置く、AIエージェントの設定と記憶の作業場所です。openclawの使い方を見ていると、workspaceの場所、workspaceファイル、GitHubでのバックアップ、複数workspaceの分け方まで出てきて、最初は少しややこしいですよね。

仕事や副業の作業自動化に使うなら、まずはworkspaceの構造を押さえてから、セットアップ、パス変更、Dashboardでの状態確認、セキュリティを順に見るのが現実的かなと思います。あなたがOpenClawを安全に使い始めるために、必要なポイントだけを整理します。

OpenClawのworkspace基礎

OpenClawのworkspaceは、AIエージェントの「性格」「行動ルール」「記憶」「作業メモ」を置く場所です。単なる保存フォルダというより、エージェントが毎回どんな前提で動くかを決める土台、と考えると分かりやすいですよ。

最初に押さえたいのは、OpenClawそのものの役割、workspaceの場所、主要なmdファイルの違いです。ここが分かると、GitHubでのバックアップや複数workspaceの使い分けもかなり理解しやすくなります。

OpenClawとは何か

OpenClawは、ClaudeやGPTなどのAIモデルを、自分のPCやサーバー上で動かし、Discord、Telegram、WhatsApp、Slackなどのチャットアプリから使えるようにするツールとして紹介されています。ざっくり言うと、チャットアプリとAIエージェントをつなぐGatewayです。

普通のチャットAIは、画面を開いて会話する使い方が中心です。一方でOpenClawは、チャットアプリから指示を出し、ファイル操作、Web検索、ブラウザ操作、コード実行、定期タスクなどにつなげられる点が特徴です。仕事のメモ整理や下書き作成、開発補助、通知の自動化などに向いています。

🧭 OpenClawでできることの整理

働き方の視点で見ると、OpenClawは「AIに毎回同じ説明をしなくても、ある程度の文脈を持って動いてもらう」ための仕組みに近いです。ただし、設定や権限を広げすぎるとリスクも増えるので、最初は小さな用途から始めるのが現実的かなと思います。

インストール方法や対応コマンドは変わる可能性があります。正確な情報は公式サイトをご確認ください。特にAPIキー、モデル設定、連携チャネルまわりは、古い記事だけで判断しない方が安全です。

workspaceの場所と構造

OpenClawのworkspaceは、調べた範囲では一般的に ~/.openclaw/workspace/ が基本の場所として紹介されています。MacやLinux、WSL2ではこの形で説明されることが多いです。Windowsネイティブ環境やプロファイル設定によっては場所が変わる可能性があります。

workspaceの中には、AGENTS.md、SOUL.md、USER.md、MEMORY.md、TOOLS.md、memoryフォルダ、skillsフォルダなどが置かれます。これらはエージェントの動き方を決める材料です。どのファイルを毎回読むか、どの情報を長期的に残すかで、AIの振る舞いが変わります。

📁 代表的なworkspaceファイル

ここで大事なのは、全部をいきなり編集しようとしないことです。まずはAGENTS.md、SOUL.md、MEMORY.mdの3つを確認するだけでも、workspaceの考え方はかなりつかめます。特にMEMORY.mdには個人的な文脈が入りやすいので、扱いは慎重にしたいところです。

複数のエージェントを使う場合は、workspace-frontend や workspace-backend のように用途別のworkspaceを持たせる例もあります。開発担当、文章作成担当、経費処理担当のように分けると、役割が混ざりにくくなります。

AGENTS.mdの役割

AGENTS.mdは、OpenClawのworkspaceにおける運用マニュアルのようなファイルです。エージェントが最初に何を読み、どんなルールで動き、どのチェックリストを参照するかを決める場所として使われます。

たとえば、作業開始時にSOUL.mdやTOOLS.mdを読む、メインセッションだけMEMORY.mdを読む、特定の作業ではchecklistsフォルダを見る、といったルールをAGENTS.mdに書いておくイメージです。AIに毎回口頭で説明する内容を、あらかじめ固定しておく場所ですね。

📝 AGENTS.mdに書かれやすい内容

特に重要なのが、どの場面でMEMORY.mdを読むかです。OpenClawのworkspace関連情報では、MEMORY.mdをグループチャットやサブエージェントに不用意に読ませないようにする考え方が示されています。個人的な記憶や機密情報が入る可能性があるためです。

AGENTS.mdを編集する時は、まず「毎回必要なルール」と「必要な時だけ参照すればよい情報」を分けるのがコツです。毎回読むファイルが長すぎると、トークン消費や応答のブレにつながりやすいので、詳細な手順はchecklistsやdocsに逃がす方が管理しやすいです。

SOUL.mdとUSER.mdの違い

SOUL.mdは、エージェントの人格や口調、役割を決めるファイルです。たとえば「フロントエンド担当」「経費処理担当」「丁寧に短く答える案内役」のように、エージェント側のキャラクターや仕事の範囲を定義します。

USER.mdは、ユーザー側の情報や好みを置くファイルとして扱われます。たとえば、よく使う言語、好みの説明の粒度、作業スタイル、連絡時の注意点などです。SOUL.mdが「AIはどう振る舞うか」、USER.mdが「ユーザーはどんな人か」という分担です。

👤 SOUL.mdとUSER.mdの違い

この分け方を守ると、後から見直しやすくなります。SOUL.mdにユーザーの個人情報まで入れてしまうと、エージェントを共有した時に不要な情報まで広がる可能性があります。逆にUSER.mdにエージェントの役割を書きすぎると、複数エージェント運用の時に混乱しやすいです。

仕事で使うなら、SOUL.mdには「担当領域」と「やってはいけないこと」を明確に書くのがおすすめです。たとえば開発担当なら、勝手に本番操作をしない、関係ないファイルを触らない、判断が必要な時は確認する、という形です。人格づけよりも、役割と境界線を優先した方が実務では使いやすいですよ。

MEMORY.mdの扱い方

MEMORY.mdは、OpenClawのworkspaceの中でも特に慎重に扱いたいファイルです。長期的に残すべき情報、繰り返し守るルール、過去の失敗から得た注意点などを置く場所として紹介されています。

便利な一方で、MEMORY.mdには個人的な文脈や業務上の情報が入りやすいです。そのため、グループチャットやサブエージェントに無条件で読ませる設計は避けた方がよいです。必要な場面だけ読み込む、不要な情報は残さない、という運用が大事になります。

🔐 MEMORY.mdで意識したい管理ルール

MEMORY.mdが大きくなりすぎると、AIが毎回読む情報が増え、コストや応答品質に影響しやすくなります。OpenClaw関連のworkspace管理では、日々のログをそのまま残すのではなく、重要な学びだけをMEMORY.mdに昇格させる「蒸留」のような考え方が紹介されています。

✅ MEMORY.mdを運用する時の目安

• 毎回守る必要があるルールだけ残す
• 完了したタスクのメモは整理する
• 個人情報や認証情報は書かない
• グループチャットに漏れない前提を作る
• 長くなったらdocsやchecklistsへ分ける

私なら、MEMORY.mdは「AIに覚えておいてほしい全部」ではなく、忘れると仕事に支障が出る重要ルールだけを置く場所として考えます。その方が、OpenClawのworkspaceを長く使っても散らかりにくく、あとから見直す時もラクです。

OpenClawのworkspace運用

OpenClawのworkspaceは、作って終わりではなく、バックアップ、パス管理、複数運用、セキュリティ確認まで含めて考えると安定します。特に仕事や副業の自動化に使うなら、あとから復旧できる状態にしておくことがかなり大事です。

ここでは、初期セットアップ後に見るべき運用ポイントを整理します。難しいコマンドを全部覚えるより、「何を確認すれば事故を減らせるか」を押さえる方が実用的ですよ。

セットアップの流れ

OpenClawの基本的な流れは、インストール、オンボーディング、チャネル接続、Gateway起動、動作確認の順番です。調べた範囲では、インストーラーや npm install -g openclaw@latest を使う方法が紹介されていますが、コマンドや要件は変わる可能性があります。

オンボーディングでは、AIプロバイダーの設定、openclaw.json の生成、Gatewayの準備などを行います。Discord、Telegram、WhatsApp、Slackなどを使う場合は、それぞれのBotトークンや接続情報も必要になります。

🧩 セットアップで見る項目

最初の動作確認では、いきなり大きな自動化を任せず、短い質問や簡単なファイル確認から始めるのが無難です。AIに権限を持たせる範囲を広げるほど便利になりますが、その分だけ確認することも増えます。

インストール手順、対応モデル、チャネル連携の仕様は更新される可能性があります。正確な情報は公式サイトをご確認ください。古い記事だけを見て進めると、コマンド名や設定項目が違ってつまずくかもしれません。

GitHubでバックアップ

workspaceには、AGENTS.md、SOUL.md、USER.md、MEMORY.md、skills、scriptsなど、エージェント運用に関わる大事な情報が入ります。PCが壊れたり、設定を間違えたりした時に備えて、GitHubでバックアップしておくと復元しやすいです。

GitHubで管理するメリットは、単なる保存だけではありません。いつ何を変えたかが履歴として残るので、設定変更後に挙動が変わった時も原因を追いやすくなります。複数PCで同じworkspaceを使いたい時にも役立ちます。

🗂 GitHub管理で得られること

特に大事なのは、GitHubリポジトリはPrivateで作ることです。MEMORY.mdやUSER.mdには個人的な情報が入りやすいため、公開リポジトリに置くのは避けた方がよいです。APIキーやトークンのような認証情報は、そもそもGit管理に入れないように注意してください。

バックアップの基本は、変更確認、追加、コミット、pushです。難しく考えすぎず、大きな変更をした後に「今の状態を記録する」習慣を作るだけでも安心感が変わります。自動化する場合も、最初は手動で問題なくpushできるか確認してから進めるのがいいですよ。

workspaceのパス変更

workspaceのパス変更は、用途別に作業場所を分けたい時や、特定プロジェクトだけをAIに扱わせたい時に検討します。たとえば、開発用、文章作成用、データ整理用でworkspaceを分けると、記憶やルールが混ざりにくくなります。

ただし、パス変更は見た目以上に影響があります。Gateway設定、エージェント設定、チャネル連携、起動サービスなどがworkspaceの場所を前提にしている場合があるため、いきなり移動するのは避けた方が安全です。

🛠 パス変更前の確認リスト

• 現在のworkspaceをバックアップする
• openclaw.json のworkspace設定を確認する
• Gatewayを停止してから変更する
• 変更後にGatewayを再起動する
• チャットから動作確認する

Per-Agent設定では、エージェントごとにworkspaceを指定できる形が紹介されています。たとえば、コードレビュー担当はプロジェクトフォルダ、文章作成担当は原稿フォルダのように分ける考え方です。これにより、必要以上に広いファイルへアクセスさせずに済みます。

設定ファイルの項目名や指定方法はバージョンで変わる可能性があります。調べた範囲では agents.defaults.workspace やエージェント個別のworkspace設定が例として出ていますが、作業前に現在の公式ドキュメントと実際の設定ファイルを確認してください。

複数workspaceの使い分け

複数workspaceは、OpenClawを「ひとつの何でも屋」ではなく、役割別のAIチームとして使いたい時に便利です。フロントエンド担当、バックエンド担当、経費担当、文章作成担当のように分けると、指示や記憶が整理されます。

単一workspaceだと、別のチャンネルや別の用途の情報が混ざる可能性があります。SlackやDiscordで複数チャンネルを使う場合、チャンネルとエージェントを分けることで、会話の文脈やルールを切り分けやすくなります。

👥 複数workspaceの使い分け例

マルチプロファイル構成では、1台のマシン上で複数のGatewayを別ポートで動かす例も紹介されています。これは常駐する独立エージェントを作りたい時に向いています。一方で、一時的な並列作業にはサブエージェントの方が合う場合もあります。

注意したいのは、エージェント同士をチャットで会話させる時のループです。Bot同士が何度もメンションし合うと、無駄な応答が続く可能性があります。返信が相手に新しい行動を求める時だけメンションするなど、ルールをAGENTS.mdに入れておくと運用しやすいです。

Dashboardで状態確認

OpenClawでは、Gateway起動後にローカルのDashboardへアクセスできる例が紹介されています。調べた範囲では、http://127.0.0.1:18789/ のようなローカルURLが使われていますが、ポートは設定によって変わる可能性があります。

Dashboardは、Gatewayが動いているか、接続状態に問題がないかを見る入口として便利です。特に初期設定後は、チャットアプリから反応がない時に、Gateway側が起動しているのか、チャネル接続ができているのかを切り分けるのに役立ちます。

📊 Dashboardとコマンド確認の使い分け

ただし、Dashboardだけで全てが分かるわけではありません。チャット側のBot権限、トークン、チャンネルID、ポート競合、設定ファイルの構文エラーなど、別の場所に原因があることもあります。

うまく動かない時は、「Dashboardを見る」「Gateway statusを見る」「ログを見る」「設定ファイルを見る」の順で確認すると整理しやすいです。感覚で設定を変え続けるより、どこで止まっているかを一つずつ切り分ける方が早いですよ。

セキュリティの注意点

OpenClawのworkspaceは便利ですが、AIにファイル操作や外部連携を任せる以上、セキュリティはかなり重要です。特にMEMORY.md、USER.md、認証情報、GitHubバックアップの扱いは慎重に見た方がいいです。

基本は、必要なファイルだけをworkspaceに置くことです。ホームディレクトリ全体を広く見せるより、作業に必要なフォルダだけを指定する方がリスクを下げやすいです。APIキーやパスワードを含むファイルは、workspaceやGit管理から外すのが安全です。

🔐 セキュリティで確認したい項目

チームや会社で使う場合は、個人利用よりも慎重に進める必要があります。どのファイルをAIが読めるのか、どのチャネルで反応するのか、誰がログを見られるのかを事前に決めておくとトラブルを減らせます。

セキュリティ設定は、環境や扱う情報によって適切なラインが変わります。業務の機密情報や顧客情報を扱う場合は、最終的な判断は専門家にご相談ください。便利さだけで権限を広げず、必要最小限から始めるのが現実的です。

OpenClawのworkspaceまとめ

OpenClawのworkspaceは、AIエージェントの動き方を決める中心部分です。AGENTS.md、SOUL.md、USER.md、MEMORY.mdなどの役割を理解すると、設定変更やトラブル対応がかなりしやすくなります。

✅ OpenClawのworkspaceで押さえる要点

1. OpenClawはチャットアプリとAIエージェントをつなぐGatewayとして使える
2. workspaceは設定、記憶、行動ルールを置く作業場所
3. AGENTS.mdは読み込み順や運用ルールの中心になる
4. SOUL.mdはエージェント側、USER.mdはユーザー側の情報を整理する
5. MEMORY.mdは長期記憶として便利だが、読み込み範囲に注意する
6. GitHubバックアップはPrivateリポジトリで管理する
7. 複数workspaceは用途別のAI運用に向いている
8. Dashboardやログで状態確認すると原因を切り分けやすい
9. セキュリティは最小権限と機密情報の除外が基本

最初にやることは、全部を完璧に設定することではありません。まずは小さなworkspaceで動作確認し、必要に応じてGitHubバックアップ、複数workspace、Dashboard確認へ広げていく流れが扱いやすいです。

OpenClawのworkspaceは、うまく設計するとAIを継続的な仕事の相棒として使いやすくなります。一方で、記憶や権限を雑に扱うとリスクも出ます。あなたの用途に合わせて、必要な範囲から少しずつ整えていくのがいいかなと思います。

記事作成にあたり参考にさせて頂いたサイト

• [OpenClaw] GitHub で AI アシスタントのワークスペースを管理する
• 【2026年最新】OpenClawとは？ AIエージェントを自分のPCで動かせるオープンソースツールの導入ガイド – Qiita
• GitHub – win4r/openclaw-workspace: Claude Code skill for maintaining and optimizing OpenClaw workspace files (AGENTS.md,
• OpenClaw 設定ガイド──マルチエージェント・Web検索・メモリ検索｜Hiroaki
• Reddit – Please wait for verification
• OpenClaw Workspace Directory Structure徹底解説：AIエージェントの頭脳を解剖
• 【超智諮詢】OpenClaw Agent設定完全ガイド：作成、設定 & 管理
• 【OpenClaw】人間はもう不要？マルチプロファイルでAI開発チームを構築してみた – Qiita
• 【第5回】OpenClawでエージェント分離構成を組む──チャンネルごとに専門AIを配置する（何でも答える汎用向けと経費向けAI）

当サイトについて

当サイトでは、インターネット上に散らばるさまざまな情報を収集し、AIを活用しながら要約・編集を行い、独自の切り口で見解を交えながらわかりやすい形でお届けしています。 情報の整理・編集にあたっては、読者やオリジナル記事の筆者へご迷惑をおかけしないよう、細心の注意を払って運営しておりますが、万が一、掲載内容に問題がある場合や修正・削除のご要望がございましたら、どうぞお気軽にお問い合わせください。 迅速に対応をさせていただきます。 その際には、該当記事の URLやタイトルをあわせてお知らせいただけますと、より速やかに対応 することができますのでそちらもご協力いただけますと大変幸いでございます。 今後とも当サイトをよろしくお願いいたします。