mcpField
O
openclaw

openclaw

github.com/itechmeatエージェントワークフロー2457 回インストール6 日前に更新
リポジトリ

openclaw について

openclawは、OpenClawの導入・運用担当者向けの運用ガイドスキルです。ゲートウェイ設定、セキュリティ、チャネル、エージェント、トラブルシューティングをまとめ、MCPサーバー対応を含む変更も記録します。

主な機能

  1. 01インストールと移行の案内
  2. 02ゲートウェイ設定とセキュリティ対策
  3. 03マルチエージェントのルーティングとチャネル運用
  4. 04コマンドラインでのトラブルシューティング
  5. 05MCPサーバー関連の変更を含むリリース情報

活用シーン

  1. 01OpenClawの導入や移行の準備
  2. 02ゲートウェイの稼働確認と設定変更
  3. 03リモートアクセスとゲートウェイの安全性確認
  4. 04リリースごとの運用変更の把握

MCP 対応

`mcp.servers`によるリモートMCPサーバーの設定を説明し、HTTP/SSE URL、認証ヘッダー、トランスポート、タイムアウトを扱います。MCPツールの統合とセキュリティ境界にも触れています。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/itechmeat/llm-code --skill openclaw

インストール後、Claude Code で/openclawを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
architecture.md
channels-and-providers.md
concepts.md
configuration.md
gateway.md
getting-started.md
installation.md
nodes.md
operations.md
tools.md

詳細

OpenClaw（オペレータープレイブック）

このスキルは単独で利用でき、このファイルに運用ドキュメントが直接含まれています。

リンク

クイックナビゲーション

  • インストール／移行：references/installation.md
  • 設定モデルとワークスペースのブートストラップ：references/configuration.md
  • アーキテクチャとマルチエージェントルーティング：references/architecture.md
  • 拡張概念：references/concepts.md
  • ツールのガバナンスと安全性：references/tools.md
  • ゲートウェイの運用手順とセキュリティ：references/gateway.md
  • オンボーディングと初回実行：references/getting-started.md
  • チャネルとプロバイダー：references/channels-and-providers.md
  • ノードとリモート実行：references/nodes.md
  • CLI の操作とトラブルシューティング：references/operations.md

コアモデル

  • OpenClaw はゲートウェイを中心に構成されています。ホストごとに 1 つの長時間稼働するゲートウェイがコントロールプレーンになります。
  • クライアントとノードは、型付き WebSocket API 経由で接続されます。チャネル／プロバイダーはゲートウェイによってオーケストレーションされます。
  • セッションの安全性は、決定的なルーティングとキューイング、明示的なポリシー制御に左右されます。

初日のセットアップ

  1. デーモンをインストールしてオンボーディングを実行します。
  2. 有効な設定パスを確認し、最初に編集する前に設定を検証します。
  3. ゲートウェイの健全性／ステータスを確認します。
  4. 最初のチャットを行うため、Control UI／ダッシュボードを開きます。
  5. ベースラインの健全性が安定してから、チャネル／プロバイダーを追加します。

OpenClaw がインストールされていない場合は、references/installation.md を参照してください。

ゲートウェイの運用

  • デフォルトの設定では、ループバックと認証を有効にしてください。
  • リモートアクセスには、パブリックバインドではなく Tailscale Serve または SSH トンネルを優先してください。
  • ループバック以外へのバインドには、厳格なトークン／パスワード制御が必要です。
  • 信頼性を高めるため、監視付きプロセスモード（launchd/systemd）を使用してください。
  • 設定変更では、config.apply を管理されたロールアウトとして、config.patch を対象を絞ったマージとして扱ってください。
  • パッチのセマンティクスを覚えておいてください。オブジェクトはマージされ、配列は置き換えられ、null は削除されます。
  • 再起動が必要となる境界を明確に扱ってください。チャネル／エージェント／メッセージ／ツールはホット適用されることが多い一方、バインド／ポートなどのゲートウェイインフラ設定には、通常 openclaw gateway restart が必要です。

リリース更新（v2026.3.11-v2026.3.13）

  • セキュリティ： ブラウザーから開始された WebSocket 接続では、trusted-proxy モードでもオリジン検証が適用されるようになりました。ブラウザークライアントは承認済みオリジンのみで使用し、プロキシヘッダーを回避手段として扱わないでください。
  • 重大な変更： 分離された cron 配信の制約が厳しくなりました。アップグレード後に openclaw doctor --fix を使用して、従来の cron ストレージと従来の通知／Webhook メタデータを移行してください。
  • ゲートウェイ／オンボーディング：リモートの macOS オンボーディングで、共有ゲートウェイ認証トークンが必要な場合にそれを検出し、ゲートウェイホストでの取得方法を説明するようになりました。
  • ゲートウェイ／Control UI：トークン認証を使用するダッシュボードセッションでは、認証情報が長期間保持されるローカルストレージではなく、セッション単位のブラウザーストレージに保存されるようになりました。同じタブでの再読み込みでは維持されるはずですが、ブラウザーの再起動後も認証が保持されるものとして扱わないでください。
  • ゲートウェイの到達可能性：スコープが制限されたプローブ RPC は、完全に正常な状態ではなく、到達可能性の低下を報告するようになりました。インシデントのトリアージ時には、このシグナルを使用してください。
  • チャネル：Slack にオプトイン方式のインタラクティブな返信ディレクティブが追加されました。Telegram では、受信メディアの取得時に IPv4 の再試行フォールバックが追加されました。
  • プラグイン／ツール：プラグインのチャネル／バインディングの競合は、実行時に曖昧な動作を引き起こす代わりに、即座にエラーとなるようになりました。
  • ノード：ゲートウェイは、休止中のノードへの保留中の作業配信の基盤として、node.pending.enqueue／node.pending.drain プリミティブを公開するようになりました。

リリース更新（v2026.3.14–v2026.3.28）

  • MCP リモートサーバー：mcp.servers が、認証ヘッダーとより安全な認証情報の秘匿化に対応したリモート HTTP/SSE URL をサポートするようになりました。バンドルされた MCP ツールではプロバイダーセーフな名前（serverName__toolName）を使用し、streamable-http トランスポート、サーバーごとの接続タイムアウト、中断されたターンのツール結果の保持に対応しました。
  • プラグインの before_install フック：外部セキュリティスキャナー向けに、出所情報、組み込みスキャンのステータス、インストール先のメタデータを含む構造化リクエストに対応しました。緊急時の上書きオプションとして --dangerously-force-unsafe-install を追加しました。危険なコードの検出結果が critical の場合、上書きが設定されていない限り、ゲートウェイ経由のスキル依存関係のインストールがブロックされます。
  • バックグラウンドタスク → 統合コントロールプレーン：ACP、サブエージェント、cron、バックグラウンド CLI を、監査・メンテナンス・ステータスの確認、自動クリーンアップ、実行失敗からの復旧に対応する、SQLite ベースの単一台帳に統合しました。
  • ClawFlow：最初の線形フロー制御インターフェースとして、openclaw flows list|show|cancel を追加しました。複数タスクのフローは、単一タスクの自動同期フローと分離されています。孤立したフローとタスクの関連付けに対する Doctor の復旧ヒントも追加しました。
  • メモリー/QMD：エージェント間検索のための memorySearch.qmd.extraCollections、CJK に対応したチャンクサイズ調整、リセット済み／削除済みのトランスクリプトを含むセッションインデクサー、mcporter ツールで上書きする memory.qmd.searchTool に対応しました。
  • WhatsApp のリアクション：エージェントが受信した WhatsApp メッセージに絵文字でリアクションできるようになりました。
  • Matrix：グループトリガーのルーム履歴コンテキスト用に channels.matrix.historyLimit、DM ごとの threadReplies オーバーライド、channels.matrix.proxy によるプロキシ設定に対応しました。
  • Slack：承認者の認証に対応した、ネイティブ Slack exec 承認ルーティングを追加しました。
  • LINE：LINE 固有の配信経路で、画像・動画・音声の送信に対応しました。
  • Android：パッケージフィルタリング、サイレント時間帯、レート制限に対応した通知転送制御を追加しました。
  • エージェント/LLM：組み込みランナーのアイドルストリームタイムアウトを設定できるようになりました。text.verbosity が Responses の HTTP/WebSocket トランスポート全体で転送されるようになりました。
  • セキュリティ：Nostr の受信 DM の署名検証、LINE Webhook のタイミングセーフな HMAC 比較、サンドボックスブラウザーの CJK フォント、ゲートウェイ認証の強化（オリジン検証、ローカル直接アクセス時のトークン適用）を実施しました。

リリース更新（v2026.5.12）

  • 軽量化されたインストール：Slack、WhatsApp、Amazon Bedrock、Anthropic Vertex、および関連プロバイダー／プラグインの依存関係をコアランタイムから切り離し、実際に使用するものだけがインストールされるようになりました。
  • Telegram の信頼性向上：分離されたポーリング、永続的なローカルスプール、安全性を高めたグループメディア処理、HTML/Markdown 形式の保持により、デフォルトのチャネル経路での運用信頼性が向上しました。
  • Codex/OpenAI/メディア：認証プロファイルを利用するメディアツール、MCP サーバーの投影、コンテキストエンジンのスレッドローテーション、ランタイムのフォールバック動作を強化しました。
  • 運用/セキュリティ/UI：プラグインのインストール／更新フロー、pnpm 11 の処理、ゲートウェイ／ブラウザー／サンドボックス／ノードペアリングの強化、Control UI/WebChat の返信配信を大幅に改善しました。
  • ACP のフォールバック：ACP のターンでは出力を行う前に設定済みの代替ランタイムバックエンドを試せるようになり、機能が低下した状態でも適切に動作を継続できるようになりました。

リリース更新（v2026.5.22）

  • 議事録プラグイン：ソースのみの外部議事録経路が追加され、自動開始の録音設定、トランスクリプトの手動インポート、読み取り専用の openclaw meeting-notes CLI アクセスが利用できるようになりました。最初のライブソースは Discord 音声です。
  • ゲートウェイの準備状況：起動時に、アイドル状態のプラグイン処理、コアハンドラーツリー、組み込みの ACPX ランタイムを遅延読み込みするようになりました。これにより、ヘルスチェックと準備状況チェックが未使用のサブシステムを待たなくなりました。
  • プラグインメタデータのキャッシュ：変更不能なプラグインメタデータのスナップショットを起動時、設定時、シークレット読み取り時に再利用するようになり、処理中にマニフェストやファイルの状態を繰り返し確認する負荷が軽減されました。
  • チャネル／ランタイムの調整：チャネルカタログの読み取りを再利用するようになりました。Signal に configPath が追加され、Telegram ではワイルドカードのトピック既定値が利用可能になり、バックアップアーカイブ名にはローカル時刻が使われます。
  • メディア品質の制御：モデルを考慮した画像圧縮が agents.defaults.imageQuality に従うようになりました。これにより、運用者はトークン効率重視、バランス重視、または高詳細の処理を明示的に選択できます。
  • プラグイン SDK の移行：行単位のセッションワークフローヘルパーが追加され、loadSessionStore は非推奨になりました。プラグインのメンテナンスでは、ストア全体へのセッションアクセスを避けるよう移行してください。
  • プロバイダー認証の再利用：xAI OAuth 認証プロファイルを Grok の web_search で利用できるようになりました。また、プロバイダー側のメディア処理における既定のタイムアウト動作がより明確になりました。

リリース更新（v2026.5.29-v2026.6.6）

  • セキュリティ：トランスクリプト、サンドボックスのバインド、ホスト環境変数の継承、MCP stdio、Codex HTTP アクセスの境界を強化しました。実行承認がタイムアウトした場合は安全側に失敗するようになりました。Feishu がプロンプト前置文のランタイムコンテキストを返信に漏らさなくなり、WebSocket ペイロードの処理を強化しました。Skill Workshop では、メタデータのコミット前にシンボリックリンクへの書き込みを検証します。
  • チャネル：Telegram でアカウント単位のトピックを正しくルーティングし、ツール呼び出し中にテキストをストリーミングし、汎用の受信経路で /compact を利用できるようになりました。また、認証されていない DM のテキストをキャッシュとプロンプトから除外します。iMessage では、常時有効な受信側の再起動、永続的なエコーマーカー、ブロック単位のストリーミング、アイドル時の承認検出、起動時の診断が追加されました。
  • プロバイダー／モデル：ツール呼び出し ID の修復と推論再生の修正を含む Kimi K2.7 Code、適応型思考機能を備えた Claude Fable 5、より堅牢な Mistral スキーマ処理、マニフェスト由来の Fireworks カタログパラメーター、修正された Anthropic の思考再生、Vertex／ADC のカタログ復旧に対応しました。
  • MCP／ブラウザー：既存のセッションでの Chrome DevTools Protocol サポート、WebSocket 検出の検証、ストリーミング可能な HTTP ループバックトランスポート、より安全なブラウザー出力の境界を追加しました。また、MCP のツール結果について、マテリアライズ境界で resource_link／resource／audio／不正な画像を適切な型に変換します。
  • プラグイン：npm の公開を信頼済みの経路に移し、ClawHub の公開を分離しました。プラグインのバージョンずれを運用者に報告し、管理対象のインストールでは信頼済みの整合性ピンを保持します。また、プレリリースへのフォールバック時の整合性チェックで、古い引き継ぎデータを回避します。
  • UI／パフォーマンス：モデルメタデータのキャッシュと起動時のカタログ待ちの削除により、Control UI のレイテンシーを削減しました。スラッシュコマンドの遅延読み込み、初回イベントのトレースと返信遅延の診断、アクセシビリティの修正を追加し、チャットセッションを開く前にユーザーの明示的な意図を必須にしました。

リリース更新（v2026.5.27-v2026.5.28）

  • ランタイムの復旧：Codex/app-server とサブエージェントの経路で、ワークスペースと cwd の分離を維持し、ワークスペースメモリをツール経由でルーティングし、ネイティブフックのリレー世代を再起動後も維持し、タイムアウトによる中断時にセッションロックを解放し、古い再起動後の処理の継続を防ぎます。
  • セキュリティと入力境界：グループのプロンプトメタデータがシステムプロンプトに含まれないようにし、ドットが繰り返されるホスト名を正規化し、安全でないコマンドラッパーと Node の環境変数による上書きを拒否し、認証なしの Tailscale 経由の公開をブロックし、Teams のサービス URL を明示的に信頼し、不正な数値、ブラウザー、cron、メディア、スキーマ、Telegram コールバックの入力をより早い段階でエラーにします。
  • チャネルとモバイルの画面：Telegram の配信がより確実になり、Slack の最終返信が遅れて実行されるクリーンアップ後も保持され、Matrix/iMessage/Discord/WhatsApp/Teams の経路で ID と承認コンテキストがより慎重に維持され、iOS/WebChat/Talk の画面で再接続後もより多くの状態が保持されます。
  • プロバイダー／メディア対応：OpenAI 互換のエンベディングがコア機能となり、Pixverse の動画、DeepInfra のカタログ読み込み、Claude Opus 4.8、Fal Krea のスキーマ、NVIDIA のカタログ、MiniMax のストリーミング音楽、プロバイダーの音声カタログ、暗号化 PDF の抽出、GitHub Copilot のランタイム、Codex Supervisor のプラグイン対応が追加されました。
  • プラグインと作業の調整：ClawHub の表示／信頼関連画面、返信ペイロード送信フック、必要に応じてインストールする GitHub Copilot/Tokenjuice プラグイン、Workboard の調整ツールにより、カタログとキャッシュのより厳格な動作を維持しながら、プラグイン／オペレーターのワークフローが拡張されます。

リリース更新（v2026.4.15）

  • Anthropic／モデルのデフォルト設定：バンドル版の Anthropic デフォルト設定と opus エイリアスが、バンドル版の画像理解を含め、Claude Opus 4.7 を対象とするようになりました。
  • Google TTS：バンドル版の google プラグインで、音声選択、WAV 形式の返信、PCM テレフォニー出力に対応したテキスト読み上げを利用できるようになりました。
  • Control UI／ゲートウェイ：models.authStatus を基にしたモデル認証ステータスカードに、OAuth トークンの状態とプロバイダーのレート制限状況が表示されます。
  • メモリ：LanceDB でクラウドオブジェクトストレージを使用できるようになり、GitHub Copilot をメモリ検索のエンベディングプロバイダーとして利用できるようになりました。また、Dreaming のデフォルトストレージがインラインの日次メモリブロックではなく separate になりました。
  • エージェント／ツール：agents.defaults.experimental.localModelLean: true を設定すると、性能の低いローカルモデル向けに、既定の重量級ツールを削減します。未知のツールによるループを防ぐガードが既定で有効になり、skills.* 設定の書き込み時にスキルスナップショットをより厳格に無効化します。
  • セキュリティ強化：組み込みツール名との衝突を拒否し、/mcp 認証でブラウザーのオリジン確認を伴う定時間比較を使用し、シークレットの再読み込み後に HTTP Bearer のローテーションを即時適用し、WebChat／メディアの経路でローカルルート／ファイルの制限を強化します。

リリース更新（v2026.3.13-1）

  • 壊れた v2026.3.13 のリリース経路を復旧するための Git タグです。npm／ランタイムのバージョンは引き続き 2026.3.13 です。
  • ゲートウェイ／UI：control-ui の接続失敗をより明確に分類し、互換性を意図した経路で insecure-control-ui の共有認証動作を復元しました。
  • 運用：コンパクション後の健全性チェックでセッション全体のトークン数を確認するようになり、インシデントのトリアージ中にコンパクションのリグレッションを検出しやすくなりました。
  • セッション／チャネル：セッションのリセット後も lastAccountId と lastThreadId が維持されます。Telegram の受信メディアの再試行では、IPv4 フォールバック動作が維持されます。
  • ランタイム／プラットフォーム：Docker に OPENCLAW_TZ を追加しました。到達性が低下した際に、ゲートウェイのプローブ処理と未応答のクライアントリクエストの制限が、オペレーターにより把握しやすくなりました。

リリース更新（v2026.3.7）

  • 破壊的変更： gateway.auth.token と gateway.auth.password の両方が設定されている場合（SecretRefs を含む）、ゲートウェイ認証で gateway.auth.mode（token または password）の明示が必須になりました。起動やペアリングの失敗を避けるため、アップグレード前に設定してください。
  • エージェント：ライフサイクル全体のフック（bootstrap、ingest、assemble、compact、afterTurn、prepareSubagentSpawn、onSubagentEnded）を備えた ContextEngine プラグインインターフェースを追加しました。コアのコンパクションを変更せずに、代替のコンテキスト管理戦略（例：lossless-claw）を利用できます。
  • エージェント：コンパクション後に再挿入する AGENTS.md のセクションを選択できる postCompactionSections を設定できるようになりました。
  • エージェント：サイズの大きすぎるツール結果を先頭と末尾から切り詰めるようになりました（末尾の診断情報は保持されます）。
  • Telegram：フォーラムグループと DM トピックで、トピックごとの agentId オーバーライドに対応しました。専用エージェントへのルーティングとセッションの分離が可能です。
  • Telegram/ACP：永続的なトピックバインディング（--thread here|auto）、プレフィックス付き ID の解決に対応した承認ボタン、バインドのピン留め確認に対応しました。
  • ACP：Discord チャンネルと Telegram トピックの永続的なバインディング保存に対応しました。再起動後も保持されます。
  • プラグイン：システムプロンプト領域に静的なガイダンスを追加する prependSystemContext／appendSystemContext に対応しました（プロバイダーのキャッシュを利用し、繰り返し発生するコストを削減します）。
  • プラグイン：hooks.allowPromptInjection ポリシーと、未知のフック名に対する実行時検証に対応しました。
  • フック：セッションと件数のメタデータを含む session:compact:before／session:compact:after イベントを追加しました。
  • 設定：recentTurnsPreserve と品質ガードの再試行パラメーターを、検証済みの設定から指定できるようになりました。
  • ツール／ウェブ検索：Perplexity プロバイダーを Search API に切り替え、構造化された結果と、言語・地域・時間のフィルターに対応しました。
  • ツール／Diff：ガイダンスの配置をプロンプトフックへの注入から付属スキルのパスに変更し、無関係なターンに表示されるノイズを減らしました。
  • ゲートウェイ：認証モードのガードレールとともに、gateway.auth.token の SecretRef に対応しました。
  • Docker：最小限のランタイムイメージを生成するマルチステージビルドに対応しました。OPENCLAW_VARIANT=slim ビルド引数と、拡張機能の依存関係を事前に組み込む OPENCLAW_EXTENSIONS に対応しました。
  • TTS：OpenAI 互換エンドポイント向けの messages.tts.openai.baseUrl 設定に対応しました。
  • Google：gemini-3.1-flash-lite-preview を正式にサポートしました。
  • Slack：アシスタントの入力中表示が利用できない場合に DM の処理状況を示す typingReaction に対応しました。
  • Discord：メンションがある場合にボットのメッセージを許可する allowBots: "mentions" に対応しました。
  • Mattermost：インタラクティブな /oc_model によるプロバイダー／モデルの参照に対応しました。
  • Cron：復旧用に、編集前のスナップショットとして jobs.json.bak を保持するようになりました。

リリース更新（v2026.3.2）

  • 破壊的変更： 新規インストールでは、tools.profile のデフォルトが幅広いコーディング／システム向けではなく messaging になりました。初日からコーディングツールを使う場合は、tools.profile を明示的に設定してください。
  • 破壊的変更： ACP のディスパッチは、明示的に無効化（acp.dispatch.enabled=false）しない限り、有効がデフォルトになりました。
  • 破壊的変更： プラグイン SDK から api.registerHttpHandler(...) が削除されました。代わりに api.registerHttpRoute(...) を使用してください。
  • 破壊的変更： Zalo 個人用プラグイン（@openclaw/zalouser）は外部 CLI トランスポートを使用しなくなりました。アップグレード後、openclaw channels login --channel zalouser で再ログインしてください。
  • ユーザー指定の認証情報が関わる箇所で、Secrets／SecretRef の対応範囲を拡大しました。有効な箇所で解決できない参照がある場合、直ちにエラーになります。
  • ツール：ファーストクラスの pdf ツールを追加しました（Anthropic／Google のネイティブサポートとフォールバック抽出に対応し、上限を設定できます）。
  • CLI：ゲートウェイの起動前に設定を検証する openclaw config validate（および --json）を追加しました。
  • Telegram：新しいセットアップではストリーミングのデフォルトが partial になりました。DM のプレビューのストリーミング動作も更新しました。
  • メモリ：メモリ検索で Ollama による埋め込みに対応しました（memorySearch.provider/fallback = "ollama"）。
  • ツール／diff プラグイン：PDF 出力と diff アーティファクトのレンダリング品質制御に対応しました。

リリースアップデート（v2026.3.1）

  • ゲートウェイ：Docker／Kubernetes 向けに、組み込みコンテナープローブエンドポイント（/healthz、/readyz、およびエイリアスの/health、/ready）を追加しました。
  • CLI：openclaw config fileでアクティブな設定ファイルのパスを表示します（OPENCLAW_CONFIG_PATHまたはデフォルトのパスを解決します）。
  • Discord：スレッドに紐づくセッションのライフサイクルで、非アクティブ状態（idleHours）と最大存続時間（maxAgeHours）に対応し、/session idleと/session max-ageも追加しました。
  • Telegram：DM ごとのdirect設定と DM トピック設定に対応しました（トピックを考慮したポリシー、スキル、システムプロンプト、許可リスト）。
  • ノード（Android）：ノードツールの対応範囲を拡張しました（カメラ／デバイス／通知／写真／連絡先／カレンダー／モーション）。
  • ツール：読み取り専用の差分表示と PNG レンダリングに対応する、オプションのdiffsプラグインツールを追加しました。

リリースアップデート（v2026.2.23）

  • プロバイダー：kilocodeプロバイダーを正式にサポートしました（認証、オンボーディング、暗黙的なプロバイダー検出、モデルのデフォルト設定）。
  • ツール／web_search：プロバイダー"kimi"（Moonshot）を追加し、2 段階の$web_searchツールフローを修正しました（合成の前にツールの結果を出力）。
  • ゲートウェイ：HTTPS を直接デプロイする場合に、gateway.http.securityHeaders.strictTransportSecurityで HSTS を任意に有効化できます。
  • セッション：ディスク容量の制御と、より安全なトランスクリプト／アーカイブのクリーンアップを備えたopenclaw sessions cleanupで、メンテナンスを強化しました。
  • **破壊的変更：**ブラウザーの SSRF ポリシーのデフォルトを変更し、設定キーを改名しました（browser.ssrfPolicy.allowPrivateNetwork -> browser.ssrfPolicy.dangerouslyAllowPrivateNetwork）。移行するにはopenclaw doctor --fixを使用してください。

アーキテクチャとランタイムの概念

エージェントループ
  • エージェントループは、ツールと履歴の競合を避けるため、セッションごと（必要に応じてグローバル）に直列化されます。
  • 実行ライフサイクルでは、可観測性のためにアシスタント／ツール／ライフサイクルのストリームが出力されます。
  • 待機タイムアウトとランタイムタイムアウトは別々の制御項目です。
システムプロンプトとコンテキスト
  • システムプロンプトは実行ごとに OpenClaw が組み立てます（プロバイダーのデフォルトプロンプトではありません）。
  • プロンプトモードは実行コンテキストに応じて、full、minimal、noneのいずれかになります。
  • コンテキストには、システムプロンプト、トランスクリプト、ツール／結果、添付ファイル、スキーマが含まれます。
  • ブートストラップファイルはコンテキストウィンドウに挿入され、予算を消費します。
ワークスペースとメモリ
  • ワークスペースはデフォルトの実行ディレクトリであり、メモリの保存場所でもありますが、厳密なサンドボックスではありません。
  • 厳密なファイルシステム分離が必要な場合は、サンドボックス設定を使用してください。
  • メモリは Markdown を基本とし、日々のメモと、整理された長期保存用のメモリで構成されます。
  • 要約はコンパクションによってトランスクリプトに保存され、プルーニングによって古いツール結果がメモリ上から削除されます。
  • AGENTS.md、SOUL.md、USER.md、TOOLS.md、HEARTBEAT.md、IDENTITY.md、MEMORY.mdなどのブートストラップファイルはすべてコンテキスト予算を消費します。内容を吟味し、簡潔に保ってください。
メッセージング、キューイング、プレゼンス
  • メッセージ処理では、重複排除、任意の受信デバウンス、キューモード、チャネルに応じた配信を使用します。
  • キューイング／ストリーミング／チャンク化の動作はポリシーによって制御され、チャネルごとに調整できます。
  • プレゼンスはベストエフォートの可観測性機能です。重複した項目を避けるには、安定したinstanceIdが必要です。

ツールのガバナンス

  • 最小権限のプロファイルから始め、必要なツールを明示的に許可してください。
  • 拒否リストは許可リストより優先されます。
  • exec、sessions_*、gateway、nodesは影響の大きい機能として扱ってください。
  • メディアをキャプチャする操作には、ユーザーの明示的な同意を必須にしてください。
  • ツールが進展のない循環を形成する可能性がある場合は、ループ検出を有効にしてください。

チャネルとプロバイダーの戦略

  • 基準となる検証には、最も速く安定したチャネル経路（通常は Telegram）を使用してください。
  • WhatsApp や高度なチャネルは、ペアリングと許可リストが正常に動作することを確認してから追加してください。
  • provider/modelでプロバイダーを明示的に選択し、暗黙的なモデル変更を避けてください。
  • 仕事用と個人用のコンテキストを分離する場合は、エージェントごとに認証プロファイルを分けてください。

ノードとリモート実行

  • ノードは機能を実行するものであり、ゲートウェイの代替ではありません。
  • ノードを明示的にペアリングし、アクションを実行する前に機能を確認してください。
  • ノードのexec承認はノードホスト内で管理し、監査してください。
  • リモート実行先を確実に指定するには、ノードのバインドを明示してください。

セキュリティのベースライン

  • プロンプトインジェクションは常に起こり得るものとして想定してください。
  • 次の順序で制御を適用してください：ID（ペアリング／許可リスト）→ スコープ（ツール／サンドボックス／メンション）→ モデルポリシー。
  • 制御 UI はセキュアなコンテキスト（ループバック／HTTPS）で使用し、安全でない認証方式へのダウングレードは避けてください。
  • 設定／状態ファイルには厳格なファイルシステム権限を適用し、機密情報をログから削除してください。

トラブルシューティングの手順

  1. openclaw status
  2. openclaw gateway status
  3. openclaw logs --follow
  4. openclaw doctor
  5. openclaw channels status --probe

一般的なトリアージの対応表：

  • 応答がない → ペアリング／許可リスト／メンションポリシー。
  • 接続がループする → 認証モード＋エンドポイント＋セキュアなコンテキスト。
  • 起動に失敗する → モード／バインド／認証／ポートの競合。
  • ツールが失敗する → 権限／承認／フォアグラウンドの制約。

概念の URL ステータス（左側のナビゲーションから）

  • 抽出した概念は、このスキルに直接組み込まれています。
  • ドキュメントのナビゲーションにある一部のソース URL は、現在 404 または空のコンテンツを返します。
  • これらのページの内容は、代替ガイダンスとともに references/concepts.md にまとめています。

使用するタイミング

  • OpenClaw のデプロイを設計または運用する必要がある場合。
  • チャネル、プロバイダー、ツールを安全に接続する必要がある場合。
  • オンボーディングやゲートウェイのセットアップに実用的なチェックリストが必要な場合。

基本的な運用ワークフロー

  1. アーキテクチャのメモを確認し、トポロジーと責任範囲を把握します。
  2. 6 つの運用ブロック（gateway、agents、channels、bindings、session/messages、heartbeat/tools/cron/hooks）を中心に openclaw.json を構成します。
  3. チャネル／プロバイダーと必要なツールを選択します。
  4. ゲートウェイへのアクセス、シークレット、リモート接続を設定します。
  5. オンボーディングフロー、設定の健全性、制御 UI へのアクセス性を検証します。
  6. トラブルシューティングとセキュリティ強化のチェックリストを実施します。

重大な禁止事項

  • ベンダーのドキュメントから大きな文章をそのままこのスキルにコピーしないでください。
  • ドキュメント上の根拠がない限り、デフォルト値や隠れた挙動を推測して記述しないでください。
  • 本番環境で利便性のために安全制御（ペアリング、許可リスト、認証、サンドボックス）を弱めないでください。

リンク

主要なドキュメントページ：アーキテクチャ、ツール、ゲートウェイ

コメント

Markdown 対応