- FreeToken openclaw は、従来のプロバイダーAPIキーの代わりにブラウザーセッションを使用します。
- 対応プロバイダー には、DeepSeek、Qwen、Kimi、Claude、ChatGPT、Gemini、Grokなどが含まれます。
- 基本セットアップ には、Node.js 22.12.0以上とpnpm 9.0.0以上が必要です。
- 日常的なワークフロー では、Chromeデバッグモード、オンボーディング、OpenClawゲートウェイサーバーを使用します。
- セキュリティ上の最優先事項 は、ローカルCookie、Bearer認証情報、ワークスペースへのアクセスを保護することです。
FreeToken openclawの概要
FreeToken openclawは、統合ゲートウェイを通じて複数のAIウェブサービスに接続する、ブラウザー認証型のOpenClawセットアップです。すべてのプロバイダーごとに別々のAPIキーを購入して用意する代わりに、ブラウザーでログインし、必要なセッション認証情報をローカルに保存して、設定済みのモデルをOpenClawインターフェースから利用できるようにします。
この方法は、実験、モデル比較、個人用エージェントのワークフローに適しています。ただし、公式の無制限APIサービスと同じものではありません。ウェブセッションは期限切れになる可能性があり、ウェブエンドポイントにはレート制限が適用される場合があります。また、各プロバイダーの利用規約も引き続き適用されます。
統合ゲートウェイ
1つのWeb UI、CLI/TUI、またはローカルHTTPゲートウェイを通じて、設定済みのプロバイダーとチャットできます。
ブラウザー認証
対応するウェブインターフェースからサインインし、オンボーディングフローによってローカルセッションデータを保存します。
マルチモデルテスト
複数のプロバイダーからの回答を比較したり、AskOnceで1つの質問を複数モデルに送信したりできます。
| 項目 | FreeToken openclawの方式 | 実際の意味 |
|---|---|---|
| 認証 | ブラウザーログインとローカルセッションの取得 | プロバイダーへのアクセスは通常のブラウザーセッションから開始します |
| モデルアクセス | 統合プロバイダーレイヤー | クライアント全体を変更せずにモデルを切り替えられます |
| ゲートウェイ | ローカルHTTPサービス | Web UI、CLI、連携機能が1つの稼働中サービスを利用できます |
| ツール呼び出し | プロンプトに注入されるローカルツール | 設定済みのエージェントは、read、write、exec、ウェブ検索などのツールを使用できます |
| ライセンス | MITプロジェクトライセンス | プロジェクトの規約と第三者サービスの利用規約を個別に確認してください |
このセットアップを、ローカルでの調査および自動化環境として扱ってください。まず1つのプロバイダーから始め、ゲートウェイを確認し、基本ワークフローが安定してからセッションを追加しましょう。
プロバイダーとモデルの比較
プロバイダーレイヤーは、ゼロトークン構成でOpenClawを利用する主な理由です。複数のウェブプロバイダーがテスト済みとして掲載されている一方、ManusはAPIベースの無料枠を持つサービスとして別途説明されています。対応状況の詳細はプロバイダーごとに異なる可能性があるため、実際に必要なサービスだけを設定してください。
| プロバイダー | モデル例 | チャット | ツール呼び出し | 認証方式 |
|---|---|---|---|---|
| DeepSeek Web | deepseek-chat, deepseek-reasoner | 対応 | 対応 | ブラウザーセッション |
| Qwen Web | Qwen 3.5 Plus, Qwen 3.5 Turbo | 対応 | 対応 | ブラウザーセッション |
| Kimi | Moonshot v1 8K/32K/128K | 対応 | 対応 | ブラウザーセッション |
| Claude Web | Claude Sonnet 4-6, Opus 4-6, Haiku 4-6 | 対応 | 対応 | ブラウザーセッション |
| ChatGPT Web | GPT-4, GPT-4 Turbo | 対応 | 対応 | ブラウザーセッション |
| Gemini Web | Gemini Pro, Gemini Ultra | 安定性に関する注意事項あり | DOMポーリングに関する注意事項あり | ブラウザーセッション |
| Grok Web | Grok 1, Grok 2 | 対応 | 対応 | ブラウザーセッション |
| GLM Web | GLM-4 Plus, GLM-4 Think | 対応 | 対応 | ブラウザーセッション |
| Doubao Web | doubao-seed-2.0, doubao-pro | チャットに関する制限あり | 記載されているツール呼び出しマトリックスでは利用不可 | ブラウザーセッション |
| Manus | Manus 1.6, Manus 1.6 Lite | 記載された無料枠を通じて対応 | ゼロトークンのウェブアクセスとしては提示されていません | 無料枠付きAPIキー |
モデルを切り替えるには、チャットボックスで/modelコマンドを使用します。プロバイダーに複数のバリエーションがある場合は、正確なモデル識別子を使用することを推奨します。たとえば、Claudeの設定では、短いプロバイダーのみのコマンドよりも/model claude-web/claude-sonnet-4-6のほうが確実に解決される場合があります。
| コマンド | 目的 | 例 |
|---|---|---|
/models | 設定済みのプロバイダーとモデルを一覧表示 | アクティブなモデル、エイリアス、設定を表示します |
/model provider | プロバイダーのエイリアスを選択 | /model deepseek-web |
/model provider/model | 正確なモデルを選択 | /model claude-web/claude-sonnet-4-6 |
| AskOnce | 1つの質問を複数モデルに送信 | 回答を横並びで比較します |
すべてのプロバイダーが同じ挙動をするとは限りません。GeminiではDOMポーリングが不安定になる可能性があり、Doubaoはストリームパーサーの制限により、記載されているツール呼び出しフローから除外されています。
セットアップ手順
推奨されるインストール手順では、Node.js、pnpm、Chromeデバッグセッション、ウェブ認証ウィザード、ゲートウェイサーバーを使用します。オンボーディングを完了する間は、ブラウザーとターミナルのセッションを開いたままにしてください。
必要なツールをインストールする
Node.js 22.12.0以上とpnpm 9.0.0以上を使用してください。macOSとLinuxは直接サポートされています。WindowsではWSL2を使用し、その後Linuxの手順に従ってください。
プロジェクトをクローンしてビルドする
OpenClawのゼロトークンプロジェクトをクローンしてディレクトリに移動し、pnpm install、pnpm build、pnpm ui:buildを実行します。ビルドコマンドでは、別のパッケージマネージャーに置き換えずpnpmを使用してください。
Chromeデバッグモードを開始する
./start-chrome-debug.shを実行し、そのターミナルを開いたままにします。ブラウザーデバッグセッションが、対応するウェブプロバイダーにログインするための環境を提供します。
ログインしてオンボーディングを実行する
使用したいプロバイダーのウェブサイトにサインインします。新しいターミナルで./onboard.sh webauthを実行し、対象のプロバイダーを選択して、ウィザードが必要なローカルセッション認証情報を取得できるようにします。
ゲートウェイを開始する
./server.shを実行します。このコマンドはゲートウェイとWeb UIを起動し、ブラウザーで開くアドレスを表示します。後でサービスを確認するには./server.sh statusを使用してください。
| セットアップ段階 | コマンドまたは操作 | 期待される結果 |
|---|---|---|
| 依存関係 | pnpm install | プロジェクトのパッケージをインストールします |
| アプリケーションのビルド | pnpm build | メインアプリケーションをビルドします |
| UIのビルド | pnpm ui:build | Web UIをビルドします |
| ブラウザーセッション | ./start-chrome-debug.sh | Chromeデバッグ環境を開きます |
| 認証 | ./onboard.sh webauth | プロバイダー認証設定を作成します |
| ゲートウェイ | ./server.sh | ローカルHTTPゲートウェイとWeb UIを起動します |
まずDeepSeek、Qwen、または別の単一プロバイダーを設定してください。追加のブラウザーセッションを登録する前に、/modelsでプロバイダーが表示され、基本的なチャットリクエストが動作することを確認しましょう。
ゲートウェイの利用と設定
ゲートウェイが起動したら、設定済みモデルをテストするにはWeb UIが最も簡単です。CLI/TUIはnode openclaw.mjs tuiで利用でき、ローカル連携機能からは、設定に定義されたゲートウェイトークンを使ってHTTPエンドポイントにリクエストを送信できます。
デフォルトのサンプル設定では、ポート3001とトークンベースのゲートウェイ認証を使用します。このゲートウェイトークンは、プロバイダーのCookieやBearer認証情報とは分けて管理してください。それぞれ保護する境界が異なります。ゲートウェイトークンはローカルAPIへのアクセスを制御し、プロバイダー認証情報はウェブセッションを認証します。
curl \
-H "Authorization: Bearer YOUR_GATEWAY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-web/deepseek-chat",
"messages": [{"role": "user", "content": "Hello!"}]
}'
| インターフェース | アクセス方法 | 最適な用途 |
|---|---|---|
| Web UI | ./server.shが表示するURLを開く | 日常のチャットとモデル切り替え |
| CLI/TUI | node openclaw.mjs tui | ターミナルベースの操作 |
| HTTP API | Bearerトークンを使ったローカルゲートウェイへのリクエスト | スクリプトや互換性のある連携機能 |
| モデルカタログ | /models | 設定済みプロバイダーとエイリアスの確認 |
| モデル切り替え | /model | アクティブなプロバイダーまたはモデルの変更 |
ツール呼び出しは、検索、取得、読み取り、書き込み、メッセージ送信、ローカルコマンドの実行などのアクションを促すプロンプトが入力されたときに有効になるよう設計されています。ワークスペースの制限は、設定済みのエージェントワークスペースによって管理されるため、そのディレクトリは必要最小限の範囲に限定してください。
./onboard.sh webauthによる設定を完了したプロバイダーだけが設定ファイルに書き込まれ、/modelsに表示されます。プロジェクトが対応しているプロバイダーでも、オンボーディングが完了するまではローカルカタログに表示されない場合があります。
セキュリティ、トラブルシューティング、メンテナンス
ブラウザー認証型の自動化では、認証情報を慎重に扱う必要があります。CookieとBearerトークンは、プロジェクトのローカル状態領域を含むローカル認証ファイルに保存されます。これらのファイルをリポジトリにコミットしたり、公開されたIssueレポートに貼り付けたり、スクリーンショットで共有したりしないでください。
ウェブセッションは期限切れになる可能性があり、プロバイダーによってはレート制限が適用されます。そのため、このセットアップは大規模な本番トラフィックよりも、個人でのテストや中程度の負荷に適しています。プロバイダーから応答がなくなった場合やローカルセッションが無効になった場合は、ブラウザーから再認証してください。
メンテナンスチェックリスト:
- auth.jsonとローカル状態ディレクトリをバージョン管理の対象外にする
- エージェントのファイルアクセスには範囲を限定したワークスペースを使用する
- リクエストが失敗し始めたらプロバイダーのセッションを確認する
- ゲートウェイを再起動する前に./server.sh statusを使用する
- 必要なディレクトリが存在しない場合はdoctorコマンドを実行する
| 症状 | 推奨される対処 | 重要な制限 |
|---|---|---|
| ディレクトリが見つからない | node dist/index.mjs doctorを実行 | このコマンドはopenclaw.jsonやauth-profiles.jsonを作成しません |
| 認証ファイルが見つからない | ./onboard.sh webauthを再実行 | 再認証が必要になる場合があります |
ERR_MODULE_NOT_FOUND | dist、dist-runtime、node_modulesを削除して再インストールと再ビルドを行う | 最後にpnpm ui:buildを実行してください |
| ハッシュ不一致エラー | クリーンビルドを実行 | npm run buildではなくpnpm buildを使用してください |
| ウェブセッションの期限切れ | Chromeから再度ログインしてオンボーディングを再実行 | セッションの有効期間はプロバイダーによって異なります |
| ゲートウェイの問題 | ./server.sh restartを使用するか、./server.sh statusを確認 | 表示されたポートとローカルトークンを確認してください |
クリーンビルドは次の順序で実行します。
rm -rf dist dist-runtime node_modules pnpm install pnpm build pnpm ui:build ./server.sh restart
新しいウェブプロバイダーを追加する場合、プロジェクト構造では認証、APIクライアント、ストリーム処理が分離されています。一般的に、プロバイダーには認証モジュール、ウェブクライアント、ストリームハンドラー、ストリームファクトリーへの登録が必要です。この分離により、プロバイダー固有の挙動を保守しやすくなります。
ブラウザー自動化は、各サービスで許可されている方法に限って使用してください。プロジェクトの免責事項では、第三者サービスの規約を遵守する責任は運用者にあるとされています。
FreeToken openclaw FAQ
Q: FreeToken openclawとは何ですか?
FreeToken openclawは、ブラウザー認証によるOpenClawワークフローで、1つのローカルゲートウェイを通じて複数のAIウェブプロバイダーに接続します。個別に購入したAPIキーへの依存を減らせますが、プロバイダーの制限、セッションの期限切れ、サービスの利用規約がなくなるわけではありません。
Q: FreeToken openclawにはAPIトークンが必要ですか?
記載されているゼロトークンのウェブプロバイダーは、従来のプロバイダーAPIキーの代わりに、ブラウザーログインとローカルに保存されたセッション認証情報を使用します。ManusはAPIキーと無料枠を持つサービスとして別途掲載されているため、同じ認証方式として扱わないでください。
Q: どのオペレーティングシステムに対応していますか?
macOSとLinuxは直接サポートされています。WindowsユーザーはWSL2を使用し、その後Linuxのインストール手順に従ってください。
Q: 設定したプロバイダーが`/models`に表示されないのはなぜですか?
`./onboard.sh webauth`による設定を完了したプロバイダーだけが、ローカルOpenClaw設定に書き込まれます。そのプロバイダーのオンボーディングウィザードを実行してから、もう一度`/models`を確認してください。
最も信頼性の高いワークフローはシンプルです。pnpmでビルドし、1つのプロバイダーを認証し、/modelsを確認してゲートウェイを起動し、その後少しずつ拡張していきます。