Settings — ɳClaw Desktop

Settings

Open Settings with Cmd+, (macOS) or from the system tray menu. A left sidebar gives access to five sections.

Provider

Pick the AI backend that ɳClaw routes requests through.

Option	Description
Local (llama.cpp)	Runs models on your machine — no internet needed
Ollama sidecar	Uses a local Ollama process
OpenAI	Cloud API — requires an API key
Anthropic	Cloud API — requires an API key
OpenRouter	Aggregator API — requires an API key

Enter the API base URL for your setup (pre-filled with sensible defaults). For cloud providers, paste your API key — it is sent directly to the backend for secure storage and is never displayed in full again. After saving, only the last four characters are shown as a confirmation hint.

Model

Assign specific models to four roles that ɳClaw uses internally:

• Chat — primary conversational model
• Summarizer — compresses context and labels topics
• Embedder — generates vectors for memory search
• Code — code generation and explanation

A tier badge shows whether each selection is auto-detected from your hardware profile or manually overridden. Leave a role on Auto to let ɳClaw pick the best fit for your device.

Vault

ɳClaw stores encryption keys in your OS keychain (macOS Keychain, Windows Credential Manager, or libsecret on Linux). This section shows whether the current device is paired.

Tap Re-pair device to generate a new keypair and register it with the keychain. Confirm the prompt — re-pairing is irreversible and requires re-syncing any encrypted data from your server.

Sync

Connect ɳClaw to your self-hosted nSelf server to back up memory and sync across devices.

1. Enter your nSelf server URL.
2. Paste your license key (it is masked on save).
3. Tap Test connection — a toast confirms success or failure.
4. Save to persist.

Your license key is passed to the backend for encrypted storage. The frontend never retains the raw value.

Advanced

Setting	Default	Description
Log level	info	Verbosity of the local log file. Restart required.
Telemetry	On	Anonymous crash and usage reporting. Opt out anytime.
Check for updates	On	Checks for new ɳClaw Desktop releases on startup.