feat(config): add multi-AI model support with ai[0-9]- slots

- Support for up to 11 AI models simultaneously (1 primary + 10 slots)
- Added ai[0-9]-{provider,model,api-key} configuration options (30 new options)
- Enhanced generate_config() to create multiple auth profiles with unique IDs
- Enhanced validate_config() to validate all AI model slots comprehensively
- Updated documentation with multi-AI model examples and troubleshooting

Configuration:
- Primary model: ai-provider, ai-model, ai-api-key (unchanged)
- Additional slots: ai0-provider through ai9-provider (and model/api-key)
- Each slot requires all 3 parameters if any is configured

Implementation:
- Auth profiles generated with IDs like 'google:manual' (primary) and 'anthropic:slot0' (additional)
- Validation ensures complete configuration per slot
- Detects partial configurations and invalid providers
- Supports anthropic, openai, google, bedrock, ollama providers

Testing:
✓ Successfully generated auth-profiles.json with 3 models (google + anthropic + openai)
✓ Validation correctly rejects partial configurations
✓ Validation correctly rejects invalid provider names
✓ All profiles appear in auth-profiles.json with correct structure

Files modified:
- config.yaml: Added 30 new config options for ai0-ai9 slots
- hooks/common.sh: Updated generate_config() and validate_config()
- README.md: Added multi-AI model configuration section
- FAQ.md: Added multi-AI model FAQ entry
- docs/index.html: Updated web documentation with multi-model support

Author: fourdollars

FAQ.md

@@ -359,6 +359,39 @@ juju config openclaw \
 
 ---
 
+### How do I configure multiple AI models?
+
+OpenClaw Charm supports up to 11 AI models simultaneously (1 primary + 10 additional slots):
+
+```bash
+# Configure primary AI model
+juju config openclaw \
+  ai-provider="anthropic" \
+  ai-api-key="sk-ant-xxx" \
+  ai-model="claude-opus-4-5"
+
+# Add additional models in slots 0-9
+juju config openclaw \
+  ai0-provider="openai" \
+  ai0-model="gpt-4" \
+  ai0-api-key="sk-xxx"
+
+juju config openclaw \
+  ai1-provider="google" \
+  ai1-model="gemini-2.0-flash" \
+  ai1-api-key="YOUR-GEMINI-KEY"
+```
+
+**Important:** Each slot requires all three parameters (provider, model, api-key). Partial configuration will fail validation.
+
+**Verify configuration:**
+```bash
+# Check all configured models
+juju ssh openclaw/0 'cat /home/ubuntu/.openclaw/agents/main/agent/auth-profiles.json | jq .'
+```
+
+---
+
 ## Troubleshooting
 
 ### The gateway service won't start

README.md

@@ -115,6 +115,50 @@ juju config openclaw \
   ai-model="llama3"
 ```
 
+### Multi-AI Model Support
+
+OpenClaw Charm supports configuring up to 11 AI models simultaneously (1 primary + 10 additional slots). This enables model switching, fallback, and specialized model usage for different tasks.
+
+**Configure Additional AI Models**
+```bash
+# Configure primary AI model
+juju config openclaw \
+  ai-provider="anthropic" \
+  ai-api-key="sk-ant-xxx" \
+  ai-model="claude-opus-4-5"
+
+# Add additional models in slots 0-9
+juju config openclaw \
+  ai0-provider="openai" \
+  ai0-model="gpt-4" \
+  ai0-api-key="sk-xxx"
+
+juju config openclaw \
+  ai1-provider="google" \
+  ai1-model="gemini-2.0-flash" \
+  ai1-api-key="YOUR-GEMINI-API-KEY"
+
+juju config openclaw \
+  ai2-provider="anthropic" \
+  ai2-model="claude-sonnet-4" \
+  ai2-api-key="sk-ant-yyy"
+```
+
+**All AI Slots**
+- Primary: `ai-provider`, `ai-model`, `ai-api-key`
+- Slot 0: `ai0-provider`, `ai0-model`, `ai0-api-key`
+- Slot 1: `ai1-provider`, `ai1-model`, `ai1-api-key`
+- Slot 2: `ai2-provider`, `ai2-model`, `ai2-api-key`
+- Slot 3: `ai3-provider`, `ai3-model`, `ai3-api-key`
+- Slot 4: `ai4-provider`, `ai4-model`, `ai4-api-key`
+- Slot 5: `ai5-provider`, `ai5-model`, `ai5-api-key`
+- Slot 6: `ai6-provider`, `ai6-model`, `ai6-api-key`
+- Slot 7: `ai7-provider`, `ai7-model`, `ai7-api-key`
+- Slot 8: `ai8-provider`, `ai8-model`, `ai8-api-key`
+- Slot 9: `ai9-provider`, `ai9-model`, `ai9-api-key`
+
+Each slot requires all three parameters (provider, model, api-key) to be configured. Partially configured slots will trigger validation errors.
+
 ### Messaging Channels
 
 **Enable Telegram**
@@ -181,6 +225,9 @@ juju config openclaw log-level="debug"
 | `ai-provider` | string | - | AI provider: anthropic, openai, google, bedrock, ollama |
 | `ai-model` | string | - | AI model name |
 | `ai-api-key` | string | - | API key for selected provider |
+| `ai0-provider` ... `ai9-provider` | string | - | Additional AI provider slots (0-9) |
+| `ai0-model` ... `ai9-model` | string | - | Additional AI model name slots (0-9) |
+| `ai0-api-key` ... `ai9-api-key` | string | - | Additional AI API key slots (0-9) |
 | `telegram-bot-token` | string | - | Telegram bot token from @BotFather |
 | `discord-bot-token` | string | - | Discord bot token |
 | `slack-bot-token` | string | - | Slack bot token (xoxb-...) |

config.yaml

@@ -36,6 +36,157 @@ options:
       For OpenAI: OpenAI API key
       For Google: Google Gemini API key
   
+  # Additional AI models (ai0 through ai9) for multi-model support
+  ai0-provider:
+    type: string
+    default: ""
+    description: AI provider for model slot 0 (anthropic, openai, google, bedrock, ollama)
+  
+  ai0-model:
+    type: string
+    default: ""
+    description: AI model name for slot 0
+  
+  ai0-api-key:
+    type: string
+    default: ""
+    description: API key for AI model slot 0
+  
+  ai1-provider:
+    type: string
+    default: ""
+    description: AI provider for model slot 1 (anthropic, openai, google, bedrock, ollama)
+  
+  ai1-model:
+    type: string
+    default: ""
+    description: AI model name for slot 1
+  
+  ai1-api-key:
+    type: string
+    default: ""
+    description: API key for AI model slot 1
+  
+  ai2-provider:
+    type: string
+    default: ""
+    description: AI provider for model slot 2 (anthropic, openai, google, bedrock, ollama)
+  
+  ai2-model:
+    type: string
+    default: ""
+    description: AI model name for slot 2
+  
+  ai2-api-key:
+    type: string
+    default: ""
+    description: API key for AI model slot 2
+  
+  ai3-provider:
+    type: string
+    default: ""
+    description: AI provider for model slot 3 (anthropic, openai, google, bedrock, ollama)
+  
+  ai3-model:
+    type: string
+    default: ""
+    description: AI model name for slot 3
+  
+  ai3-api-key:
+    type: string
+    default: ""
+    description: API key for AI model slot 3
+  
+  ai4-provider:
+    type: string
+    default: ""
+    description: AI provider for model slot 4 (anthropic, openai, google, bedrock, ollama)
+  
+  ai4-model:
+    type: string
+    default: ""
+    description: AI model name for slot 4
+  
+  ai4-api-key:
+    type: string
+    default: ""
+    description: API key for AI model slot 4
+  
+  ai5-provider:
+    type: string
+    default: ""
+    description: AI provider for model slot 5 (anthropic, openai, google, bedrock, ollama)
+  
+  ai5-model:
+    type: string
+    default: ""
+    description: AI model name for slot 5
+  
+  ai5-api-key:
+    type: string
+    default: ""
+    description: API key for AI model slot 5
+  
+  ai6-provider:
+    type: string
+    default: ""
+    description: AI provider for model slot 6 (anthropic, openai, google, bedrock, ollama)
+  
+  ai6-model:
+    type: string
+    default: ""
+    description: AI model name for slot 6
+  
+  ai6-api-key:
+    type: string
+    default: ""
+    description: API key for AI model slot 6
+  
+  ai7-provider:
+    type: string
+    default: ""
+    description: AI provider for model slot 7 (anthropic, openai, google, bedrock, ollama)
+  
+  ai7-model:
+    type: string
+    default: ""
+    description: AI model name for slot 7
+  
+  ai7-api-key:
+    type: string
+    default: ""
+    description: API key for AI model slot 7
+  
+  ai8-provider:
+    type: string
+    default: ""
+    description: AI provider for model slot 8 (anthropic, openai, google, bedrock, ollama)
+  
+  ai8-model:
+    type: string
+    default: ""
+    description: AI model name for slot 8
+  
+  ai8-api-key:
+    type: string
+    default: ""
+    description: API key for AI model slot 8
+  
+  ai9-provider:
+    type: string
+    default: ""
+    description: AI provider for model slot 9 (anthropic, openai, google, bedrock, ollama)
+  
+  ai9-model:
+    type: string
+    default: ""
+    description: AI model name for slot 9
+  
+  ai9-api-key:
+    type: string
+    default: ""
+    description: API key for AI model slot 9
+  
   telegram-bot-token:
     type: string
     default: ""

docs/index.html

@@ -503,10 +503,19 @@ <h1>Juju Charm for<br><span class="gradient-text">OpenClaw</span></h1>
 juju deploy openclaw
 
 # Configure with your AI provider
-juju config openclaw anthropic-api-key="your-key-here"
+juju config openclaw \
+  ai-provider="anthropic" \
+  ai-api-key="your-key-here" \
+  ai-model="claude-opus-4-5"
 
 # Enable messaging platforms
-juju config openclaw telegram-bot-token="your-token"</code></pre>
+juju config openclaw telegram-bot-token="your-token"
+
+# Optional: Configure additional AI models (up to 11 total)
+juju config openclaw \
+  ai0-provider="openai" \
+  ai0-model="gpt-4" \
+  ai0-api-key="your-openai-key"</code></pre>
                 </div>
             </div>
         </section>
@@ -532,7 +541,7 @@ <h3>Multi-Platform Messaging</h3>
                     <div class="feature-card">
                         <div class="feature-icon">🤖</div>
                         <h3>AI Provider Flexibility</h3>
-                        <p>Works with Anthropic Claude, OpenAI, AWS Bedrock, or local models via Ollama.</p>
+                        <p>Configure up to 11 AI models simultaneously. Works with Anthropic Claude, OpenAI, Google Gemini, AWS Bedrock, or local models via Ollama.</p>
                     </div>
 
                     <div class="feature-card">
@@ -593,8 +602,8 @@ <h3>Deploy the Charm</h3>
                         <div class="step-number">2</div>
                         <div class="step-content">
                             <h3>Configure AI Provider</h3>
-                            <p>Set up your AI model credentials (Anthropic, OpenAI, etc.)</p>
-                            <code>juju config openclaw \<br>  anthropic-api-key="sk-ant-xxx" \<br>  ai-model="claude-opus-4-5"</code>
+                            <p>Set up your AI model credentials (Anthropic, OpenAI, Google, etc.)</p>
+                            <code>juju config openclaw \<br>  ai-provider="anthropic" \<br>  ai-api-key="sk-ant-xxx" \<br>  ai-model="claude-opus-4-5"</code>
                         </div>
                     </div>
 
@@ -630,19 +639,27 @@ <h3>🤖 AI Configuration</h3>
                         <dl>
                             <div class="config-option">
                                 <dt>ai-provider</dt>
-                                <dd>Primary AI provider: anthropic, openai, bedrock, ollama</dd>
+                                <dd>Primary AI provider: anthropic, openai, google, bedrock, ollama</dd>
                             </div>
                             <div class="config-option">
                                 <dt>ai-model</dt>
                                 <dd>Model to use (e.g., claude-opus-4-5, gpt-4)</dd>
                             </div>
                             <div class="config-option">
-                                <dt>anthropic-api-key</dt>
-                                <dd>Anthropic API key for Claude models</dd>
+                                <dt>ai-api-key</dt>
+                                <dd>API key for the selected AI provider</dd>
+                            </div>
+                            <div class="config-option">
+                                <dt>ai[0-9]-provider</dt>
+                                <dd>Additional AI provider slots (0-9) for multi-model support</dd>
+                            </div>
+                            <div class="config-option">
+                                <dt>ai[0-9]-model</dt>
+                                <dd>Model name for additional AI slots (0-9)</dd>
                             </div>
                             <div class="config-option">
-                                <dt>openai-api-key</dt>
-                                <dd>OpenAI API key</dd>
+                                <dt>ai[0-9]-api-key</dt>
+                                <dd>API key for additional AI slots (0-9)</dd>
                             </div>
                         </dl>
                     </div>