Model Config

Model Config

For X-OmniClaw, model configuration is stored in:

• /sdcard/.xomniclaw/xomniclaw.json

Relevant paths:

• agent.defaultModel
• models.providers.<providerName>.baseUrl
• models.providers.<providerName>.apiKey
• models.providers.<providerName>.api
• models.providers.<providerName>.authHeader
• models.providers.<providerName>.models

Workflow

1. Read /sdcard/.xomniclaw/xomniclaw.json first.
2. Check current agent.defaultModel and existing providers under models.providers.
3. If the target provider already exists, update only the necessary fields.
4. If the target provider does not exist, create a provider entry under models.providers.
5. For self-hosted or other OpenAI-compatible endpoints, add a new models.providers.<yourKey> entry (any stable key name) with:
   • api: "openai-completions"
   • provider-specific baseUrl
   • apiKey
   • one or more model entries in models
6. Update agent.defaultModel to the requested model.
7. Preserve unrelated providers and settings.
8. If asked to verify, send a simple test prompt after config is saved.

Notes

• Do not overwrite the full config if only one provider/model needs to change.
• If the user provides a compatible endpoint/key, add it as a new provider block under models.providers with api: "openai-completions" (or another supported API type per app).
• Keep model IDs exact.