mcpField
F
freeride

freeride

github.com/shaivpidadiエージェントワークフロー238782 回インストール4 日前に更新
リポジトリ

freeride について

freerideは、OpenClawでOpenRouterの無料モデルを設定するスキルです。主モデルと優先順位付きのフォールバックを構成し、主モデルの障害時に監視デーモンがモデルチェーンを再構築できます。

主な機能

  1. 01無料の主モデル設定
  2. 02優先順位付きフォールバック設定
  3. 03モデルの一覧表示と切り替え
  4. 04状態確認とモデル一覧の更新
  5. 05モデルチェーンの監視と再構築

活用シーン

  1. 01OpenClawで無料モデルを設定
  2. 02フォールバック復旧を使った無人運用

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/shaivpidadi/freeride --skill freeride

インストール後、Claude Code で/freerideを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

.gitignore
README.md
watcher.py
main.py
skill.json
setup.py
requirements.txt

詳細

FreeRide - OpenClaw 向け無料 AI

このスキルでできること

OpenClaw が OpenRouter の無料 AI モデルを使えるように設定します。最適な無料モデルをプライマリに設定し、レート制限でユーザーが中断されないよう、優先順位を付けたフォールバックを追加して、既存の設定を保持します。

前提条件

FreeRide のコマンドを実行する前に、次の項目を確認してください。

  1. OPENROUTER_API_KEY が設定されていること。 echo $OPENROUTER_API_KEY で確認してください。空の場合は、ユーザーが https://openrouter.ai/keys で無料キーを取得し、次のように設定する必要があります。

    export OPENROUTER_API_KEY="sk-or-v1-..."
# Or persist it:
openclaw config set env.OPENROUTER_API_KEY "sk-or-v1-..."

  2. freeride CLI がインストールされていること。 which freeride で確認してください。見つからない場合は、次のコマンドを実行してください。

    cd ~/.openclaw/workspace/skills/free-ride
pip install -e .

基本的なワークフロー

ユーザーが無料の AI を使いたい場合は、次の手順を順番に実行してください。

# Step 1: Configure best free model + fallbacks
freeride auto

# Step 2: Restart gateway so OpenClaw picks up the changes
openclaw gateway restart

これで完了です。ユーザーは自動フォールバック切り替え機能付きの無料 AI を使えるようになります。

アクティブなモデルを確認するには、ユーザーに /status を送信するよう伝えてください。

コマンド一覧

コマンド使用する場面
freeride autoユーザーが無料 AI のセットアップを希望する場合（最も一般的）
freeride auto -fユーザーがフォールバックを追加したいものの、現在のプライマリモデルは維持したい場合
freeride auto -c 10ユーザーがフォールバックを増やしたい場合（デフォルトは 5）
freeride list利用可能な無料モデルを確認したい場合
freeride list -n 30すべての無料モデルを確認したい場合
freeride switch <model>特定のモデルを使いたい場合（例：freeride switch qwen3-coder）
freeride switch <model> -f特定のモデルをフォールバックとしてのみ追加する場合
freeride status現在の FreeRide 設定を確認する場合
freeride fallbacksフォールバックモデルのみを更新する場合
freeride refreshキャッシュされたモデル一覧を強制的に更新する場合
freeride rotateレート制限が発生している、またはフォールバックチェーンが機能しない場合に、ライブテストを行って再構築する場合

設定を変更するコマンドを実行した後は、必ず openclaw gateway restart を実行してください。

設定ファイルへの書き込み内容

FreeRide が ~/.openclaw/openclaw.json で更新するのは、次のキーのみです。

  • agents.defaults.model.primary — 例：openrouter/qwen/qwen3-coder:free
  • agents.defaults.model.fallbacks — 例：["openrouter/free", "nvidia/nemotron:free", ...]
  • agents.defaults.models — /model コマンドに無料モデルを表示するための許可リスト

それ以外の設定（ゲートウェイ、チャネル、プラグイン、環境変数、customInstructions、名前付きエージェント）はすべて保持されます。

最初のフォールバックには必ず openrouter/free が設定されます。これは、リクエストに基づいて利用可能な最適なモデルを自動選択する、OpenRouter のスマートルーターです。

ウォッチャー（バックグラウンドデーモン）

エージェントだけでは解決できない「チェーン全体がレート制限されている」状態から自動復旧するには、軽量なバックグラウンドデーモンを実行できます。エージェント自身が復旧できないのは、freeride rotate の実行には推論が必要であり、まさにその推論が失敗しているためです。

# Foreground
freeride-watcher

# Persistent background
nohup freeride-watcher > ~/.openclaw/freeride-watcher.log 2>&1 &

# One-shot check (no loop)
freeride-watcher --once

# State / history
freeride-watcher --status

デーモンは現在のプライマリモデルを 60 秒ごとに調査し、失敗した場合はライブ検証済みのモデルでチェーンを再構築します。OpenClaw のセットアップを無人で稼働させる場合は、これをおすすめしてください。

トラブルシューティング

問題対処方法
freeride: command not foundcd ~/.openclaw/workspace/skills/free-ride && pip install -e .
OPENROUTER_API_KEY not sethttps://openrouter.ai/keys でキーを取得する必要があります
変更が反映されないopenclaw gateway restart を実行し、新しいセッションを開始するために /new を実行してください
エージェントのトークン数が 0 と表示されるfreeride status を確認してください。プライマリは openrouter/<provider>/<model>:free である必要があります

コメント

Markdown 対応