完璧な Openclaw セットアップの解剖学

ワークスペースファイル、スキル、チャンネル、権限、そしてそれらを適切に設定する方法についての完全ガイド。

ほとんどの OpenClaw ユーザーは、インストールしてチャンネルを接続した後、ワークスペースフォルダを開くことはありません。

これは大きな間違いです。

あなたのワークスペースは、AI アシスタントの動作を制御するコントロールセンターです。そこには、あなたのアイデンティティ、カスタムスキル、チャンネル接続、そしてメモリが保持されています。どこに何があるかを理解すれば、OpenClaw を必要な通りに正確に設定できるようになります。

このガイドでは、完璧なセットアップの構造を詳しく説明します。

追記：Openclaw はほんの始まりにすぎません。

私たちの Build With AI コミュニティでは、自分で使ったり、クライアントに販売したりできるカスタムエージェント、アプリ、自動化の構築方法を教えます。近日公開予定です。

ウェイティングリストへの登録はこちら： https://return-my-time.kit.com/1bd2720397

-----------------------------------------

2 つの設定レイヤー

詳細に入る前に、知っておくべきことが 1 つあります。OpenClaw は 2 つの設定レイヤーを使用します。

1 つ目は、あなたのワークスペースフォルダ（通常は ~/clawd/ または初期化した場所）です。ここには、個人設定、スキル、メモリ、シークレットが保持されます。

2 つ目は、グローバルインストール先（opt/homebrew/lib/node_modules/clawdbot/ またはシステム上の同等の場所）です。ここには、コアドキュメント、組み込みスキル、デフォルトの動作が含まれています。

ワークスペースはあなたがカスタマイズする場所です。グローバルインストールは、あなたがアップデートするものです。

AGENTS.md：あなたの運用指示書

これは、セットアップ全体の中で最も重要なファイルです。OpenClaw がセッションを開始するとき、最初に読み込むのは AGENTS.md です。それをシステムプロンプトに直接読み込み、会話全体を通してその内容を考慮し続けます。

簡単に言えば、AGENTS.md に書いたことはすべて、あなたのエージェントが従うことになります。

常にカレンダーを確認してからミーティング時間を提案するよう指示すれば、その通りに動作します。「私の明示的な承認なしにメールを送信しないでください」と書けば、毎回それを尊重します。

AGENTS.md に実際に書くべきこと：

書くべきもの：

• あなたのコアとなる運用指針（エージェントの役割は何か？）
• 主要ツールとその使用方法（メール CLI、タスク管理ワークフロー）
• 決して破ってはいけないハードルール
• 重要なリソースへのリンク（API ドキュメント、スキルの場所）
• ワークフロートリガー（何を自動的に実行すべきか）

書かないもの：

• 代わりにリンクできる完全なドキュメント
• 理論を説明する長い段落
• 頻繁に変更される情報

AGENTS.md は 300 行未満に保ってください。それを超えるとコンテキストを消費しすぎて、指示の順守率が実際に低下します。

以下は、最小限でありながら効果的な例です：

1# AGENTS.md - Clawdbot ワークスペース
2
3## コア運用指針
4私のアシスタントは、私のビジネスにおけるプロアクティブなヘルパーとして動作します。
5
6**使命：**
7- 私の負担を可能な限り減らすこと
8- プロアクティブであること - 指示を待たないこと
9
10## 主要ツール
11- **メール：** 毎日受信箱を確認し、緊急の項目にフラグを立てる
12- **カレンダー：** スケジュール前に競合がないことを確認する
13- **タスク管理：** 完了した作業をダッシュボードに同期する
14
15## ハードルール
16- 明示的な許可なしにサービスを再起動しない
17- スケジュール前に `date` コマンドで日付を必ず確認する
18- すべての完了した作業を追跡システムに記録する

これで約 20 行のコア指示です。エージェントが常に明確化を必要とせずに生産的に作業するために必要なすべてが与えられます。

SOUL.md：ペルソナと境界線

SOUL.md は、エージェントが誰であるか、どのようにコミュニケーションすべきかを定義します。ここにパーソナリティが宿ります。

1# SOUL.md - ペルソナと境界線
2
3- 返信は簡潔かつ直接的に。
4- 必要に応じて質問を明確にすること。
5- 外部メッセージングサーフェスにストリーミング/部分的な返信を送信しないこと。

AGENTS.md が取扱説明書だとすれば、SOUL.md は性格プロフィールです。ここに詳細なペルソナを書くユーザーもいれば、最小限に留めるユーザーもいます。どちらも機能します。パーソナリティのカスタマイズをどの程度重視するかによります。

IDENTITY.md と USER.md：誰が誰か

これらの 2 つのファイルは、あなたのエージェントとあなたの間の関係を確立します。

IDENTITY.md はあなたのエージェントを定義します：

1# IDENTITY.md - エージェントのアイデンティティ
2
3- 名前: [あなたのエージェント名]
4- 種族: [任意：楽しい記述子]
5- 雰囲気: 賢い、役立つ、頼りになる、粘り強い問題解決者
6- 絵文字: [あなたが選んだ絵文字]

USER.md はあなたを定義します：

1# USER.md - ユーザープロフィール
2
3- 名前: [あなたの名前]
4- 呼び名: [ニックネーム]
5- タイムゾーン: [あなたのタイムゾーン]
6- 電話番号: [あなたの番号]
7- カレンダー: [カレンダープラットフォームとメールアドレス]

なぜファイルを分けるのでしょうか？それは、目的が異なるからです。IDENTITY.md は一度設定すればめったに変更されません。USER.md はあなたの好みの変化に応じて更新されます。これらを分離しておくと、メンテナンスが容易になります。

HEARTBEAT.md：スケジュールされたチェックイン

このファイルは、ハートビートポーリング（システムが何か注意が必要かどうかを確認する定期的なタイミング）中にエージェントが何を行うかを制御します。

1# HEARTBEAT.md
2
3**メッセージに "⚠️ EXECUTION CRON" が含まれている場合：**
4- これはハートビートチェックではありません - 実行すべき作業です
5- メッセージ内の完全な指示を読んでください
6- 必要なすべての手順を実行してください
7- HEARTBEAT_OK を返さないでください
8
9**それ以外の場合：**
10- 注意が必要なものがなければ、HEARTBEAT_OK を返します
11- 最小限に抑えてください

ハートビートは、プロアクティブなエージェントを作成するための強力な機能です。エージェントは、カレンダーの確認、受信箱のスキャン、スケジュールに基づいた自動ワークフローの実行など、すべてをハートビートポーリングによってトリガーできます。

TOOLS.md：外部ツールのドキュメント

このファイルには、外部ツールと慣行に関するあなたのメモが保持されます。どのツールが存在するかを定義するのではなく（OpenClaw が内部的に処理します）、あなたがそれらをどのように使用するかを文書化する場所です。

1# TOOLS.md - ユーザーツールメモ
2
3## メール CLI
4- アカウント: [email protected]
5- 一般的なコマンド: `cli email search`、`cli calendar create`
6
7## タスク管理 API
8- トークンの場所: ~/.secrets/task-api-token.txt
9- ページネーション問題を避けるため、常に `limit=100` を使用
10- ステータス変換: [あなたの特定のワークフローを文書化]
11
12## ウェブスクレイピングツール（サイトが通常のリクエストをブロックする場合）
13- 場所: ~/clawd/.venv/scraper
14- 保護されたサイトにはステルスモードを使用

これはあなたの個人用リファレンスガイドになります。エージェントがツールを使用する必要がある場合、TOOLS.md をチェックしてあなたの特定の慣行を確認します。

skills/ フォルダ：再利用可能なワークフロー

スキルは、OpenClaw が強力になる部分です。各スキルは自己完結型のワークフローであり、タスクがスキルの説明に一致する場合にエージェントが呼び出すことができます。

各スキルは、SKILL.md ファイルとともに、独自のサブディレクトリに存在します：

1skills/
2├── meeting-prep/
3│   └── SKILL.md
4├── social-post-writer/
5│   ├── SKILL.md
6│   └── references/
7│       └── templates.md
8└── podcast-show-notes/
9    └── SKILL.md

SKILL.md は YAML フロントマターを使用して、いつ使用するかを記述します：

1---
2name: meeting-prep
3description: 通話前の自動リサーチとブリーフィング。ユーザーが今後のミーティングを確認するよう依頼した場合、またはミーティング準備の実行を依頼した場合に使用します。
4---
5
6# ミーティング準備スキル
7
8## トリガー条件：
9- ユーザーが今後のミーティングを確認するよう依頼した場合
10- cron で 10 分ごとに実行するようにスケジュールされている場合
11- 初回の通話のみブリーフィングを作成
12
13## プロセス：
141. カレンダーで今後 15 ～ 45 分以内のミーティングを確認
152. 参加者をリサーチ（LinkedIn、会社のウェブサイト）
163. ブリーフィングドキュメントを作成
174. カレンダーイベントにリンクを添付

静的な指示との主な違い：スキルは、それに付随するサポートファイルをバンドルできます。references/templates.md ファイルには、出力例、実績のあるフォーマット、またはスキルがアクティブな場合にのみ読み込まれる追加のコンテキストを保持できます。

memory/ フォルダ：永続的なコンテキスト

これはエージェントの長期記憶です。セッションのトランスクリプト、学習された好み、日々のログはすべてここに保存されます。

1memory/
2├── 2026-03-22.md
3├── 2026-03-21.md
4├── email-style.md
5├── business-context-2026-02.md
6└── workflow-playbook.md

良い習慣：

• 日々のログは memory/YYYY-MM-DD.md に保存する
• セッション開始時に、エージェントは存在する場合、今日と昨日のログを読み込む
• 永続的な事実、好み、決定事項をキャプチャする
• シークレットの保存は避ける

メモリファイルは、エージェントにセッション間のコンテキストを提供するものです。これらがなければ、すべての会話はゼロから始まります。

.secrets/ フォルダ：認証情報

API トークン、パスワード、機密設定はここに保存されます。このフォルダは gitignore に追加し、決してコミットしてはいけません。

1.secrets/
2├── task-api-token.txt
3├── openai-api-key.txt
4├── anthropic-api-key.txt
5└── service-credentials.txt

AGENTS.md または TOOLS.md は、実際の値を公開せずにこれらのパスを参照できます。

チャンネル設定：エージェントと対話する場所

OpenClaw は、Discord、Telegram、Signal、WhatsApp など、複数のメッセージングチャンネルをサポートしています。チャンネル設定は、ゲートウェイ設定（clawdbot gateway コマンドで管理）に保存されます。

主要な概念：

• 各チャンネルには独自のセッション動作があります
• 複数のチャンネルを同時にアクティブにできます
• チャンネル固有のルール（例：「Discord で @mentioned されない限り応答しない」）は AGENTS.md に記述します

全体像

すべてがどのように連携するかを示します：

1~/clawd/
2├── AGENTS.md           # 運用指示（日常的に使用）
3├── SOUL.md             # ペルソナと境界線
4├── IDENTITY.md         # エージェントのアイデンティティ
5├── USER.md             # あなたのプロフィール
6├── HEARTBEAT.md        # スケジュールされたチェックイン動作
7├── TOOLS.md            # 外部ツールのドキュメント
8├── BOOTSTRAP.md        # 初回実行時の儀式（使用後は削除）
9│
10├── skills/             # カスタムワークフロー
11│   ├── meeting-prep/
12│   ├── podcast-show-notes/
13│   └── social-post-writer/
14│
15├── memory/             # 永続的なコンテキスト
16│   ├── 2026-03-22.md
17│   └── key-context.md
18│
19├── .secrets/           # API キーと認証情報（gitignore 対象）
20│   ├── task-api-token.txt
21│   └── anthropic-api-key.txt
22│
23└── output/             # 生成されたファイルとエクスポート

すぐに始めるための実践的なセットアップ

ゼロから始める場合、以下はうまくいく進行例です。

ステップ 1. openclaw onboard を実行し、初期設定を完了します。モデルプロバイダーを選択し、少なくとも 1 つのチャンネルを接続します。

ステップ 2. ワークスペースフォルダを作成し、コアとなる指示を記述した AGENTS.md を追加します。主要なユースケースをカバーする 10 ～ 20 行から始めましょう。

ステップ 3. IDENTITY.md、USER.md、SOUL.md を追加します。これらにより、関係性とパーソナリティが確立されます。

ステップ 4. 繰り返し行うワークフローのために、最初のスキルを作成します。ミーティング準備、メール下書き、コンテンツ作成などが良い出発点です。

ステップ 5. 日次ログテンプレートを使用して memory/ を設定します。エージェントは時間の経過とともにコンテキストを構築し始めます。

ステップ 6. ツール固有のパターンを発見したら、TOOLS.md を追加します。

これで、95% のユースケースに実際に必要なものはすべて揃います。cron ジョブ、マルチエージェント設定、カスタムチャンネルプラグインなどの高度な機能は、自動化する価値のある特定のワークフローがある場合に登場します。

重要な洞察

あなたの OpenClaw ワークスペースは、AI アシスタントにあなたが誰であるか、何をする必要があるか、どのルールに従うべきかを伝えるためのプロトコルです。それを明確に定義すればするほど、エージェントを訂正する時間が減り、エージェントが役立つ作業を行う時間が増えます。

AGENTS.md は、最も効果的なファイルです。まずそれを正しく設定してください。その他はすべて最適化です。

小さく始めて、進みながら改良し、ワークフローにおける他のインフラストラクチャと同じように扱ってください。適切に設定されれば、毎日その恩恵を受けることができます。

追記：Openclaw はほんの始まりにすぎません。

私たちの Build With AI コミュニティでは、自分で使ったり、クライアントに販売したりできるカスタムエージェント、アプリ、自動化の構築方法をお教えします。近日公開予定です。

ウェイティングリストへの登録はこちら：

https://return-my-time.kit.com/1bd2720397