openclaw claws
Claw は、新しい OpenClaw エージェント 1 つのためのバージョン管理されたセットアップです。
エージェントのポータブルなアイデンティティ、ワークスペースファイル、Skills、Plugin、MCP サーバー、
Cron ジョブを記述できます。ハーネス固有のエージェント設定は、参照される
パッケージプロファイルに含めることができます。Claw は既存のエージェントを置き換えたり変更したりしません。
Claw は試験的機能です。そのスキーマ、コマンド出力、ライフサイクルは変更される可能性があります。
コマンドサーフェスを明示的に有効化してください。
CLAW.md、またはグループ化された JSON マニフェストを読み取ります。
ClawHub を介した Claw 全体の公開、検索、インストールは
別のレジストリトラックであり、まだこのコマンドサーフェスには含まれていません。
Claw パッケージを作成する
パッケージには、package.json、CLAW.md マニフェスト、およびそのマニフェストから参照される
プロファイルやワークスペースサイドカーが含まれます。
CLAW.md は YAML フロントマターで始まります。その Markdown 本文は、人向けに Claw を説明するものであり、
エージェント設定の一部ではありません。
metadata は、ポータブルなコンシューマーヒントのための文字列から文字列へのマップです。OpenClaw の
openclaw.config キーは、任意のパッケージ相対 YAML プロファイルを指します。
エクスポートされるデフォルトは profiles/openclaw.yml です。このポインターが規範となるため、
パッケージは別の安全な相対 .yml または .yaml パスを選択できます。
metadata.openclaw.config ポインターを使用します。このページの残りのスキーマ断片では JSON を使用しますが、
CLAW.md フロントマターでも同等のキーを使用できます。
OpenClaw パッケージプロファイルは、実行中の OpenClaw バージョンに登録されている任意の組み込みツールプロファイルを選択し、
alsoAllow、deny、tools.fs.workspaceOnly: true で調整できます。
Claw はこのフィールドを false に設定して、ホストファイルシステムの制限を弱めることはできません。
tools.allow は明示的な許可リストとして引き続き使用できますが、alsoAllow と組み合わせることはできません。
Claw は memory.search.enabled も設定でき、ポータブルな memory および sessions ソースを選択し、
rememberAcrossConversations により会話をまたぐメモリをオプトインできます。
sessions ソースを宣言するには、そのオプトインが必要です。
ホストポリシーは引き続きこれらの設定を制約し、Claw にカスタムプロファイル定義、プロバイダー、
認証情報、バインディング、ローカルメモリパスを含めることはできません。
参照されるプロファイルは 256 KiB 以下で、JSON 互換の YAML でなければならず、
エイリアス、アンカー、タグ、マージキーを使用できません。また、パッケージ内の通常ファイルであり、
シンボリックリンクやハードリンクであってはなりません。
パッケージおよびワークスペースのパスは、パッケージルート内に収める必要があります。マニフェストは
1 MiB、パッケージメタデータは 256 KiB に制限され、ワークスペースソースには
ファイルごとおよび合計の個別制限が適用されます。ワークスペースソースは、シンボリックリンクされた
親ディレクトリも拒否します。
ワークスペースファイルはパスで宣言され、パッケージサイドカーから読み取られます。SOUL.md などの
ブートストラップファイルには名前付きエントリを使用し、追加ファイルにはパッケージ相対の
ソースとワークスペース相対のターゲットを使用します。
mcp.servers 設定モデルを使用します。
検査とプレビュー
ローカル変更を計画せずにソースを検証します。planIntegrity
ダイジェストを報告します。機能レコードには、パッケージ、MCP、スケジュールされた作業、サンドボックス、
ツール、または Heartbeat への正確な影響が示されます。エージェントを作成する前にプランを確認してください。
--yes だけでは不十分です。OpenClaw はプランを再構築し、プレビュー後にソース、
宛先、または稼働中の設定が変更された場合は、同意を拒否します。パッケージのデフォルトが
ローカル状態と競合する場合、プレビューと適用の両方で --agent-id または
--workspace を使用してください。一時的なプロファイルや並列検証では、
明示的な --workspace を渡してください。OPENCLAW_STATE_DIR はランタイム状態を移動しますが、
デフォルトのワークスペース位置は変更しません。
Claw を追加すると、新しいエージェントとワークスペース設定が作成され、宣言された
ワークスペースファイルが書き込まれ、宣言された Skills および Plugin アーティファクトが
インストールまたは再利用され、パッケージ、MCP、Cron のプロベナンスが記録されます。
既存のファイルは上書きされず、所有対象の内容にドリフトがある場合、再試行は安全側に失敗します。
インストール済み状態を検査する
status は、インストール済みのエージェントと、記録されたワークスペース、パッケージ、MCP、
Cron のプロベナンスを現在の状態と比較します。ローカル状態を変更せずに、不完全なインストール、
欠落したリソース、ドリフトを報告します。openclaw doctor は、不完全な所有権レコード、
安全でない管理対象ファイル、稼働中の Gateway インベントリで裏付けられない Cron ジョブについて、
Claw 固有の診断を追加します。
Claw のプロベナンスは、次の 2 つの関係を区別します。
- 管理対象: Claw がそのリソースを導入し、現在管理しています。変更されておらず、 競合する所有者が残っていない場合は、クリーンアップ候補になります。
- 参照対象: リソースは独立して存在していたか、共有されています。削除時には この Claw の参照を解放し、デフォルトではリソースを保持します。
インストール済みの Claw を更新する
デフォルトでは、更新時に Claw の追加時に記録されたソースを使用します。そのソースが移動した場合や、 別のパッケージディレクトリをテストする場合は、--from を使用します。
! 行が含まれます。
解決されたパッケージ整合性、インストール識別情報、信頼性に関する警告も含まれます。
パッケージ宣言を削除すると、更新中にアーティファクトをアンインストールすることなく、
この Claw のエッジが解放されます。最終的な正確な planIntegrity 確認は、
通常の内容変更に加えて、開示されたその集合にも紐づきます。ホストは同じレコードを、
個別のダイアログや複数エージェントの集約レビューに使用できます。
明示的な同意により、レビュー済みの正確なプランを適用します。
status: partial とともにエラーコード update_partial を報告し、
不確実なプロベナンスを保持して停止します。claws status、影響を受けたリソース、
openclaw doctor を検査し、その後、再試行または何かを削除する前にもう一度プレビューしてください。
インストール済みの Claw を削除する
クリーンアップを選択する前に削除をプレビューします。--yes によって
その範囲が拡張されることはありません。グローバルにインストールされた Plugin は、
この Claw の参照が解放されても保持されます。プロセス全体の Plugin をアンインストールする場合は、
通常の Plugin ライフサイクルを別途使用してください。
他に現在の所有者がいない、変更されていない Claw 導入の参照を削除するには、
プレビューと適用の両方に --remove-unused を含めます。代わりに特定の参照リソースを
選択するには、--remove-referenced を繰り返し指定します。
--force-referenced を使用してください。これにより、それらの競合があっても選択した
クリーンアップが可能になりますが、プラン整合性への同意は省略されません。
インストール済みエージェントをエクスポートする
エクスポートは新しいパッケージディレクトリを作成し、出力先がすでに存在する場合や 管理対象の状態にドリフトがある場合は失敗します。package.json、正規の CLAW.md、および管理対象ワークスペースの
サイドカーが含まれます。これはインスタンス全体のバックアップではなく、移植可能な Claw パッケージです。無関係な
エージェント、認証情報、セッション、および所有対象外のローカル状態は除外されます。
コマンドリファレンス
試験的な機械可読出力には
--json を使用します。