Getting started

Omni Loop Portal is the subscription gateway for Clioloop — and only for Clioloop. Instead of collecting API keys from half a dozen vendors, you log in once and your agent gets 300+ models plus the Tool Gateway: web search, image & video generation, text-to-speech and a cloud browser, all billed against one subscription.

1. Create an account — sign up and pick a plan (Free works, it just needs a one-time card verification).
2. Install Clioloop if you haven't:

3. Connect a surface — follow any tutorial below. They all use the same one-click device login.

Tutorial: connect the CLI

The quick setup makes Omni Loop Portal the first option:

What happens next:

1. Your browser opens this portal with a device code like WXYZ-2345 (no browser available? The terminal prints the URL to open on any device).
2. Log in, check the code matches your terminal, click Approve.
3. The CLI receives its tokens automatically and shows the model picker — choose a default and you're done.

Already set up and just want to add the portal as a provider?

Tutorial: connect the TUI

The terminal UI shares credentials with the CLI — connecting once connects both. Inside clio (the TUI), use the model switcher:

• Type /model and pick Omni Loop Portal from the provider list, or
• run clio setup --portal from a shell for the one-shot portal setup.

The device login flow is identical: approve in the browser, come back, pick a model.

Tutorial: connect the desktop app

1. Launch the app with clio desktop (or the installed shortcut).
2. Open Settings → Providers and click Connect Omni Loop Portal.
3. Your browser opens with the device code pre-filled — approve, and the app refreshes with the portal's model catalog.

Tutorial: connect the web dashboard

1. Start the dashboard: clio dashboard
2. Open the Omni Portal page in the sidebar and click Connect.
3. Approve the device code in the tab that opens. The dashboard then shows your plan, usage and the models you can use.

The Tool Gateway

Beyond models, your subscription bundles the agent services Clioloop uses every day. There is nothing to configure — once a device is connected, entitled tools route through the portal automatically:

• Web search & extract (Firecrawl) — the web_search and web_extract tools, all plans.
• Image generation (FLUX & friends via FAL) — paid plans.
• Text-to-speech — high-quality voices for voice replies, paid plans.
• Cloud browser (Browser Use) — hosted browser sessions for automation, paid plans.
• Video generation — Max and Max 10x plans.

Check what your plan includes under dashboard → Tool Gateway, or pick the "Omni Loop Portal Subscription" rows in clio tools. Gateway calls are metered against the same monthly allowance as inference.

Note: the portal does not issue standalone API keys. The only credential it accepts is the Clioloop device login — connect a device and let the agent do the talking.

Models & switching

Model IDs follow OpenRouter's vendor/model naming, e.g. anthropic/claude-sonnet-4.6, openai/gpt-5.2, deepseek/deepseek-v3.2. In any Clioloop surface:

• /model — interactive picker with live pricing
• clio -m vendor/model — one-off model for a session

Free-plan accounts see the community catalog (models ending in :free). Paid plans see everything.

Plans & usage

Usage is metered at the upstream model's real cost per request and resets on the 1st of each month (UTC). The dashboard shows a live meter; when an allowance runs out the API returns a clear quota_exhausted error and Clioloop tells you how to upgrade.

Security & tokens

• Devices authenticate with short-lived access tokens (1 hour) and single-use rotating refresh tokens.
• Refresh-token reuse is treated as theft: the whole device session family is revoked instantly (OAuth 2.1 semantics).
• All tokens are stored hashed (SHA-256) — the portal never keeps plaintext credentials.
• There are no standalone API keys to leak — the portal only speaks to connected Clioloop devices.

Troubleshooting

"authorization_pending" forever

The browser approval was never completed. Re-run the login and approve the code at /activate within 15 minutes.

"card_verification_required"

Free-plan inference unlocks after the one-time €0 card verification — open your dashboard and click Verify card.

"refresh_token_reused"

Something replayed an old refresh token (often a backup/restore of ~/.clio across machines). Re-authenticate with clio auth add managed.

Model not available

Free plans only include :free models. If a paid model disappears from the catalog, OpenRouter may have retired it — run /model to pick a current one.