クライアント/OpenClaw

OpenClaw で Wokey API を使う

Wokey の API キーを取得し、OpenClaw の Base URL を Wokey に向けてから、curl リクエスト 1 回で接続を確認します。

更新日

このページの内容expand_more

API キーと Base URL を用意するlink

どのクライアントも、同じ Wokey API キーと同じ Base URL を使います。

API キーを作成する

ログインして API ページでプラットフォームのキーを作成します。同じアカウントのキーは残高を共有します。

API キーを作成key

Wokey の Base URL を使う

クライアントの Base URL にはゲートウェイのドメインを設定します。/v1 を付けるかどうかは以下の設定を参照してください。

クライアントを設定するlink

コマンド 1 つで、OpenAI 互換のカスタムプロバイダーを書き込みます。

OpenClaw
openclaw onboard --non-interactive --accept-risk \
  --auth-choice custom-api-key \
  --custom-base-url "https://api.wokey.ai" \
  --custom-model-id "gpt-6-sol" \
  --custom-api-key "YOUR_API_KEY" \
  --custom-provider-id "wokey" \
  --custom-compatibility openai \
  --gateway-port 18789 \
  --skip-health

API 形式と Base URLlink

同じクライアントでも API 形式を切り替えると、Base URL の末尾に /v1 を付けるかどうかが変わることがあります。

形式Base URL用途
OpenAI Chat Completionshttps://api.wokey.aiDeepSeek、GLM、Kimi などのモデル

設定場所: openclaw onboard コマンドのフラグ

Opus 5.5 で OpenClaw を常駐エージェントとして動かす：Claude Duet との違いlink

Anthropic は 2026-10-21 に Claude Duet のリサーチプレビューを公開しました。Claude Opus 5.5 をベースにしたプロアクティブなエージェントで、毎朝ブリーフィングを送り、接続したアプリをバックグラウンドで監視し、行動する前にあなたに確認します。Duet は Claude アカウントでのログインでしか使えず、API キーやカスタム Base URL がないため、Wokey 経由では動かせません。OpenClaw はオープンソースのセルフホスト型常駐エージェントで、Wokey に接続すれば同じ Opus 5.5 モデルを、ウェイトリストなし・地域制限なしで使えます。

Claude DuetOpenClaw + Wokey
モデルClaude Opus 5.5（変更不可）claude-opus-5-5、または Wokey 上の他のモデル
利用できる人米国の Claude Pro / Max 加入者（ウェイトリスト制）。Team と Enterprise はまだ非対応自分でインストールします。Wokey の API キーがあればよく、地域を問いません
費用プレビュー期間中は追加料金なし。ただしチャットや Claude Code とプランの使用制限を共有し、バックグラウンドのチェックも含まれますWokey の残高からトークン単位で課金。チェックの頻度は自分で決めます
実行場所Anthropic のクラウド上の専用ブラウザ付き仮想マシン。スマートフォンやノート PC の電源を切っても動き続けます自分のコンピューターやサーバー。24 時間動かすなら常時稼働のマシンでホストします
やり取りの方法Duet アプリ（iOS / Android）と claude.aiTelegram や Slack などのチャットアプリ
メモリとツールClaude アカウントのメモリ、skills、コネクタを引き継ぎますメモリ、skills、ツールはローカルにあり、自分でインストール・管理します
実行前の承認メッセージ送信、支払い、署名、削除の前に確認を求めます。証券取引と口座間の送金は一切許可されません権限と承認ルールは自分で設定します。必要なアカウントだけにアクセスを許可してください
  • トークン単位の課金では、チェックの頻度が高いほど費用がかかります。チェックのたびにシステムプロンプトとメモリが再送信されるためです。定期チェックには安価なモデル（claude-sonnet-5-5 や deepseek-v4.1-flash など）を使い、判断や操作が必要なときに Opus 5.5 に切り替えてください。
  • Chat Completions 経由では Opus 5.5 は書き出す前に思考するため、最初のトークンが遅くなります。バックグラウンドで動くエージェントではほとんど気になりません。
OpenClaw · claude-opus-5-5
openclaw onboard --non-interactive --accept-risk \
  --auth-choice custom-api-key \
  --custom-base-url "https://api.wokey.ai" \
  --custom-model-id "claude-opus-5-5" \
  --custom-api-key "YOUR_API_KEY" \
  --custom-provider-id "wokey" \
  --custom-compatibility openai \
  --gateway-port 18789 \
  --skip-health

Duet の情報は 2026-10-22 に確認 · Duet の情報源：Introducing Claude Duet · Claude Duet FAQ

curl で確認するlink

クライアントがエラーを出す場合は、まず curl で API キーと Base URL の問題ではないことを確認します。

OpenClaw はデフォルトで OpenAI Chat Completions 形式を使います。このリクエストで 200 が返れば、API キーと Base URL は正しく設定されています。送信前に YOUR_API_KEY をご自身のキーに置き換えてください。

cURL
curl https://api.wokey.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-sol",
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'

エラーとトラブルシューティングlink

まず認証、残高、レート制限、モデルの利用可否、アップストリームのタイムアウトのどれかを切り分けます。

401

invalid api key

キーがない、入力ミスがある、削除されている、または Authorization と x-api-key ヘッダーの内容が食い違っています。

402

insufficient balance

アカウントの残高が不足しています。リクエストを続ける前にチャージしてください。

403

model_denylisted / account_restricted

違反が繰り返されたため、そのモデル、またはアカウントのすべてのモデルへの呼び出しが停止されています。「違反処理手数料と制限」を参照してください。

403

request_blocked

このリクエストはアップストリームに届く前にブロックされ、課金されていません。たとえば、モデルが直前に拒否したリクエストを変更せずに再送した場合や、停止中のエンドユーザー（X-End-User-Id）の場合です。エラーメッセージに何がブロックされたかが示されるので、その内容に沿ってリクエストを変更するか、時間をおいて再試行してください。ほかのリクエストには影響しません。

429

rate limited

リクエストの頻度が高すぎます。時間をおいて再試行するか、同時実行数を減らしてください。特定のモデル、または特定のエンドユーザー（X-End-User-Id）だけが 429 を返し続ける場合は、違反後の一時的な制限の可能性があります。

499

client disconnected

レスポンスの完了前にクライアントが接続を閉じました（コード downstream_aborted）。デフォルトでは無料です。過去 24 時間にアカウントのクライアント切断が 50 回以上あり、それがリクエストの 10% 以上を占めると、以降の切断されたリクエストはアップストリームが報告した使用量で課金されます。対象は、キャッシュの読み書きを含む処理済みの入力と、アップストリームが計上した場合に限り出力です。アップストリームが使用量を報告する前に切断された場合は無料のままです。課金が始まるとアカウントに通知され、切断率が通常に戻ると 1 時間以内に課金は自動的に停止します。よくある原因は、クライアントやプロキシのタイムアウトが短すぎることや、プログラムが完了前にリクエストをキャンセルしていることです。

502

upstream unavailable

アップストリームのモデルサービスが一時的に利用できません。モデルを切り替えるか、時間をおいて再試行してください。

504

upstream timeout

アップストリームのレスポンスがタイムアウトしました。コンテキストを短くするか、max_tokens を減らすか、再試行してください。

529

upstream overloaded

アップストリームのモデルが一時的に過負荷になっており、Wokey はほかの経路での再試行を済ませています（コード upstream_overloaded）。残高とは関係ありません。少し待ってから再試行するか、モデルを切り替えてください。

よくある質問link

OpenClaw の --custom-base-url に /v1 は必要ですか？
不要です。https://api.wokey.ai を指定してください。
--custom-compatibility には何を指定しますか？
openai です。これで OpenClaw は OpenAI 互換形式で Wokey を呼び出します。
--custom-model-id には何を指定しますか？
Wokey のモデルページにあるモデル ID です。例：gpt-6-sol、claude-opus-5-5。