polymech/zeroclaw
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
a37e3aa39b
zeroclaw/docs/getting-started
History
argenis de la rosa b313ce9bcb feat(onboarding): remove OpenRouter default, require explicit provider selection 
Breaking changes:
- Quick setup now requires --provider flag (no default)
- TUI wizard requires provider selection (no pre-selection)
- Docker compose requires PROVIDER env var
- .env.example no longer defaults to openrouter

Changes:
- wizard.rs: Remove hardcoded "openrouter" defaults, require explicit provider
- tui.rs: Add provider placeholder, require selection before proceeding
- .env.example: Use provider-neutral placeholders
- docker-compose.yml: Require PROVIDER to be explicitly set
- docs: Update examples to be provider-agnostic

This makes ZeroClaw truly provider-agnostic - users must choose
their preferred LLM provider rather than being pushed toward OpenRouter.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-05 15:01:40 -05:00
..
macos-update-uninstall.md feat(update): add install-aware guidance and safer self-update 2026-02-28 23:28:06 -05:00
README.md feat(onboarding): remove OpenRouter default, require explicit provider selection 2026-03-05 15:01:40 -05:00

README.md

Getting Started Docs

For first-time setup and quick orientation.

Start Path

  1. Main overview and quick start: ../../README.md
  2. One-click setup and dual bootstrap mode: ../one-click-bootstrap.md
  3. Update or uninstall on macOS: macos-update-uninstall.md
  4. Set up on Android (Termux/ADB): ../android-setup.md
  5. Find commands by tasks: ../commands-reference.md

Choose Your Path

Scenario Command
I have an API key, want fastest setup zeroclaw onboard --api-key sk-... --provider <provider>
I want guided prompts (TUI wizard) zeroclaw onboard --interactive
Config exists, just fix channels zeroclaw onboard --channels-only
Config exists, I intentionally want full overwrite zeroclaw onboard --force
Using OpenAI Codex subscription auth See OpenAI Codex OAuth Quick Setup

Supported providers: openrouter, openai, anthropic, gemini, ollama, groq, mistral, deepseek, xai, together-ai, fireworks, perplexity, cohere, and more.

Onboarding and Validation

  • Quick onboarding: zeroclaw onboard --api-key "sk-..." --provider <provider>
  • Interactive onboarding (recommended): zeroclaw onboard --interactive
  • Existing config protection: reruns require explicit confirmation (or --force in non-interactive flows)
  • Ollama cloud models (:cloud) require a remote api_url and API key (for example api_url = "https://ollama.com").
  • Validate environment: zeroclaw status + zeroclaw doctor

OpenAI Codex OAuth Quick Setup

Use this path when you want openai-codex with subscription OAuth credentials (no API key required).

  1. Authenticate:
zeroclaw auth login --provider openai-codex
  1. Verify auth material is loaded:
zeroclaw auth status --provider openai-codex
  1. Set provider/model defaults:
default_provider = "openai-codex"
default_model = "gpt-5.3-codex"
default_temperature = 0.2

[provider]
transport = "auto"
reasoning_level = "high"
  1. Optional stable fallback model (if your account/region does not currently expose gpt-5.3-codex):
default_model = "gpt-5.2-codex"
  1. Start chat:
zeroclaw chat

Notes:

  • You do not need to define a custom [model_providers."openai-codex"] block for normal OAuth usage.
  • If you see raw <tool_call> tags in output, first verify you are on the built-in openai-codex provider path above and not a custom OpenAI-compatible provider override.

Next