ZeroClaw API のコストとセットアップ：無料ランタイム、カスタムプロバイダー、実際のトークンコスト

ZeroClawランタイムの費用は$0です。オープンソースで、MIT OR Apache-2.0のデュアルライセンスであり、zeroclaw.com自身のFAQではサブスクリプションもホスト型シートもないと説明されています。支払うのは自分のLLMプロバイダー費用だけで、Ollamaでローカルモデルを実行するなら費用はまったくかかりません。プロジェクトの理念ドキュメントはさらに明確で、「SaaSではありません。ホスト型バージョンも、アカウントシステムも、請求もありません」としています。したがって実際の「ZeroClawの料金」とは、別の2つの請求を意味します。エイリアスの接続先に応じたモデルのトークン料金と、デーモンを実行するマシンの費用です。いずれも2026年9月21日時点で確認済みです。

省くとお金または時間がかかることが2つあります。ZeroClaw Labsは月額料金を一切公開していないため、すでに見かけた月額「ZeroClaw」サブスクリプションは他者の製品です。また、ZeroClaw独自のコスト台帳は、第三者ゲートウェイでの支出をゼロと報告します。customプロバイダースロットの背後に価格カタログがないため、料金を手動で入力するまでこの状態が続きます。どちらも以下で説明します。

ZeroClawの料金：ソフトウェアの費用と実際に請求されるもの

最後の行は、「zeroclaw pricing」の検索でたどり着く可能性がある誤った基準です。ZeroClawのREADMEは、github.com/zeroclaw-labs/zeroclawを唯一の公式リポジトリとして挙げ、ZeroClawを名乗るその他のリポジトリ、組織、ドメイン、パッケージは無許可であり、関係がないと明記しています。zeroclaw.liveについては、エージェントごとの別の月額料金も検索スニペットで流通していますが、2026年9月21日時点でそのサイトはページではなくエラーを返したため、ページ上で数値を確認できず、ここでは意図的に再掲していません。別途、プロジェクト自身が使用するドメインでもマーケティング上の数値は慎重に扱ってください。zeroclaw.dev、zeroclaw.org、zeroclaw.netのランディングページはいずれも3.4MBのバイナリを宣伝していますが、プロジェクトの独自の理念ページでは、通常のリリースビルドは約26 MiBになると説明しています。これはなりすましの証拠ではなく、ドキュメントとランディングページの差です。README自身も、セキュリティ報告の宛先としてzeroclaw.devのアドレスを案内しています。ZeroClawとOpenClawの比較では、この識別問題を詳しく扱っています。

2つの事実が矛盾して見えるため、対象範囲について1点補足します。「請求なし」はZeroClawランタイムについては正しく、組織としてのZeroClaw Labsについては正しくありません。同じGitHub組織はZeroRouterも提供しています。これはAGPLのゲートウェイで、リポジトリの説明には前払いStripe請求が記載されており、ZeroClawからは専用のzerorouterスロットを通じて接続できます。ベータ版の別製品であり、ZeroClawのサブスクリプションではありません。また、そのホスト型料金は公開価格表ではなく、稼働中のゲートウェイ状態です。

現在記述すべき設定の形：フラットなスニペットではなくスキーマ3

公式ドキュメントは最新ですが、検索結果で見つかるZeroClaw設定の多くは最新ではありません。現在の設定スキーマバージョンは3です。v0.8.5のリリースタグにあるCURRENT_SCHEMA_VERSION: u32 = 3（crates/zeroclaw-config/src/migration.rs）では、V1からV2、V2からV3という移行チェーンになっています。古いチュートリアルで流通しているフラットな形はスキーマ1です。schema_versionを含まない設定ファイルはバージョン1として扱われ、読み込み時にメモリ上で移行されるため、読み込み自体によってディスク上のファイルが書き換えられることはありません。

命名に注意してください。「ZeroClaw V3」はリリースではありません。最新リリースはv0.8.5で、2026年9月5日に公開されています（GitHub API、2026年9月21日に確認）。スキーマ3はその内部の設定形式です。この2つの数字に関係はありません。

スキーマ1のフィールド名は、v0.8.5のV1移行レンズから読み取ったものです。スキーマ2の行は、master上のV2レンズのドキュメントコメントに由来します。いずれも2026年9月21日に確認したものです。これらのレンズは、移行中に古いファイルがどの形式として解析されるかを定めるため、古いフィールド名の根拠として有効です。最後の行では、日付の違いにより2つの情報源が食い違っています。V2レンズは、V3でcost.pricesが削除され、価格設定が各モデルプロバイダーにインラインで移されたと記録しています。一方、現在のコスト追跡ドキュメントは、インラインのエイリアスごとのpricingフィールドをレガシーとし、今後使用する設定として、競合時に優先される[cost.rates.*]を示しています。[cost.rates.*]を記述してください。

スキーマ3では、すべてのモデルプロバイダーが[providers.models.<type>.<alias>]に配置されます。ここでtypeは正規のファミリースロットであり、「ベンダーごとに1つのスロットがあり、同義語はない」とされています。aliasは自由に命名できます。プロバイダー概要には、「グローバルな『デフォルトプロバイダー』や『デフォルトモデル』の設定はない」と明記され、参照が解決できない場合はConfig::validate()が起動時に明示的に失敗します。スキーマ1のスニペットをコピーしても古いという理由だけで拒否されるわけではありません。移行チェーンはトップレベルのapi_key、api_url、default_modelを、default_providerによって指定された名前のプロバイダーエントリにまとめます。また、キーがない場合、V1レンズはopenrouterを代入します。そのため、キーとURLだけを含むフラットなスニペットは、意図したゲートウェイではなくopenrouterエントリに配置されます。失敗するのは古いフィールド名ではなく、解決できない参照です。

ZeroClawカスタムプロバイダー：エイリアスをOpenAI互換APIに向ける

OpenAIのchat-completions形式で通信するエンドポイントはcustomスロットに配置します。v0.8.5のカスタムプロバイダーページによれば、これは設定だけの変更です。「customスロットにはuriが必要です（ファミリーのエンドポイント列挙型にはデフォルトがありません）」。Anthropic Messages形式で通信するエンドポイントは、代わりにanthropicスロットに配置し、uriを設定して接続先を上書きします。customには配置しません。Kunavoはhttps://api.kunavo.com/v1の下で、1つのキーにより両方の通信形式を提供しているため、理論上はいずれのスロットも適合します。以下のスニペットは、ドキュメントに記載されたカスタムスロットのフィールドと、ドキュメント自身の実例にある4ヘッダー形式を組み合わせたものです。公式ブロックのコピーではなく、改変した例です。

# Four section headers is the smallest config that loads clean.
[providers.models.custom.kunavo]
uri     = "https://api.kunavo.com/v1"   # REQUIRED: the custom family has no default endpoint
model   = "claude-sonnet-4-6"
api_key = "sk-kn-..."                   # or the secrets store, op://, or a ZEROCLAW_ env override

[agents.assistant]
model_provider  = "custom.kunavo"       # there is no global default provider
risk_profile    = "supervised"
runtime_profile = "resident"

[risk_profiles.supervised]
level                            = "supervised"
workspace_only                   = true
require_approval_for_medium_risk = true
block_high_risk_commands         = true

[runtime_profiles.resident]
max_actions_per_hour   = 10             # example values from the docs, not defaults
max_cost_per_day_cents = 100
max_tool_iterations    = 4
agentic_timeout_secs   = 120

実用上の注意点は4つあります。認証情報は、インラインの api_key、1Password の op://vault/item/field 参照、~/.zeroclaw/secrets にある暗号化ストア、または汎用の環境変数オーバーライド ZEROCLAW_providers__models__custom__kunavo__api_key の4つの方法で指定できます。環境変数オーバーライドでは、二重アンダースコアがドットに対応します。$ANTHROPIC_API_KEY のようにエコシステムで標準的に使われるシェル変数名は、そのプロバイダーファミリーが独自のネイティブ環境変数ブリッジを文書化している場合を除き、直接は読み込まれません。ドキュメントでは、スキーマに対応する名前へ自分で展開するよう案内されています。また、スキーマに対応する環境変数は実行時に注入されるものであり、永続的な設定になることはありません。custom スロットはデフォルトで chat-completions の通信形式を使用します。wire_api は、独自のエンドポイントを指定するファミリー（openai、llamacpp、custom）では適用されますが、ブランド名を冠したベンダースロットでは通信形式が固定されているため無視されます。ただし、唯一の例外として opencode が挙げられています。ゲートウェイが temperature フィールドを拒否する場合は、未設定のままにしてください。ドキュメントには、未設定の temperature はリクエストボディから完全に省略されると記載されています。また、問題なく起動したからといって、見た目ほど多くのことが確認できたわけではありません。接続のウォームアップは、レスポンスボディを読み取り、成功以外のステータスコードも受け入れる GET リクエストであるため、どちらの場合もデーモンは起動します。master ブランチのカスタムプロバイダーページでは、これを GET {base_url}/models と記載していますが、v0.8.5 のコードでは、代わりに chat-completions の URL に対してウォームアップを行います。

ドキュメントに記載された順序で、v0.8.5の3つすべてを検証します。zeroclaw config listは設定を読み込み、検証失敗をstderrに出力します。zeroclaw models refresh --model-provider custom.kunavoはエンドポイントが公開している内容を一覧表示し、zeroclaw agent -a assistant -m "hello"はエージェントのスモークテストを行います。Kunavo独自の/v1/modelsはキーなしでHTTP 401を返します（2026年9月21日に確認）が、これは障害ではありません。refreshコマンドがエイリアスのキーを送信するためです。KunavoはZeroClawを実行時テストしていません。このセクションの内容はすべてZeroClawのソースドキュメントのレビューなので、経路を信頼する前に、自分で範囲を限定したタスクを1つ実行してください。

Kunavoは埋め込み、音声合成、音声認識のモデルを提供していません。そのため、それらの処理を必要とするエージェントは、チャットモデルをどのZeroClawスロットに配置するかにかかわらず、別のエンドポイントを指定する必要があります。

料金表を記述するまで、コストメーターは$0を表示します

ZeroClawは自身の支出を計測しますが、第三者ゲートウェイではそのメーターが最初は誤っています。コスト追跡はcost.enabledによって有効化され、記録は<workspace>/state/costs.jsonlの追記専用台帳に、1行1JSONオブジェクトで保存されます。問題は価格の出所です。v0.8.5のcatalog.rsでは、catalog_source_forがcustomファミリーについてmodels.devキーもOpenRouterベンダープレフィックスも返しません。ほとんどのブランド付きスロットは少なくとも一方を持ちますが、zerorouter、telnyx、nearaiなど複数のスロットはどちらも持ちません。live_pricingオプトインはデフォルトで無効です。有効な場合は、まずエンドポイント独自の/models一覧を読み取り、次にファミリーのmodels.dev名をキーとしてmodels.devにフォールバックします。customファミリーにはそのようなキーがないため、このスロットではエンドポイント独自の一覧だけが情報源です。Kunavoの一覧にはトークン単価フィールドがありません。認証済みの本番レスポンスではなく、ルートソースから読み取ったものです。そのため、カスタムスロットのエイリアスは、料金を自分で入力するまでcost_usd = 0を記録し、unpriced_tokensはゼロより大きい値になります。

[cost]
enabled = true

# Keyed by the UPSTREAM model id as it appears in usage telemetry,
# not by your alias. USD per 1M tokens.
[cost.rates.providers.models.custom.claude-sonnet-4-6]
input        = 2.1
output       = 10.5
cached_input = 0.21

そこから3つの挙動が生じます。いずれも2026年9月21日に確認したコスト追跡ドキュメントに記載されています。料金エントリのキーは、エイリアスではなく、使用状況テレメトリに現れる上流モデルIDです。予算比較は記録されたcost_usdを使用するため、月内に価格未設定のトークンが含まれている場合、日次または月次の合計が上限を下回っていても安全の保証にはなりません。また、既存の台帳行は再計算されません。「遡及的な再価格設定はありません」ので、料金は設定後に行われたリクエストにのみ適用されます。強制には3つのモードがあります。デフォルトのwarn、block、そしてより安価なroute_down_modelに置き換えるroute_downです。さらにallow_overrideがあり、デフォルトはfalseで、CLI上のオーバーライドトークンによりリクエストがblockを回避できます。

ZeroClaw独自の日次上限に基づく試算

これは説明用のトークン計算であり、測定されたタスクコストでも請求上限でもありません。ドキュメントの[runtime_profiles]実例では、エージェントをmax_actions_per_hour = 10およびmax_cost_per_day_cents = 100に制限しています。これは小規模なローカルモデル向けの例示値であり、デフォルトではありません。この上限を1日8時間アクティブな場合に文字どおり適用します。1日80ターンで、各ターンはキャッシュされていない入力トークン6,000個を送り、出力トークン500個を返します。料金は100万トークンあたりのKunavoカタログの現在価格です。

重要なのは順位ではなく、上限との相互作用です。小規模なローカルモデル向けに記述されたプロファイルでも、フロンティアモデルを同じ上限下に置けます。max_actions_per_hourがターン数を制限し、日次コスト上限はenforcement.modeがblockの場合にのみリクエストを拒否します。デフォルトのwarnでは、上限はブロックせず、イベントをログに記録してリクエストを通します。warn_at_percent（デフォルト80%）は別の設定で、ハードリミットの前にゲートウェイが警告バナーを表示するタイミングを制御します。さらに、上記の料金表を一度も記述していなければ、価格未設定のトークンを上限が認識できないため、これらは何も作動しません。予算として扱う前に、自分のターン数と入力対出力比で表を拡大縮小してください。キャッシュ料金、ツール呼び出し、再試行は含まれておらず、安価なモデルが追加試行なしで作業を完了すると仮定しています。

Kunavoのカタログ金額は上限ではなく請求下限です。上流が料金を報告すると、請求額はカタログコストと、適用されるマークアップを乗じた上流コストの大きい方になります。前払いクレジットの最小チャージは$10です。これは資金投入の最低額であり、タスク料金でもサブスクリプションでもありません。請求の詳細を参照してください。

ZeroClawに最適なモデルと最適なAPI：プロジェクトが伝えること、伝えないこと

ZeroClawは推奨モデルを公開しておらず、公式見解として述べることも拒否しています。マルチモデル設定ページには、「このワークフローはZeroClawで検証済みのモデル一覧を確立するものではない」、また「1つのビルド、モデル、量子化、コンテキスト設定についての証拠は、他の組み合わせを検証するものではない」とあります。これが「ZeroClawに最適なモデル」への正直な回答です。引用できる公式ランキングはないため、代わりに検証可能な2つの特性で選んでください。

1つ目はネイティブのツール呼び出しです。同じページでは、厳格な基準を定めています。「実際のツール呼び出し、その実行結果、その結果を使用するアシスタントの続行を実行内容から確認してください。もっともらしい回答や、出力されたツール呼び出しのマークアップだけでは、ツールテストに合格したことになりません」。ランタイムプロファイル設定strict_tool_parsingは、プロバイダーが実際のツール呼び出しを返さない限り、XMLまたはJSONに見えるフォールバックテキストを通常のアシスタントテキストとして扱います。そのため、ツール呼び出しを説明するだけのモデルは動作しているように見えても、実際には何も実行しません。2つ目は、追加試行なしでモデルがタスクを完了できるかどうかです。だからこそ、掲載価格が最安であるという主張と、完了までのコストが最小であるという主張は異なります。

フェイルオーバーを有効にする前に予算化すべき挙動が2つあります。ストリーミングの契約はより限定的です。プロバイダールーティングライフサイクルのページには、ラッパーは「要求されたストリーム機能をサポートし、クールダウン中でない、順序付きエントリの最初のものを選択」し、「そのストリームを1回だけ開き」、「ストリーム開始後はエントリを切り替えない」とあります。ただし、出力がコミットされる前にストリームが失敗した場合は、非ストリーミング経路で再試行され、fallback_modelsとfallbackを対象とする完全な信頼性チェックに再び入ります。これらの非ストリーミング再試行は、タイムアウト、接続エラー、429、503を対象とし、400、恒久的な認証失敗、モデル出力エラーは明示的に対象外です。また、フォールバックエントリによって作業が別の価格帯に移る可能性があるため、先に予算を設定してください。ゲートウェイ経路のより広い比較については、OpenAI互換APIガイドとOpenRouterの代替を参照してください。

常時稼働作業：リスクプロファイル、上限、再起動するサービス

自律性はグローバルではなくエージェントごとに設定されます。v0.8.5の自律性ページでは、正確に3つのレベル、readonly、supervised、fullを受け付け、アンダースコア付きのread_onlyは設定の読み込み時に拒否します。デフォルトのsupervisedでは、低リスクのツールは自動実行され、中リスクのツールはオペレーターの承認プロンプトを表示し、高リスクのツールはブロックされます。承認プロンプトはチャネルのapproval_timeout_secs後に期限切れになります。ほとんどのチャネルでは120秒です。タイムアウトは拒否として扱われるため、無人エージェントはキューに入るのではなく、安全側に倒れて失敗します。

常時稼働作業には2つの境界があります。再起動の挙動はプラットフォームによって一様ではありません。インストールされたsystemdユーザーユニットはRestart=alwaysをRestartSec=3とともに設定し、終了コードの許可リストがないため、設定不良で即座に終了するデーモンは再起動を繰り返します。macOSのLaunchAgentはRunAtLoadとKeepAliveを設定します。Windowsではzeroclaw service installがONLOGONタスクスケジューラータスクを登録し、ログオン時にデーモンを起動しますが、失敗時の再起動ポリシーは追加しません。スケジュールされた作業自体は宣言的で、[cron.<alias>]でエイリアスをキーとして指定され、[scheduler]セクション独自の設定とは分離されています。また、決定論的なSOPエンジンはプロジェクト独自の機能マトリックスで実験的とされています。周辺機器およびカレンダーのトリガーは定義・照合されますが、まだライブソースにはルーティングされません。そのため、現時点では無人ワークフローをこれに基づいて設計しないでください。

設定して最初の請求を確認する

KunavoはZeroClaw専用の統合ページを公開しておらず、クライアントの実行時テストも行っていないため、上記の設定は互換性の結果ではなく、ソース文書に基づく手順として扱ってください。実際の手順は短く、キーを作成し、最低額をチャージし、4つのヘッダーを記述し、3つの検証コマンドを順番に実行してから、最初の長時間実行の前に[cost.rates.*]ブロックを記述し、台帳に記録できるようにします。ベースURLとキー形式についてはクイックスタートから、customスロットが使用する通信形式についてはチャット補完リファレンスから確認し、チャージする準備ができたらKunavoアカウントを作成してください。エージェントがAnthropicの通信形式を使用する場合は、AnthropicベースURLのドキュメントでanthropicスロットの経路を確認できます。

よくある質問

2026年9月21日時点で確認。 このページのために、zeroclaw.comのFAQ、リポジトリのREADME、リポジトリの状態とv0.8.5リリースに関するGitHub API、v0.8.5タグのmigration.rs、schema/v1.rs、catalog.rs、compatible.rs、providers/custom.md、security/autonomy.md、ops/service.md、masterのV2移行レンズ、providers/overview.md、providers/configuration.md、providers/catalog.md、providers/routing.md、providers/custom.md、architecture/provider-routing-lifecycle.md、ops/cost-tracking.md、getting-started/multi-model-setup.md、philosophy/minimal.md、philosophy/what-this-isnt.md、reference/feature-matrix.md、さらにzerorouterリポジトリ、上記で名称を挙げたサードパーティーサイトとランディングページ、Kunavoの/v1/modelsへの認証なしGETを直接読み直しました。masterから引用した内容は開発ブランチのドキュメントであり、安定版より先行している可能性があります。KunavoではZeroClawの実行時テストを行っていません。インストール、config list、エージェント実行はいずれも実施していないため、この経路でのストリーミング、ネイティブなツール呼び出し、ビジョンはここでは未検証です。Kunavoのトークン料金は現在のカタログから読み取り、このページのドル額はすべて例示的なトークン計算です。