DeepSeekとOpenClaw：セットアップ、モデルID、APIコスト

OpenClawは、別途インストールする公式プロバイダープラグイン — openclaw plugins install @openclaw/deepseek-provider — を通じてDeepSeekに接続します。プロバイダーIDはdeepseek、キーはDEEPSEEK_API_KEY、APIはOpenAI互換で、ベースURLはhttps://api.deepseek.comです。ベースURLには/v1を付けません。初回実行が成功するかどうかを左右する事実は2つあります。DeepSeekの現在のカタログにはdeepseek-flashとdeepseek-v4-proという2つのIDしかありません。以前のチュートリアルで使われているdeepseek-chatおよびdeepseek-reasonerという名前は、2026年7月24日に廃止されました。また、OpenClawのオンボーディングではdeepseek/deepseek-v4-proがデフォルトに設定されますが、これは現在の課金についてDeepSeek自身のページ間で見解が分かれているモデルです。

設定の前に、検索結果で混同されている点を区別しておきます。別のGitHub上のOpenClawは「オリジナルのCaptain Claw（1997年）のプラットフォームゲームをC++でマルチプラットフォーム再実装したもの」と説明されています。これはここには関係ありません。対象のエージェントはopenclaw.aiにあるプロジェクトで、ドキュメントはdocs.openclaw.aiにあります。documentation.openclaw.aiはそこへリダイレクトするだけなので、そのホストをリンクしてください。

両プロジェクトのドキュメントに沿ってインストールおよび設定する

# 1. Install the provider plugin — DeepSeek support is not bundled.
openclaw plugins install @openclaw/deepseek-provider

# 2. Interactive: prompts for the key, sets deepseek/deepseek-v4-pro as default.
openclaw onboard --auth-choice deepseek-api-key

# 2b. Or scripted, with the flags OpenClaw documents for a headless install.
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice deepseek-api-key \
  --deepseek-api-key "$DEEPSEEK_API_KEY" \
  --skip-health \
  --accept-risk

プラグインをインストールすれば、ベースURLを指定する必要はありません。プラグインが独自のカタログと互換性動作を提供します。最小構成は、JSON5でキーとモデルを指定するものです。

{
  env: { vars: { DEEPSEEK_API_KEY: "sk-..." } },
  agents: {
    defaults: {
      model: { primary: "deepseek/deepseek-v4-pro" },
    },
  },
}

OpenClawは、文書化された優先順位に従い、4種類の環境変数形式からプロバイダーキーを解決します。最優先の単一の実行時上書きとしてOPENCLAW_LIVE_DEEPSEEK_KEY、次にカンマまたはセミコロン区切りのリストとしてDEEPSEEK_API_KEYS、次に主要キーとしてDEEPSEEK_API_KEY、最後に番号付きのDEEPSEEK_API_KEY_*エントリです（Control UI and keys、2026年9月21日確認）。Control UIでSettings、次にModelsを開くと、ファイルを編集せずにキーを追加または置換でき、キーの内容は認証ストアに保存されます。サーバーインストールで注意すべきなのは表記ではなくスコープです。OpenClaw自身のページでは、Gatewayがlaunchdまたはsystemdのデーモンとして実行される場合、キーはそのプロセスから見える必要があり、たとえば~/.openclaw/.envまたはenv.shellEnvを介して設定すると説明されています。

実際に有効なDeepSeekモデルID

以下の行には、1つではなく3つの異なるステータスがあります。DeepSeekのlist-modelsリファレンスのサンプルレスポンスにはdeepseek-flashとdeepseek-v4-proという正確に2つのIDが示されていますが、OpenClawに組み込まれたカタログには依然として4つの参照があります。

2つの廃止に関する記述は矛盾しているように見えますが、実際には矛盾していないため、別々に扱ってください。OpenClawは、DeepSeekがdeepseek-chatとdeepseek-reasonerを廃止し、「これらのモデルIDにはアクセスできなくなった」と述べています。一方、DeepSeekは別途、「旧名称のdeepseek-v4-flashとdeepseek-v4-flash-vision-expは引き続き受け付けるが、対応するモデルは廃止された」と述べています。名称の組み合わせも結果も異なります。DeepSeekのModels & Pricingページでは、現在有効な両IDについてコンテキスト長を1M、最大出力を384Kとしており、OpenClawのカタログ表にも4つすべての参照に同じ1,000,000 / 384,000の組み合わせが記載されています。

未解決の問題です。DeepSeekの2026年9月10日の発表では、「V4-Proを段階的に廃止する」とし、「2026年9月14日04:00 UTC以降、すべてのdeepseek-v4-proリクエストはV4.1-Flashへルーティングされ、V4.1-Flashの料金で課金される」と述べています。一方、同じリリースの変更履歴では反対に、「ユーザーの要望に応えて、2026年9月14日以降もDeepSeek V4 ProのAPIサービスを継続し、課金方法は変更しないことを決定した」と述べています。Models & Pricingページには依然としてV4 Proが独自の高い料金で掲載され、廃止に関する通知はありません。どちらも2026年9月21日、問題の日付から1週間後に確認しました。このページから、どちらの料金が適用されるかを判断することはできません。オンボーディングのデフォルトをそのまま使用する前に、自分のDeepSeekアカウントで確認してください。なお、デフォルトはまさにこの争点となっているモデルです。

トークンの料金と、時間帯が価格の一部である理由

DeepSeekはピーク時とオフピーク時の料金を公開しており、オフピーク時はピーク時の半額です。時間帯は狭く、「ピーク時間は月曜日から金曜日の01:00〜04:00および06:00〜10:00 UTCで、中国の祝日を除く。その他の時間はすべてオフピークで、週末と中国の祝日は終日含まれる」とされています。平日の7時間だけがピークで、それ以外はすべてピークではありません。そのため、ピーク時を暗黙に前提とする見積もりは、通常の請求額を過大に見積もります。

2026年9月21日にDeepSeekのModels & Pricingページから読み取りました。Flashの行は、入力トークン100万あたり「$0.30、出力トークン100万あたり$1.20、キャッシュ済み入力トークン100万あたり$0.006」と記載するOpenClawのプロバイダーページによって独立に裏付けられています。V4 Proの行はModels & Pricingページだけに基づいており、上記の矛盾の影響を受けるため、確定事項ではなく引用値として扱ってください。

キャッシュ列はエージェントの請求額を左右する項目で、その比率は珍しいものです。deepseek-flashでのキャッシュヒットは100万あたり$0.006で、ミス時の$0.30に対しておよそ50分の1です。これは他社で一般的な10分の1の比率を大きく下回るため、別のベンダーの前提をそのまま適用しないでください。DeepSeekのキャッシュガイドでは、この機能は「コードを変更する必要なく、すべてのユーザーに対してデフォルトで有効」とされ、ヒットには完全一致するプレフィックスが必要で、未使用のキャッシュは「通常、数時間から数日以内」に消去されると説明されています。ヒットとミスはprompt_cache_hit_tokensおよびprompt_cache_miss_tokensのusageフィールドに返されます。DeepSeekはキャッシュ書き込み料金を公開しておらず、料金表にもキャッシュ書き込み列はありません。これは公開料金が存在しないという意味であり、書き込みが無料だという意味ではありません。

deepseek-flashについて、DeepSeekが公開している料金に基づく例示的なセッション。OpenClawの1回の実行で入力トークン600,000個を送信し、そのうち450,000個がプレフィックスキャッシュにヒット、150,000個がミスし、出力トークン40,000個を受け取るとします。ピーク時は$0.045＋$0.0027＋$0.048、つまり$0.096です。同じセッションはオフピーク時には$0.048になります。キャッシュヒットが一切ない同じ実行は、ピーク時に$0.228です。これらは提示した前提に基づくトークン計算であり、実測したタスク費用でも支出上限でもありません。最も重要な変数は自身のキャッシュヒット率です。OpenClawはローカル費用を推定値と説明し、課金についてはDeepSeekの料金ページを権威ある情報源として示しているため、OpenClawアプリ内の数値だけでは確定できません。

モデルの能力と、クライアントによるツールサポートは別の問題です

これは料金表からは分からない部分であり、手作業で作成したプロバイダーエントリではなくプラグインを使う実務上の理由です。DeepSeek V4の思考セッションでは、思考が有効なターンから再生されたassistantメッセージに、後続リクエスト用のreasoning_contentを含める必要があります。OpenClawのDeepSeekプラグインはこのフィールドを自動的に補完するため、マルチターンのツール利用は、「別のOpenAI互換プロバイダーから履歴が来た場合（ネイティブなreasoning_contentがない場合）や、通常のassistantメッセージから来た場合でも」、プロバイダーをセッション途中で切り替えた後に/newを実行する必要なく機能します。思考がオフの場合は、UIでNoneを選択した場合も含め、OpenClawはthinking: { type: "disabled" }を送信し、送信する履歴から再生されたreasoning_contentを削除します。またOpenClawは/think xhighと/think maxの両方を、DeepSeekの最大reasoning_effortにマッピングします。

DeepSeek互換エンドポイントを指す汎用のopenai-completionsカスタムプロバイダーでは、この補完は行われず、互換性ブロックを自分で宣言しない限りDeepSeekの思考形式も利用できません。OpenClawのds4ページには、thinkingFormat: "deepseek"およびsupportsReasoningEffortを含む形式が示されています。この差が、ツールのターンが一度は成功した後、後続ターンで失敗する通常の原因です。

DeepSeek側の2つの制限は、同じ判断の中で考慮する必要があります。厳格モードのツール呼び出しは別のベースURLであるhttps://api.deepseek.com/betaにあり、各関数に"strict": trueと"additionalProperties": falseを要求します。これはプラグインがデフォルトで向ける先ではありません。またDeepSeekのツール呼び出しガイドには、「Chat Completion APIは会話途中へのツール呼び出しの挿入をサポートしないが、会話途中へのsystemメッセージの挿入はサポートする。ツール呼び出しを挿入するにはAnthropic APIまたはResponses APIを使用する」とあります。これはOpenClawのプラグインが使用するエンドポイントの制限であり、モデルの制限ではありません。文書化された代替手段が2つあります。

モデルサポートについては、2つの情報源が一致しています。DeepSeekのModels & PricingページのFEATURES列では、Tool Calls、JSON Output、Responses API、Anthropic APIがdeepseek-flashとdeepseek-v4-proの両方でサポートされています。またvisionについては、deepseek-flashではサポートされ、deepseek-v4-proではサポートされないと区別されています。OpenClawは、4つすべての参照でマルチターンのツール利用が機能すると述べています。どちらの情報源も並列ツール呼び出しについては文書化していないため、この点はどちらとも回答されていない未解決事項です。

3つの手順で確認し、その後に名前を挙げるべき失敗を確認する

各層は異なる形で失敗するため、順番に確認してください。まずカタログです。openclaw models list --provider deepseek、または実行中のGatewayなしでプラグインの静的カタログを確認するopenclaw models list --all --provider deepseekを実行し、その後オンボーディングのデフォルトではなく、争いのないモデルを使用したい場合はopenclaw models set deepseek/deepseek-flashを実行します。次に、短い非ストリーミングプロンプトを1回、その後ストリーミングプロンプトを1回実行します。認証またはベースURLの問題が明確に現れるのはここです。3番目に、そして3番目にだけ、ツール呼び出しの後に同じセッションで2回目のターンを実行します。これは、上記で説明したreasoning_contentの再生を検証する唯一の手順です。

404の行には独自の文章を割く価値があります。これはドキュメントだけでは説明できないものだからです。DeepSeekのエラーコード表には400、401、402、422、429、500、503が記載されており、404はありません。そのため、ここでの404はDeepSeekについてではなく、ルーティングについての証拠です。不明なモデルIDに対してDeepSeekが実際に返す内容は文書化されておらず、ここではテストしていません。エラーリファレンスでは、Kunavo独自のエンドポイントにおける同等のステータスコードを扱っています。

直接、Gateway、ローカル：どのルートが優先されるか

KunavoはDeepSeekモデルを提供していません。テキストモデルはClaudeファミリーとOpenAIファミリーなので、KunavoからDeepSeekモデルへ接続するルートはなく、このページでも提供していません。ただし、仕組みは移行できます。DeepSeekそのものではなく、モデルファミリー間で1つのキーを使いたいという理由でDeepSeekの設定ページを読んでいる場合には、この点を知っておく価値があります。

Gateway行では、設定する項目は同じ2つの要素です。models.providers.<id>にbaseUrl、apiKey、api: "openai-completions"および、少なくとも各idを列挙するmodels[]配列を指定するか、--auth-choice custom-api-key、--custom-base-url、--custom-model-idを使ってエンドポイントに対してオンボーディングします。モデル参照は常にprovider/modelです。エラーが表面化しないまま失敗するのは、agents.defaults.modelsでモデルをエイリアス化しただけでmodels.providers.<provider>.models[]に登録しない場合です。OpenClawのカスタムプロバイダーリファレンスでは、このエイリアスは「上書きを制限せず、それ自体では新しい実行時モデルを登録しない」と説明されています。このルートにおけるKunavoのベースURLはhttps://api.kunavo.com/v1で、/v1が正確に1つ必要です。これはDeepSeekのサフィックスなしの規則とは逆で、一方のページの値を他方のフィールドにコピーした際に404が発生する最も有力な原因です。

この代替手段の規模感を示すため、同じ想定セッション、つまり入力トークン600,000個と出力トークン40,000個を、キャッシュなしとして、現在のKunavoカタログ料金で計算します。これは別のエンドポイント上の別のモデルなので、上記のDeepSeekの数値との同一タスクの費用比較ではありません。掲載料金が最安であることと、タスク完了までの費用が最も低いことは別の主張であり、後者を確定できるのは自分の実行だけです。

提示した前提に基づく例示的なトークン計算であり、実測したタスク費用でも請求上限でもありません。Kunavoのカタログ金額は上限ではなく課金下限です。上流が料金を報告すると、請求額はカタログ費用と、上流費用に適用されるマークアップを掛けた金額のうち大きいほうになります。キャッシュ料金と外部ツールはこの例の対象外です。最低チャージ額は前払いクレジット$10であり、資金投入の最低額であって、タスク料金やサブスクリプションではありません。課金の詳細とキャッシュを参照してください。

実際に必要なのがこの隣接するルートであれば、まずインテグレーション概要でベースURLとキーの設定を確認し、次にクイックスタートで最初の呼び出しを行い、キーに資金を入れる準備ができたらKunavoアカウントを作成してください。これは互換性の検証結果ではなく、公開された設定リファレンスとして扱ってください。OpenClawはKunavoのエンドポイントに対して実行時テストを行っていません。OpenClawを使い続けてモデルを選ぶ場合は、OpenClawの料金で無料ソフトウェアと従量制請求を区別し、OpenClawに最適なAPIでタスク別にルートを比較し、OpenAI互換APIでこのページが繰り返し注意しているベースURLの規則を確認してください。

よくある質問

上記のOpenClawおよびDeepSeekに関する記述はすべて、2026年9月21日に、OpenClaw v2026.9.5を前提として、両プロジェクトの公式ドキュメントとレジストリから確認しました。プロバイダーページ、料金ページ、変更履歴、9月10日の発表、list-modelsリファレンス、エラーコード表、レート制限ページ、カスタムプロバイダー規則を、このページのためにそれぞれ直接再取得しました。インストール、オンボーディング、呼び出しは一切行っていません。OpenClawの実行、api.deepseek.comへのリクエスト、Kunavoに対する実行時テストはいずれも実施していません。Kunavoのトークン料金は現在のカタログから取得しており、すべてのドル金額は実測費用ではなく、例示的なトークン計算です。