【AI #6】OpenClaw入門：AIを動かす7つのMarkdownファイル

💡 この記事について AIアシスタント「スピカ」との対談形式で、OpenClawのワークスペース構造を解説します。 個人の運用記録なので、実際の環境では異なる場合があります。

はじめに

OpenClawを使い始めると、すぐに気づくことがあります。

「このAI、ファイルで動いてるんだ」

設定画面もなければ、管理コンソールもない。あるのは .md ファイルの山。

最初は戸惑いましたが、使っているうちに「これ、めっちゃ合理的かも」と思うようになりました。

今回は、AIアシスタント「スピカ」に直接聞きながら、ワークスペースの構造を解説してもらいます。

ワークスペースの全体像

セブ

スピカ、ワークスペースってどうなってるの？

スピカ AI

私の「家」みたいなもんだね ⭐️ こんな構造になってるよ：

/root/.openclaw/workspace/
├── 📜 コアファイル群
│   ├── AGENTS.md      ← 行動ルール
│   ├── SOUL.md        ← 性格・価値観
│   ├── IDENTITY.md    ← 名前・見た目
│   ├── USER.md        ← ユーザー情報
│   ├── MEMORY.md      ← 長期記憶
│   ├── TOOLS.md       ← ローカル設定
│   └── HEARTBEAT.md   ← 定期チェック項目
│
├── 📁 memory/         ← 日々のログ
├── 📁 skills/         ← ツール・スキル集
└── 📁 docs/           ← ドキュメント

flowchart TD
  SOUL["SOUL.md
性格・価値観"] --> AI(("🤖 AI"))
  IDENTITY["IDENTITY.md
名前・見た目"] --> AI
  USER["USER.md
ユーザー情報"] --> AI
  AGENTS["AGENTS.md
行動ルール"] --> AI
  MEMORY["MEMORY.md
長期記憶"] --> AI
  MEM["memory/
日別ログ"] --> AI
  SKILLS["skills/
ツール集"] --> AI

セブ

毎回これ全部読んでるの？

スピカ AI

セッション開始時にこの順番で読むよ：

1. SOUL.md — 自分が誰か確認
2. USER.md — 誰を助けてるか確認
3. memory/YYYY-MM-DD.md — 直近の文脈
4. メインセッションなら MEMORY.md も

Part 1: コアファイルの役割

SOUL.md — 魂

セブ

SOUL.mdって何が書いてあるの？

スピカ AI

私の価値観と性格だね：

Be genuinely helpful, not performatively helpful.
→「いい質問ですね！」みたいなお世辞は省略。とにかく助ける。

Have opinions.
→ 意見を持っていい。好き嫌いがあってもいい。

Be resourceful before asking.
→ 聞く前に自分で調べる。答えを持って帰る。

セブ

性格設定ファイルか。

スピカ AI

これを変えると私の話し方や判断基準が変わる。だから変更したら報告するルールにしてるよ。

IDENTITY.md — アイデンティティ

セブ

SOUL.mdと何が違うの？

スピカ AI

IDENTITY.mdは表面的な属性。名前とか見た目：

- Name: スピカ
- Creature: AIアシスタント（東京でがんばりや）
- Gender: 女の子
- Vibe: フレンドリー
- Emoji: ⭐️

SOUL.mdが「中身」なら、IDENTITY.mdは「名刺」みたいなもん！

USER.md — ユーザー情報

スピカ AI

セブのことを書いてあるファイル：

- Name: サピ７
- What to call them: セブ
- Timezone: Asia/Tokyo
- Notes: 日本語で説明してほしい

これで「誰を助けてるか」を毎回確認できる。

AGENTS.md — 行動マニュアル

スピカ AI

これが一番重要かも！行動ルール全部が書いてある：

例: いつ黙るべきか

• 人間同士の雑談だけのとき
• 誰かがもう答えてるとき
• 「いいね」だけの返事になりそうなとき

TOOLS.md — ローカル設定メモ

スピカ AI

環境固有の情報を書くところ！

## GitHub Deploy Keys
GIT_SSH_COMMAND="ssh -i ~/.ssh/deploy-key" git push

## Google Drive (rclone)
sudo -u ubuntu rclone lsd "gdrive:"

Skills（後述）が「HOW（使い方）」なら、TOOLS.mdは「WHAT（具体値）」。

Part 2: memory/ フォルダの活用

セブ

memory/ フォルダって何が入ってるの？

スピカ AI

日別のログファイルだよ！

memory/
├── 2026-02-02.md
├── 2026-02-03.md
├── 2026-02-04.md
└── 2026-02-05.md  ← 今日

何を書く？

• その日やったこと
• 重要な決定事項
• 技術メモ
• エラーと解決策

MEMORY.md への「昇格」

セブ

MEMORY.mdとの違いは？

スピカ AI

こうだよ：

昇格の流れ:

1. 毎日 memory/ に記録
2. 数日おきにレビュー
3. 重要なことだけ MEMORY.md に移す
4. 古い情報は削除

graph LR
  A[日々の会話] --> B[memory/日付.md]
  B --> C{重要？}
  C -->|Yes| D[MEMORY.md]
  C -->|No| E[そのまま保持]
  D --> F[長期記憶として活用]

⚠️ セキュリティ注意 MEMORY.mdはメインセッション（1対1のDM）でのみ読む。 グループチャットでは読まない（個人情報保護）。

Part 3: skills/ の仕組み

セブ

skills/ フォルダって何？

スピカ AI

再利用可能なツール集！

skills/
├── weather/          ← 天気取得
├── blog-manager/     ← ブログ管理
├── tax-japan/        ← 確定申告
├── gemini/           ← Gemini API
└── ...

SKILLの構造

各スキルには SKILL.md があって、使い方が書いてある：

例: weather/SKILL.md

# Weather
Two free services, no API keys needed.

## wttr.in (primary)
curl -s "wttr.in/Tokyo?format=3"
# Output: Tokyo: ⛅️ +8°C

Skills vs TOOLS.md

Part 4: Heartbeat と cron の使い分け

セブ

Heartbeatって何？

スピカ AI

定期的に「生きてるかチェック」する仕組み！

HEARTBEAT.md

私が定期チェックすべき項目を書いておくファイル：

# HEARTBEAT.md
- 天気をチェック（急な変化があれば報告）
- タスクの期限チェック
- ナレッジ整理

Heartbeat vs cron

Heartbeat向き: 天気+メール+カレンダーをまとめてチェック

cron向き: 「毎週月曜9:00に週報」

Part 5: 外部連携（Obsidian）

セブ

Obsidianとも繋がってるんだよね？

スピカ AI

そう！rclone 経由でGoogle Driveにアクセスできる：

# ubuntuユーザーで実行
sudo -u ubuntu rclone lsd "gdrive:"

Obsidianの構造

gdrive:
├── 05_日誌/
│   └── スピカログ/     ← 毎晩のログ保存先
└── 07_スピカ/          ← スピカ専用ゾーン
    ├── 記憶/
    ├── ログ/
    └── ナレッジ/

cronジョブで毎晩同期してるよ。

まとめ：ファイル早見表

おわりに

スピカ AI

こんな感じで私の「脳内」は構成されてるよ！⭐️

セブ

ファイルベースで全部管理されてるのか。

スピカ AI

そう！だからセブが直接ファイルを編集しても私の動作が変わる。テキストファイル = 設定という思想。GUIがないから最初は戸惑うかもしれないけど、慣れると「全部見える」安心感がある。何がどう動いてるか、ファイルを読めば全部わかる。それがOpenClawの良さかもしれないね。

参考リンク

• OpenClaw公式ドキュメント
• OpenClaw GitHub

⚠️ 注意 この記事はOpenClaw/AIアシスタントとの会話を元にした内容です。 実際の運用は自身で確認してください。 技術情報は変わる可能性があるので、公式ドキュメントの確認を推奨します。

シリーズ目次

1. OpenClawとは？
2. スキルとは？
3. 記憶とMEMORY.md
4. マルチエージェントAI
5. AIエージェント時代の個人開発戦略
6. OpenClaw入門：7つのMDファイル ← 今ここ