Configuration
The Configuration panel is a six-category settings hub. It manages platform behavior, provider routing, shield controls, access settings, integrations, and system maintenance from collapsible cards that can be deep-linked from elsewhere in the dashboard.
Configuration Categories
| Category | What It Covers |
|---|---|
| AI & Models | Model Providers, model pricing sync, model defaults, and LiteLLM configuration state |
| Fleet & Routing | OpenClaw routing, gateway instances, and provider routing status |
| Shield & Detection | Shield settings, detection behavior, CVE sync, and Host Security scanner status |
| Access Control | RBAC sessions, operators, auth methods, API keys, and break-glass controls |
| Integrations | Mail delivery, GitHub OAuth, and external service configuration |
| System | UI preferences, data retention, updates, backups, and runtime maintenance |
Important Cards
- Model Providers — manage local and cloud LLM provider connections.
- OpenClaw Routing — show provider routing status as ROUTED or DIRECT and wire traffic through LiteLLM when available.
- Updates — refresh ClawNex Shield Rules status, Host Security scanner metadata, model pricing, and other bundled/update-aware components.
- Shield Settings — configure shield mode and enforcement behavior.
- CVE Database — sync current CVE and GitHub advisory feeds for correlation.
- Authentication Methods — configure local auth, passkeys, GitHub OAuth, and Magic Link availability.
- Mail Configuration — configure Resend, SMTP, or Emailit for Magic Link delivery.
- Session Settings — configure session timeout and concurrent session limits when RBAC is enabled.
- Operator Management — create, edit, deactivate, and role operators when RBAC is enabled.
- API Keys — create, list, and revoke keys for the public API.
- Data Retention — configure how long each data category is kept.
Deep Linking
When you arrive at Configuration via a deep link, the target card auto-expands and scrolls into view. The Welcome Wizard uses this to send operators directly to Model Providers, routing, updates, and other setup tasks.
Provider Sync Behavior
Saving provider or model changes updates litellm/config.yaml. If LiteLLM needs to reload the new configuration, the dashboard shows a restart-required banner and the Infrastructure panel exposes the LiteLLM restart action.
Data Retention Defaults
| Category | Default | Options |
|---|---|---|
| Traffic Logs | 3 days | 1d, 3d, 7d, 14d, 30d, 90d |
| System Metrics | 3 days | 1d, 3d, 7d, 14d, 30d, 90d |
| Correlations | 3 days | 1d, 3d, 7d, 14d, 30d, 90d |
| Alerts & Incidents | 90 days | 30d, 90d, 180d, 365d |
| Audit Trail | 365 days | 90d, 180d, 365d, Unlimited |