lhc models
Manage Lakehousecat custom models. Custom models combine a provider base model with your datasources.
Commands
models list
lhc models list [--type <type>] [--limit N] [--offset N]
| Flag | Default | Description |
|---|---|---|
--type | — | Filter by model type: chat, embedding, text-to-speech, speech-to-text |
--limit | 50 | Maximum number of models |
--offset | 0 | Pagination offset |
models get <id>
lhc models get <model-id>
models create
Creates either a Provider Model (wraps an external LLM provider) or a Custom Model (combines a Provider Model with datasources). Exactly one of --provider-type or --base-model-id must be provided.
Provider Model — wraps an LLM provider endpoint:
lhc models create \
--id <model-id> \
--name <display-name> \
--provider-type Azure \
--provider-model-type Chat
Custom Model — built on top of a Provider Model, optionally with datasources:
lhc models create \
--id <model-id> \
--name <display-name> \
--base-model-id <provider-model-id> \
[--type chat] \
[--datasource-id 1223] \
[--datasource-id 1224]
| Flag | Required | Default | Description |
|---|---|---|---|
--id | yes | — | Unique identifier (letters, digits, underscores, hyphens) |
--name | yes | — | Display name shown in the UI |
--provider-type | one of* | — | Provider type for a Provider Model, e.g. Azure, OpenAI |
--provider-model-type | no | — | Provider model type, e.g. Chat, Embedding, Audio |
--base-model-id | one of* | — | ID of the Provider Model (for a Custom Model) |
--type | no | chat | Model type: chat, embedding, text-to-speech, speech-to-text |
--datasource-id | no | — | Datasource ID to link (repeatable, Custom Model only) |
* Exactly one of --provider-type or --base-model-id is required.
Use lhc models list to find available --base-model-id values. Only Admins can create Provider Models.
models update <id>
Update a custom model's name, state, or configuration:
# Rename
lhc models update <model-id> --name "New Name"
# Replace linked datasources (replaces the full list)
lhc models update <model-id> --datasource-id 1223 --datasource-id 456
# Enable Agent Mode (routes chat to LHC Agent / OpenClaw)
lhc models update <model-id> --agent-enabled=true
# Disable and lock a model
lhc models update <model-id> --is-enabled=false --is-locked=true
# Configure prompt suggestion visibility
lhc models update <model-id> --show-global-suggestions=true --show-model-suggestions=false
| Flag | Description |
|---|---|
--name | New display name |
--datasource-id | Set linked datasource IDs (repeatable — replaces the existing list) |
--agent-enabled | Route chat requests to the LHC Agent service (OpenClaw) instead of the LLM directly |
--is-enabled | Enable (true) or disable (false) the model — disabled models are unavailable for use |
--is-locked | Lock (true) or unlock (false) the model — locked models cannot be edited or deleted |
--is-visible | Control model visibility |
--show-global-suggestions | Display globally configured prompt suggestions for this model |
--show-model-suggestions | Display suggestions defined specifically for this model |
--show-datasource-suggestions | Display prompt suggestions from connected datasources |
At least one flag must be provided. Flags accept =true or =false syntax (e.g. --is-locked=false).
models delete <id>
lhc models delete <model-id>
models set-default <id>
Set a model as the default for its type. This controls which model is pre-selected in new sessions:
lhc models set-default <model-id> --type chat
| Flag | Required | Description |
|---|---|---|
--type | yes | Model type: chat, embedding, text-to-speech, speech-to-text |
models export <id>
Export a custom model definition to a portable .lhc.json file. Embedded datasource references are included:
# Print to stdout
lhc models export <model-id>
# Write to file
lhc models export <model-id> -f model.lhc.json
| Flag | Description |
|---|---|
-f, --output-file | Write output to this file (default: stdout) |
models import <file>
Import a model from a .lhc.json export file:
lhc models import model.lhc.json [--name <override-name>]
| Flag | Description |
|---|---|
--name | Override the model name from the export file |
If a model with the same name or ID already exists, the import is aborted with an HTTP 409 error and instructions for resolution.