docs: add safe PowerShell provider switching example

[Yeachan-Heo]

Summary

Discord feedback in UltraWorkers #claw-code shared a community PowerShell provider/API-key switcher for Claw Code and asked whether it can become a docs example. This is a real provider-switching UX/documentation gap: users currently have to juggle env vars manually, which is sharp-edged and easy to misconfigure.

Suggested docs scope

Add a documentation page/section such as Provider switching examples or PowerShell provider profile helper example.

The docs should frame this as an example/recipe users can copy and adapt, not as an audited official provider manager.

Recommended two-mode shape:

1. Session-only switch
   - sets env vars only for the current shell/process
   - default safe mode
   - does not persist secrets
   - does not launch unless explicitly requested

2. Persistent profile switch
   - named provider profiles
   - explicit confirmation before saving
   - secrets stored in OS credential storage where possible
   - never echoes API keys

Safety requirements for the example

- default to NoLaunch / DryRun
- never print saved API keys back to terminal
- prefer Windows Credential Manager / DPAPI over plain saved files if possible
- validate provider base URL + model id before launch
- show exact env vars/config fields that change, with secrets redacted
- smoke test with a tiny prompt like “Reply exactly HELLO” before claiming success
- clearly mark attached/community scripts as examples, not audited installers

Source context

Discord thread: a user shared Switch-ClawProvider.ps1 and asked to make it a doc example with the safety bits / two modes above.

Acceptance criteria

• Docs explain session-only vs persistent provider switching.
• Windows/PowerShell example is safe-by-default and redacts secrets.
• Docs include a minimal smoke-test step before launch/trust.
• Docs clarify the example is adaptable and not a blessed audited credential manager.

—
[repo owner's gaebal-gajae (clawdbot) 🦞]

[roflsunriz]

This is example file:
Switch-ClawProvider.example.ps1.txt

How to use:

# List display
.\Switch-ClawProvider.example.ps1 -List

# Confirm only changes
.\Switch-ClawProvider.example.ps1 -Provider openrouter -Model openai/gpt-oss-120b -DryRun

# Switch session only, claw not started
.\Switch-ClawProvider.example.ps1 -Provider openrouter -Model openai/gpt-oss-120b

# Switch session only and smoke test
.\Switch-ClawProvider.example.ps1 -Provider groq -Model openai/gpt-oss-120b -SmokeTest

# Switch session only and start claw
.\Switch-ClawProvider.example.ps1 -Provider local -Model openai/gpt-oss-20b-Q8_0 -Launch

# Persistently save to User environment variables and start claw
.\Switch-ClawProvider.example.ps1 -Provider openai -Model gpt-5.1 -Persist -Launch