openclaw

openclaw

OpenClaw（龙虾）インスタンスの設定を管理する統合スキルです。

サブコマンド

python3 scripts/cli.py [audit|diff|copy|add-model|list|switch] [options]

各サブコマンドは、たとえば python3 scripts/audit.py ... のように直接実行することもできます。

diff は compare のエイリアスです。

共通の動作

• デフォルト設定の検出：--config / --to を省略した場合、このスキルは次の場所を記載順に検索します。
  1. ~/workspace/.force/openclaw/openclaw.json
  2. ~/.kimi_openclaw/openclaw.json
  3. ~/.openclaw/openclaw.json
• Lobster のニックネーム：--config、--from、--to には、ファイルパスまたは lobsters.json に登録されたニックネームを指定できます（下記参照）。明示的にニックネームを指定するには、--from-lobster と --to-lobster も使用できます。
• バックアップ：書き込み操作の前に、設定を config-backups/<stem>-<utc-timestamp>.json にコピーします。このスキルは最新のバックアップを20件保持します。
• ドライラン：書き込みを行うサブコマンド（copy、add-model、switch）では、変更をプレビューするために --dry-run を指定できます。
• 再起動：書き込みを行うサブコマンドでは、保存後に OpenClaw ゲートウェイを再起動するために --restart を指定できます。
• 自動監査：copy、add-model、switch は、デフォルトで変更の前後に監査を実行します。省略するには --no-audit を使用します。

Lobster ニックネームのレジストリ

次のいずれかの場所に JSON ファイルを作成します。

• ~/workspace/.force/openclaw/lobsters.json
• ~/.kimi_openclaw/lobsters.json
• ~/.openclaw/lobsters.json

例：

{
  "甲虾": "/path/to/甲虾/openclaw.json",
  "乙虾": "/path/to/乙虾/openclaw.json"
}

その後、次のように使用します。

python3 scripts/cli.py copy gateway-provider --from 甲虾 --to 乙虾 --alias
python3 scripts/cli.py switch gateway-provider/deepseek-v4-pro --config 乙虾 --restart

---

audit — 設定を検証する

python3 scripts/cli.py audit [--config PATH|NICKNAME] [--json]

プロバイダー、モデル、デフォルトモデル、エイリアス、プラグインの整合性を確認します。

次の場合に使用します。

• 「このエビの設定を確認してください」
• 「openclaw.json を audit してください」
• パッチを適用する前、またはプロバイダーをコピーする前

---

diff — 2つの設定の意味的な差分を表示する

python3 scripts/cli.py diff LEFT.json RIGHT.json [--json] [--include-cost]

追加・削除・変更されたプロバイダー、モデル、デフォルトモデル、エイリアス、プラグインを報告します。デフォルトではコスト関連のフィールドを除外します。差分に含めるには --include-cost を使用します。

次の場合に使用します。

• 「甲のエビでは DeepSeek が使えるのに、乙のエビでは使えないのはなぜですか？」
• 「この2つの龍蝦の設定はどこが違いますか？」

---

copy — 設定間でプロバイダーをコピーする

python3 scripts/cli.py copy \
  --from SOURCE|NICKNAME [--to TARGET|NICKNAME] \
  provider-name [--model ID]... [--alias] [--restart] [--dry-run] [--no-audit]

ある設定から別の設定に、プロバイダー全体をコピーします。コピー先にそのプロバイダーがすでにある場合、モデルをマージし、baseUrl / api を更新しますが、コピー先にしかないモデルは削除しません。--alias を指定すると、そのプロバイダーを参照するエイリアスもコピーします。

次の場合に使用します。

• 「甲のエビの gateway プロバイダーを乙のエビにコピーしてください」
• 「このモデル設定を同期してください」

---

add-model — プロバイダーにモデルを追加する

python3 scripts/cli.py add-model provider model-id|model-json \
  [--config PATH|NICKNAME] [--from SOURCE|NICKNAME] [--alias NAME] \
  [--restart] [--dry-run] [--no-audit]

モデル定義とエイリアスをプロバイダーに追加します。プロバイダーが存在しない場合は、先に --from からコピーできます。

モデルの指定方法：

• モデル ID を渡し、同じプロバイダーにそのモデルが含まれている --from SOURCE を指定します。
• モデル定義を含む JSON ファイルのパスを渡します。

次の場合に使用します。

• 「このエビに DeepSeek を追加してください」
• 「甲のエビの DeepSeek 設定を乙のエビにコピーしてください」

正式な DeepSeek モデル定義は references/deepseek_model.json にあります。

重要な注意点

• 独立した deepseek プロバイダーを作成しないでください。 サポートされている方法は、モデル ID deepseek-v4-pro を使用する gateway プロバイダーです。
• モデル ID に [1m] を含めないでください。 接尾辞のない deepseek-v4-pro を使用してください。上流のゲートウェイがこれを1Mコンテキストのバリアントにマッピングします。
• コールド再起動が必要です。 新しいプロバイダーは、ホットリロードでは確実に読み込まれません。

---

list — プロバイダー、モデル、エイリアス、デフォルトを一覧表示する

python3 scripts/cli.py list [--config PATH|NICKNAME] [--json] [--validate]

デフォルトでは人が読みやすい形式で出力します。jq に渡す場合は --json を指定します。デフォルトモデルとエイリアスが解決できるか確認するには、--validate を追加します。

次の場合に使用します。

• 「このエビにはどんなモデルがありますか？」
• 「甲のエビで使えるモデルを一覧表示してください」
• 「デフォルトモデルを確認してください」

---

switch — デフォルトモデルを変更する

python3 scripts/cli.py switch provider/model-id \
  [--config PATH|NICKNAME] [--restart] [--dry-run] [--no-audit]

agents.defaults.model を変更する唯一のサブコマンドです。プロバイダーとモデルが存在することを検証し、設定をバックアップして、デフォルトを更新します。対象がすでにデフォルトの場合は、追加のバックアップを作成せずに終了します。

次の場合に使用します。

• 「デフォルトモデルを DeepSeek に切り替えてください」
• 「元のモデルに戻してください」

---

典型的なワークフロー

エビで DeepSeek を有効にする

python3 scripts/cli.py audit --config 乙虾
python3 scripts/cli.py add-model gateway-provider deepseek-v4-pro \
  --config 乙虾 --from 甲虾 --alias "DeepSeek V4 Pro"
python3 scripts/cli.py switch gateway-provider/deepseek-v4-pro --config 乙虾 --restart

動作する設定を新しいエビに複製する

python3 scripts/cli.py copy gateway-provider --from 甲虾 --to 乙虾 --alias --restart
python3 scripts/cli.py audit --config 乙虾

2つのエビの差分を表示する

python3 scripts/cli.py diff 甲虾 乙虾

参考資料

• references/openclaw_architecture.md — 設定スキーマと用語
• references/openclaw_operations.md — ゲートウェイのヘルス状態、プラグインのライフサイクル、 アップグレードの診断、修復が機能したと判断するための検証手順
• references/deepseek_patch_sop.md — DeepSeek パッチの標準作業手順書（サニタイズ済み）
• references/deepseek_model.json — add-model で読み込まれる DeepSeek モデルの正規定義
• references/lobster_registry.example.json — ロブスターのニックネームレジストリの例