Model Migration Skill

Help the user migrate OpenClaw from Claude subscription OAuth to a free or cheap provider.

When to use this skill

• User says Claude is blocked, not working, or requires "extra usage"
• User mentions the April 2026 Anthropic harness policy change
• User wants to switch to Gemini, OpenRouter, Ollama, or any non-Claude provider
• User asks "how do I use OpenClaw without Claude?"

Step 1 — Diagnose

Read the current config and identify what's broken:

cat ~/.openclaw/openclaw.json | python3 -c "
import json,sys
d=json.load(sys.stdin)
auth = d.get('auth',{})
profiles = auth.get('profiles',{})
model = d.get('agents',{}).get('defaults',{}).get('model',{}).get('primary','not set')
print('Current model:', model)
for name, p in profiles.items():
    print(f'Auth profile: {name} provider={p.get(\"provider\")} mode={p.get(\"mode\")}')
"

If you see provider=anthropic mode=oauth — that's the blocked profile. Proceed.

Step 2 — Recommend a path

Ask the user one question: "Do you want free (no cost) or are you okay with a small per-token charge for better quality?"

Free path (recommended for most users)

→ OpenRouter free tier — no credit card, no cost

Best free models right now:

• openrouter/free — auto-picks the best free model (zero config)
• openrouter/meta-llama/llama-3.3-70b-instruct:free — strong general model
• openrouter/qwen/qwen3-coder:free — best free coding model (262k context)
• openrouter/qwen/qwen3.6-plus:free — 1M context, free

Cheap paid path ($0.10/MTok — roughly $1–5/month for typical use)

• openrouter/google/gemini-2.5-flash-lite — Google's fast model, 1M context
• openrouter/google/gemini-2.0-flash-001 — excellent quality/price
• openrouter/meta-llama/llama-3.3-70b-instruct — same as free but reliable

Free + local path (privacy-first)

→ Ollama — runs on the user's machine, zero cost, fully private

Free direct (Gemini API)

→ Google AI Studio free tier — check current limits at aistudio.google.com (varies by account/region)

Step 3 — Migrate using OpenClaw CLI (preferred)

Use native OpenClaw commands — openclaw onboard creates the auth profile and config in one shot:

# 1. Add your provider (example: OpenRouter free)
openclaw onboard --non-interactive --accept-risk --auth-choice openrouter-api-key --openrouter-api-key YOUR_OPENROUTER_KEY --skip-channels --skip-skills --skip-search --skip-daemon --skip-health --skip-ui

# 2. Set a free model
openclaw models set openrouter/qwen/qwen3.6-plus:free

# 3. Restart
openclaw gateway restart

Or use the interactive auth helper:

openclaw models auth login --provider openrouter
# (follow prompts to paste your key)
openclaw models set openrouter/qwen/qwen3.6-plus:free
openclaw gateway restart

Get a free OpenRouter key at https://openrouter.ai/keys (no credit card required).

Step 4 — Manual config (if wizard doesn't work)