Provider Commands

Manage inference providers (LLM APIs) for claw instances.

clm provider <command> [options]

Providers are configured locally in ~/.config/clawrium/providers.json. API keys and AWS credentials are stored securely in ~/.config/clawrium/secrets.yml and are never transmitted in plain text.

Provider Types: Most providers use API keys for authentication. AWS Bedrock requires AWS Access Key and Secret Key instead.

Commands

Command	Description
clm provider add	Add a new inference provider
clm provider list	List all configured providers
clm provider edit	Edit an existing provider
clm provider remove	Remove a provider
clm provider types	List supported provider types
clm provider models	List available models for a provider
clm provider refresh	Refresh Ollama models

---

clm provider add

Add a new inference provider.

clm provider add <name> --type <type> [options]

API keys are collected securely via interactive prompt (not visible in process listing).

Arguments

Argument	Description
name	Unique name for this provider configuration

Options

Option	Short	Description
--type	-t	Provider type (required): openai, anthropic, openrouter, bedrock, vertex, zai, ollama
--model	-m	Default model to use
--url	-u	Server URL (required for Ollama)

Examples

Add an OpenAI provider:

$ clm provider add myopenai --type openai
API key: ********
Available models for openai:
  1. gpt-4o
  2. gpt-4o-mini
  3. gpt-4-turbo
Select default model (number or name): 1
Provider 'myopenai' added successfully!

Add an Anthropic provider with a specific model:

$ clm provider add work-claude --type anthropic --model claude-sonnet-4-20250514
API key: ********
Provider 'work-claude' added successfully!

Add a local Ollama provider:

$ clm provider add local-llm --type ollama --url http://myserver.example.com:11434
Connecting to Ollama server at http://myserver.example.com:11434...
Found 3 models
Available models:
  1. llama3.2:latest
  2. mistral:latest
  3. codellama:latest
Select default model (number or name): 1
Provider 'local-llm' added successfully!

Add an AWS Bedrock provider:

$ clm provider add my-bedrock --type bedrock
AWS Bedrock requires Access Key and Secret Key
AWS Access Key ID: ********
**
AWS Secret Access Key: ********
**
Available models for bedrock:
  1. anthropic.claude-opus-4-20250514-v1:0
  2. anthropic.claude-sonnet-4-20250514-v1:0
  3. anthropic.claude-3-5-sonnet-20241022-v2:0
Select default model (number or name): 2
Provider 'my-bedrock' added successfully!

Note: The ** shown after entering credentials provides visual confirmation that the paste was successful, since the input is hidden.

Exit Codes

Code	Meaning
0	Provider added successfully or operation cancelled
1	Invalid name, invalid type, duplicate provider, or connection failed

---

clm provider list

List all configured providers.

clm provider list

Displays a table of all configured providers with masked API keys.

Example

$ clm provider list
                    Configured Providers
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
┃ Name         ┃ Type      ┃ Model            ┃ API Key           ┃ Added      ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ myopenai     │ openai    │ gpt-4o           │ sk-p...4xYz       │ 2026-04-01 │
│ work-claude  │ anthropic │ claude-sonnet-4  │ sk-a...9abc       │ 2026-04-02 │
│ local-llm    │ ollama    │ llama3.2:latest  │ http://myserver.. │ 2026-04-03 │
└──────────────┴───────────┴──────────────────┴───────────────────┴────────────┘

No providers configured:

$ clm provider list
No providers configured. Use 'clm provider add' to add a provider.

Exit Codes

Code	Meaning
0	Providers listed successfully
1	Providers file corrupted

---

clm provider edit

Edit an existing provider configuration.

clm provider edit <name> [options]

Arguments

Argument	Description
name	Provider name to edit

Options

Option	Short	Description
--model	-m	New default model
--url	-u	New server URL (Ollama only)
--update-key		Update API key (will prompt securely)

Examples

Change default model:

$ clm provider edit myopenai --model gpt-4o-mini
Provider 'myopenai' updated successfully!

Update Ollama server URL:

$ clm provider edit local-llm --url http://newserver.example.com:11434
Connecting to Ollama server at http://newserver.example.com:11434...
Found 5 models
Provider 'local-llm' updated successfully!

Update API key:

$ clm provider edit myopenai --update-key
New API key: ********
API key updated.
Provider 'myopenai' updated successfully!

Update AWS Bedrock credentials:

$ clm provider edit my-bedrock --update-key
AWS Bedrock requires Access Key and Secret Key
New AWS Access Key ID: ********
**
New AWS Secret Access Key: ********
**
AWS credentials updated.
Provider 'my-bedrock' updated successfully!

Exit Codes

Code	Meaning
0	Provider updated successfully or no changes specified
1	Provider not found, invalid URL, or connection failed

---

clm provider remove

Remove a provider configuration.

clm provider remove <name> [--force]

Arguments

Argument	Description
name	Provider name to remove

Options

Option	Short	Description
--force	-f	Skip confirmation prompt

Examples

$ clm provider remove myopenai
Remove provider 'myopenai'? This cannot be undone. [y/N]: y
Provider 'myopenai' removed successfully.

Force removal:

$ clm provider remove old-provider --force
Provider 'old-provider' removed successfully.

Exit Codes

Code	Meaning
0	Provider removed successfully or operation cancelled
1	Provider not found or removal failed

---

clm provider types

List supported provider types.

clm provider types

Example

$ clm provider types
Supported provider types:

  anthropic - 4 models
  bedrock - 6 models (SDK-based)
  ollama - Self-hosted (dynamic model discovery)
  openai - 5 models
  openrouter - 10 models
  vertex - 4 models (SDK-based)
  zai - 2 models

---

clm provider models

List available models for a provider type or configured provider.

clm provider models <identifier>

Arguments

Argument	Description
identifier	Provider type (openai, anthropic, etc.) or provider name

Note: Provider types take precedence over configured provider names.

Examples

List models for a provider type:

$ clm provider models openai
Available models for openai:

  gpt-4o
  gpt-4o-mini
  gpt-4-turbo
  gpt-4
  gpt-3.5-turbo

List models from a configured Ollama provider:

$ clm provider models local-llm
Models on 'local-llm' (Ollama):

  llama3.2:latest
  mistral:latest
  codellama:latest

Exit Codes

Code	Meaning
0	Models listed successfully
1	Invalid identifier or providers file corrupted

---

clm provider refresh

Refresh available models from an Ollama server.

clm provider refresh <name>

Re-fetches the model list from the Ollama server and updates the saved configuration.

Arguments

Argument	Description
name	Ollama provider name to refresh

Example

$ clm provider refresh local-llm
Connecting to Ollama server at http://myserver.example.com:11434...
Found 5 models

Provider 'local-llm' updated with 5 models:
  llama3.2:latest
  mistral:latest
  codellama:latest
  phi3:latest
  gemma:latest

Exit Codes

Code	Meaning
0	Provider refreshed successfully
1	Provider not found, not Ollama type, or connection failed