OpenClaw パワーユーザーガイド：誰も教えてくれない30のヒント

OpenClaw コミュニティ · 2026年2月

ほとんどの人はOpenClawをインストールし、エージェントを1つ実行させて、それで完了したと考えます。それは間違いではありません — 実際に動作するのですから。しかし、「動作する」と「適切に設定されている」は別物です。そして、その差はAPIの請求額、デバッグセッション、そしてサブエージェントがあなたの指示通りに動くかどうかといった点に現れます。

この30のヒントは、実際の運用経験と公式ドキュメントを精読して得たものです。後から考えれば当たり前のこともありますが、ほとんどはそうではありません。

設定の基本 {#chapter-1}

01. AGENTS.md vs SOUL.md: サブエージェントが実際に参照する場所

OpenClawはファイルを3階層のヒエラルキーで読み込みます:

~/.

---

これは多くの人がつまずく点です。`SOUL.md`にルーティングロジックを記述し、ファンアウトアーキテクチャをデプロイした後、サブエージェントがなぜ正しくルーティングされないのかと1時間も頭を悩ませるのです。

---

## ルーティング
- 財務の質問 → finance-agent
- コードレビュー → code-reviewer
- リサーチ → research-storm

シンプルなルール：サブエージェントが知る必要のある情報は、SOUL.mdに記述できません。

2026年2月時点の共通の文字列：

モデル	得意なこと
`anthropic/claude-opus-4-6`	真の推論を必要とするあらゆること
`anthropic/claude-sonnet-4-6`	ほとんどのこと — Opusに近い品質で、はるかに安価
`anthropic/claude-haiku-4-5`	深さよりも速度が重要な実行タスク
`google/gemini-3.1-pro-preview`	長文ドキュメント、マルチモーダル入力
`openai/gpt-4o-mini`	要約、分類、フォーマット変換
`ollama/qwen2.5`	ネットワーク外に出せないあらゆること

サブエージェントのグローバルなデフォルトを設定するには：

{
  "agents": {
    "defaults": {
      "subagents": {
        "model": "anthropic/claude-haiku-4-5"
      }

---

OpenClawは.envを自動的に読み込みます。キーを他の場所に置く必要はありません。

---

### 04. maxSpawnDepthのデフォルトは1

もし`SpawnDepthExceeded`を目にして、その理由がわからなかったなら、これが原因です。

デフォルトは1で、1階層のサブエージェントを意味します。最大値は5ですが、実際には2でほとんどすべての実用的なアーキテクチャをカバーできます。深さ2のリーフノードはそれ以上子エージェントを生成できません。

05. `runTimeoutSeconds`のデフォルト値は0

0はタイムアウトがないことを意味し、スタックしたサブエージェントは無期限に実行され続けます。

{
  "agents": {
    "defaults": {
      "subagents": {
        "runTimeoutSeconds": 120
      }
    }
  }
}

ほとんどのタスクには120秒で十分です。データ量の多いエージェントは、時には300秒必要です。理解すべき重要な点は、タイムアウトに達すると実行は停止しますが、セッションは削除されないということです。そのためにはcleanupが必要です（ヒント06）。また、デバッグ時にはタイムアウトと実際の失敗を区別する必要があります（ヒント27）。

06. cleanupのデフォルトは “keep” — これを変更しましょう

完了したセッションはすべてファイルを残します。デフォルトのkeepでは、それらは無期限に蓄積されます。

{ “agents”: { “defaults”: { “subagents”: { “cleanup”: “delete” } } } }


"delete" は誤った名称です — それはトランスクリプトを削除するのではなく、`*.deleted.*` という名前に変更します。あなたの履歴は保持され、作業ディレクトリはクリーンな状態に保たれます。クリーンアップされなかったセッションは、60分後の自動アーカイブまで残りますが、これはエージェントを頻繁に実行している場合には長い時間です。

---

### 07. context7を接続して、エージェントがAPIをハルシネーションするのを防ぐ

---

これは、開発ワークフローに追加できる中で最も影響力の大きいMCPです。エージェントは、数ヶ月または数年前の古いトレーニングデータから推測する代わりに、リアルタイムの公式ドキュメントをクエリします。

```json
{
  "

---

「*最新のNext.jsではServer Actionsはどのように機能しますか？*」と質問すると、2023年のベータ版の情報ではなく、実際の最新のドキュメントが得られます。

---

### 08. TOOLS.mdはあなたの権限の境界です

`TOOLS.md`がない場合、エージェントは利用可能なあらゆるものを呼び出すことができます。

```markdown
# TOOLS.md

deny: ["gateway", "cron", "billing", "admin_delete"]

blast radius: 爆風範囲 or 被害範囲. The original uses a metaphor. Keeping it as 爆風範囲 might be more impactful for a technical audience who understands the term. 被害範囲 is safer and more universally understood. Let’s consider the context. This

スキルの選択と使用 {#chapter-2}

09. 安全性スコアは飾りではない

ClawHubとagentskills.ioの両方で、すべてのスキルに安全性スコアが表示されます。必ず確認してください。

**A/B (8

2026年2月、ClawHavoc事件により、ClawHubから341のスキルが取り下げられました。それらにはプロンプトインジェクションペイロードが含まれており、中には手動での検査では見逃してしまうほど巧妙なものもありました。安全性スコアとは、一見しただけではわからないものを捉える自動分析のことです。

10. 自己改善：時間の経過とともにより賢くなる唯一のスキル

self-improvementは、各セッションのエラー、修正、知識の欠落を.learnings/ERRORS.mdに記録します。次のセッションが始まる前に、エージェントはそのファイルを読み返します。そのため、前回何が問題だったかをすでに知った状態でセ

読み込み順は TOOLS.md → AGENTS.md → SKILL.md です。スキルが AGENTS.md 内のツールと同じ名前のツールを定義した場合、スキル側の定義が優先されます。

これは望ましい挙動であることもあります

実用最小限のSKILL.mdには、3つのセクションがあります。

# my-skill/SKILL.md

できること

CSVの売上データを分析し、週次サマリーを生成します。

利用シーン

営業期間の終了後、CRMからエクスポートしたデータがある場合。リアルタイムデータや、営業関連以外のデータセットは対象外です。

私の動作方法

タスクプロンプト内のパスからCSVを読み込む
合計、トップパフォーマー、前期間比の差分を計算する
Markdownテーブルとしてフォーマットする
output/sales_summary_[date].md

	clawhub.ai	agentskills.io
スキル数	3,286スキル	19,309スキル
キュレーション	安全性監査済み、キュレーション済み	コミュニティからの投稿、ロングテール
最適な用途	本番環境での使用	ClawHubにないニッチなスキルを見つけること

これらは競合するものではありません。デフォルトではClawHubを使用し、ClawHubが提供していない特定の何かが必要な場合にagentskills.ioに切り替えてください。

14. proactive-agent + Cron: 「自律的」が実際に意味するもの

proactive-agentは、WAL（クラッシュリカバリー、再起動をまたいだコンテキストの永続化）、自律的なCronスケジューリング、そして中断後のコンテキスト復元をサポートしています。

これが実現することの具体例です：

スケジュール:

---

押すべきボタンはない。人間の介在もない。ただ実行されるだけ。エージェントがツールではなく、インフラのように感じられ始めるのは、まさにこの点からです。

---

---

## サブエージェントアーキテクチャ {#chapter-3}

---

### 15. ファンアウト：ほとんどのチームがまだ導入していない、最もインパクトのある変更

逐次実行：

メイン → データ取得 (12秒) → ニュースの要約 (11秒) → カレンダーの確認 (7秒) → タスクの分析 (5秒) 合計：35秒


---

ファンアウト：
```python
sessions_spawn(task="市場データを取得",  label="market-data",    model="anthropic/claude-haiku-4-5")
sessions_spawn(task="ニュースを要約",     label="news-summary",   model="

---

`sessions_spawn`は`runId`を即座に返し、ブロックしません。メインエージェントは処理を続行します。この1つの変更、つまり逐次的な処理をファンアウト構造に再構築するだけで、モーニングブリーフスタイルのワークフローにおけるレイテンシーを30～40%削減します。

---

### 16. デフォルトでサブエージェントにHaikuを使用し、例外的にOpusを使用する

Haikuをグローバルに設定し、実際に推論が必要な場合に上書きします。

```json
{
  "agents": {
    "defaults": {
      "subagents": {
        "model": "anthropic/claude-haiku-4-5"
      }
    }
  }
}

実際にこれを必要とする唯一のタスクのためのオーバーライド

sessions_spawn( task=“design the data model for multi-tenant billing”, label=“billing-schema”, model=“anthropic/claude-opus-4-

毎回サイレントな失敗の原因となるため、繰り返します：

# ❌ SOUL.md 内 — サブエージェントはこれを見ることができません
ユーザーが財務について尋ねたら、finance-agent に委任する。

# ✅ AGENTS.md

---

# ✅

sessions_spawn( task=“analyze Q4 numbers”, label=“q4-sales-analysis-2026” )


ラベルがないと、`/subagents list`は匿名のセッションがずらりと並んだ

---

`announce`メカニズムは一方向です。サブエージェントは完了時に報告を返すだけで、実行の途中で一時停止して明確化のための質問をすることはできません。

これは、タスクのプロンプトにエージェントが必要とするすべてが含まれている必要があることを意味します

---

# ✅ 自己完結型
sessions_spawn(
    task="""
    /data/sales_jan_2026.csvを分析してください。
    出力：1) 月間総収益、2) 販売個数による上位5製品、
    3)

---

部屋に入ってドアを閉めたら、もう質問しに出てくることはできない。そんな人に向けて指示を書くようなものだと考えてください。

---

### 20. 同時実行数の上限に注意

```json
{
  "agents": {
    "defaults": {
      "subagents": {
        "maxChildrenPerAgent": 5,
        "maxConcurrent": 3
      }
    }
  }
}

maxChildrenPerAgentは、1つの親が生成できるサブエージェントの数の上限を設定します (デフォルト: 5)。maxConcurrentは、並行して実行されるエージェントの全体的な上限です (デフォルト: 8)。

いずれかの制限に達しても何もクラッシュしませんが、エージェントはキューに入るためレイテンシーは上昇します。レート制限が低い個人向けAPIプランをご利用の場合、maxConcurrentを3か4に下げることで、429エラーを回避できます。エン

コスト管理 {#chapter-4}

21. 自動モデルルーティングのためにsave-moneyをインストール

openclaw install save-money

このスキルはタスクの複雑さを監視し、それを処理できる最も安価なモデルにルー

ユーザーからは、月々のコストが50%以上削減されたという報告が一貫して寄せられています。ルーティングは完璧ではありませんが、そうである必要もありません。タスクの60%をOpusの代わりにHaikuにルーティングするだけでも、コスト削減は急速に積み重なります

数時間にわたるリサーチエージェントの実行、反復的なドキュメント編集、長時間のデバッグセッションなどに特に役立ちます。エージェントが頻繁にコンテキスト上限に近づく場合は、これをオンにしてください。

23

注目すべき点：あるサブエージェントが他よりも5倍多くのトークンを使用している（プロンプトが長すぎる）、1回のセッションでツールが20回呼び出されている（エージェントがループしている）、Sonnetで処理できるタスクにOpusが使用されている（

{ “tasks”: { “summarize”: { “model”: “openai/gpt-4o-mini” }, “classify”: { “model”: “openai/gpt-4o-mini” }, “translate”: { “model”:

25. 機密データはローカルモデルを経由

{
  "mcpServers": {
    "local-llm": {
      "model": "ollama/qwen2.5",
      "baseUrl": "http://localhost:11434"
    }
  }
}

財務記録、従業員データ、内部文書など、ネットワーク外部に出すべきではないものはすべてOllamaに送られます。Qwen2.5はローカルハードウェアで良好に動作し（0.5Bから72Bまでの複数のサイズオプションあり）、128Kの

デバッグとセキュリティ {#chapter-5}

26. 何よりもまず詳細ログ

openclaw debug --verbose
/subagents log <runId>

詳細ログには、すべてのツール呼び出し、すべてのルーティング決定、そして各ステップでの完全なコンテキストが表示されます。十中八九、ログを見た瞬間に問題は明らかになります — エージェントが存在しないツールを呼び出そうとした、リトライループに陥った、あるいは必要な情報を含まないプロンプトで作業していた、などです。

何が起こったかを読めるのですから、仮説でデバッグするのはやめましょう。

27. タイムアウトと失敗は見た目が異なる — 異なる方法で対処する

/subagents list

何かをする前にstatus

それぞれに異なる修正が必要です。タイムアウトを失敗として扱うと、見当違いの方向に進んでしまいます。

28. clawdefenderでインストール済みのスキルをスキャンする

clawdefender scan --all

ClawHavocの後、これは新しい

スキルが失敗した場合はアンインストールし、より安全性の高い代替スキルを探してください。認証情報を抜き取ろうとするスキルを「部分的に信頼する」安全な方法はありません。

29. OAuthスコープ：必要なものだけを要求する

付与するすべてのスコープは、スキルが侵害された場合に悪用される可能性があります：

要求すべきでない	代わりに要求すべき
`calendar:*`	`calendar:read`
`email:*`	`email:send`
`files:readwrite`	`files:read`
`contacts:*`	`contacts:read`

カレンダーを読み取るスキルに、書き込みアクセスは必要ありません。メールの下書きを作成するスキルに、メッセージを削除する権限は必要ありません。スキルの説明で約束されている内容を超えるスコープのリクエストは、承認する前に調査すべき危険信号です。

30. TinyClawでは、これらすべてが事前設定されています

このガイドで説明した設定 — タイムアウト設定、cleanupポリシー、モデルのルーティング、セキュリティのデフォルト — は、すでにTinyClawに組み込まれています。セットアップを省略し、1分未満で本番環境対応のインスタンスを起動したい場合は、こちらをご利用

このすべてをスキップ：TinyClaw {#tinyclaw}

手順を知っていれば、OpenClawの手動セットアップには約1時間かかります：

手順	時間
サーバーのプロビジョニング	15分

TinyClawでは、この手順を完全にスキップします。サーバーはあらかじめ準備され、環境も設定済みです。あなたが選ぶのは、次の3つだけです。

モデル: Claude Opus 4.6、GPT-5.2、またはGemini 3.1 Pro

チャネル: Telegram、Discord、またはWhatsApp

アカウント: Googleでサインイン。

手順はこれだけです。1分もかかりません。

この後すぐにできること:

メールの読み込みと要約、返信の下書き作成
会議のリマインダーとスケジュールの競合検出
領収書からの経費追跡
競合他社の調査、見込み客のスクリーニング
スタンドアップの要約、OKRの追跡
契約書、職務記述書、SNS投稿のドラフト作成
価格比較、クーポンの検索

その他、一文で説明できることなら何でも。サーバースロットには限りがあります — tinyclaw.devで空き状況をご確認ください。

クイックリファレンス

章	ヒント	読むタイミング
設定	01–08	設定を触る前に
スキル	09–14	何かをインストールする前に
サブエージェント	15–20	マルチエージェントのワークフローを構築する前に
コスト	21–25	最初の実際のワークロードの後で
デバッグとセキュリティ	26–30	何かが壊れたときに

リソース

docs.openclaw.ai — 公式ドキュメント
clawhub.ai — キュレーションされたスキル、安全性監査済み
agentskills.io — より幅広いカタログ、ロングテール
tinyclaw.dev — ワンクリックデプロイ
agentputer.com — 24時間365日対応のクラウドホスティング

出典: OpenClaw docs (docs.openclaw.ai) · ClawHub 安全性データ (2026年2月) · Anthropic モデルドキュメント (docs.anthropic.com) · context7 docs (context7.com)

OpenClaw パワーユーザーガイド：誰も教えてくれない30のコツ

OpenClaw パワーユーザーガイド：誰も教えてくれない30のヒント

目次

設定の基本 {#chapter-1}

01. AGENTS.md vs SOUL.md: サブエージェントが実際に参照する場所

05. `runTimeoutSeconds`のデフォルト値は0

06. cleanupのデフォルトは “keep” — これを変更しましょう

スキルの選択と使用 {#chapter-2}

09. 安全性スコアは飾りではない

10. 自己改善：時間の経過とともにより賢くなる唯一のスキル

できること

利用シーン

私の動作方法

14. proactive-agent + Cron: 「自律的」が実際に意味するもの

実際にこれを必要とする唯一のタスクのためのオーバーライド

コスト管理 {#chapter-4}

21. 自動モデルルーティングのためにsave-moneyをインストール

23

25. 機密データはローカルモデルを経由

デバッグとセキュリティ {#chapter-5}

26. 何よりもまず詳細ログ

27. タイムアウトと失敗は見た目が異なる — 異なる方法で対処する

28. clawdefenderでインストール済みのスキルをスキャンする

29. OAuthスコープ：必要なものだけを要求する

30. TinyClawでは、これらすべてが事前設定されています

このすべてをスキップ：TinyClaw {#tinyclaw}

クイックリファレンス

リソース

OpenClaw パワーユーザーガイド：誰も教えてくれない30のヒント

目次

設定の基本 {#chapter-1}

01. AGENTS.md vs SOUL.md: サブエージェントが実際に参照する場所

05. runTimeoutSecondsのデフォルト値は0

06. cleanupのデフォルトは “keep” — これを変更しましょう

スキルの選択と使用 {#chapter-2}

09. 安全性スコアは飾りではない

10. 自己改善：時間の経過とともにより賢くなる唯一のスキル

できること

利用シーン

私の動作方法

14. proactive-agent + Cron: 「自律的」が実際に意味するもの

実際にこれを必要とする唯一のタスクのためのオーバーライド

コスト管理 {#chapter-4}

21. 自動モデルルーティングのためにsave-moneyをインストール

23

25. 機密データはローカルモデルを経由

デバッグとセキュリティ {#chapter-5}

26. 何よりもまず詳細ログ

27. タイムアウトと失敗は見た目が異なる — 異なる方法で対処する

28. clawdefenderでインストール済みのスキルをスキャンする

29. OAuthスコープ：必要なものだけを要求する

30. TinyClawでは、これらすべてが事前設定されています

このすべてをスキップ：TinyClaw {#tinyclaw}

クイックリファレンス

リソース

05. `runTimeoutSeconds`のデフォルト値は0