refactor(config): migrate messenger config to platform-specific tokens

BREAKING CHANGE: Configuration structure updated for multi-platform support

Old structure (deprecated):
  messenger:
    bot-token: <token>
    app-token: <token>

New structure (required):
  telegram-bot-token: <token>
  discord-bot-token: <token>
  slack-bot-token: <token>
  slack-app-token: <token>

Benefits:
- Enables multiple messaging platforms to run simultaneously
- Clearer, more intuitive configuration naming
- Platform-specific tokens better reflect actual platform APIs
- Improved security: tokens only loaded for enabled platforms

Migration guide:
- Telegram: messenger.bot-token → telegram-bot-token
- Discord: Create new discord-bot-token config
- Slack: messenger.bot-token → slack-bot-token, messenger.app-token → slack-app-token
- Update any scripts using the old config structure

Files changed:
- config.yaml: Added platform-specific token options
- hooks/common.sh: Updated create_openclaw_config() and validate_config()
- Documentation: Updated README, FAQ, GETTING_STARTED, and docs/index.html
- CI/CD: Updated test.yaml to use new config options

Author: fourdollars

.github/workflows/test.yaml

@@ -194,8 +194,7 @@ jobs:
             --config ai-provider="anthropic" \
             --config ai-model="claude-sonnet-3-5" \
             --config api-key="test-key" \
-            --config messenger="telegram" \
-            --config bot-token="123456:TEST"
+            --config telegram-bot-token="123456:TEST"
       
       - name: Wait for deployment
         run: |

FAQ.md

@@ -181,24 +181,19 @@ This allows access from other machines on your network (without SSH tunnel). **N
 
 **Telegram:**
 ```bash
-juju config openclaw \
-  messenger="telegram" \
-  bot-token="YOUR_TELEGRAM_BOT_TOKEN"
+juju config openclaw telegram-bot-token="YOUR_TELEGRAM_BOT_TOKEN"
 ```
 
 **Discord:**
 ```bash
-juju config openclaw \
-  messenger="discord" \
-  bot-token="YOUR_DISCORD_BOT_TOKEN"
+juju config openclaw discord-bot-token="YOUR_DISCORD_BOT_TOKEN"
 ```
 
 **Slack:**
 ```bash
 juju config openclaw \
-  messenger="slack" \
-  bot-token="xoxb-YOUR-BOT-TOKEN" \
-  app-token="xapp-YOUR-APP-TOKEN"
+  slack-bot-token="xoxb-YOUR-BOT-TOKEN" \
+  slack-app-token="xapp-YOUR-APP-TOKEN"
 ```
 
 ---
@@ -667,9 +662,10 @@ ssh -L 18789:127.0.0.1:18789 ubuntu@<gateway-ip>
 | `ai-provider` | (required) | anthropic, openai, google |
 | `ai-model` | (required) | Model name for selected provider |
 | `api-key` | (required) | API key for AI provider |
-| `messenger` | - | telegram, discord, or slack |
-| `bot-token` | - | Bot token for messenger |
-| `app-token` | - | Slack app token (Slack only) |
+| `telegram-bot-token` | - | Telegram bot token from @BotFather |
+| `discord-bot-token` | - | Discord bot token |
+| `slack-bot-token` | - | Slack bot token (xoxb-...) |
+| `slack-app-token` | - | Slack app token (xapp-...) |
 | `install-method` | npm | npm, pnpm, bun, or source |
 | `version` | latest | OpenClaw version to install |
 | `enable-browser-tool` | false | Enable Playwright browser |

GETTING_STARTED.md

@@ -152,14 +152,10 @@ juju deploy openclaw --config anthropic-api-key="your-key-here"
 ### Configuration
 ```bash
 # Enable Telegram
-juju config openclaw \
-  enable-telegram=true \
-  telegram-bot-token="123456:ABC-DEF"
+juju config openclaw telegram-bot-token="123456:ABC-DEF"
 
 # Enable Discord
-juju config openclaw \
-  enable-discord=true \
-  discord-bot-token="YOUR.TOKEN.HERE"
+juju config openclaw discord-bot-token="YOUR.TOKEN.HERE"
 ```
 
 ### Accessing Gateway
@@ -210,12 +206,10 @@ juju status openclaw
 ### Messaging Channels
 | Option | Type | Default |
 |--------|------|---------|
-| `enable-telegram` | boolean | false |
 | `telegram-bot-token` | string | - |
-| `enable-discord` | boolean | false |
 | `discord-bot-token` | string | - |
-| `enable-slack` | boolean | false |
 | `slack-bot-token` | string | - |
+| `slack-app-token` | string | - |
 
 ### Security
 | Option | Type | Default |

README.md

@@ -119,24 +119,28 @@ juju config openclaw \
 
 **Enable Telegram**
 ```bash
-juju config openclaw \
-  messenger="telegram" \
-  bot-token="123456:ABC-DEF"
+juju config openclaw telegram-bot-token="123456:ABC-DEF"
 ```
 
 **Enable Discord**
 ```bash
-juju config openclaw \
-  messenger="discord" \
-  bot-token="YOUR.DISCORD.TOKEN"
+juju config openclaw discord-bot-token="YOUR.DISCORD.TOKEN"
 ```
 
 **Enable Slack**
 ```bash
 juju config openclaw \
-  messenger="slack" \
-  bot-token="xoxb-xxx" \
-  app-token="xapp-xxx"
+  slack-bot-token="xoxb-xxx" \
+  slack-app-token="xapp-xxx"
+```
+
+**Enable Multiple Platforms Simultaneously**
+```bash
+juju config openclaw \
+  telegram-bot-token="123456:ABC-DEF" \
+  discord-bot-token="YOUR.DISCORD.TOKEN" \
+  slack-bot-token="xoxb-xxx" \
+  slack-app-token="xapp-xxx"
 ```
 
 ### Security Configuration
@@ -177,9 +181,10 @@ juju config openclaw log-level="debug"
 | `ai-provider` | string | - | AI provider: anthropic, openai, google, bedrock, ollama |
 | `ai-model` | string | - | AI model name |
 | `api-key` | string | - | API key for selected provider |
-| `messenger` | string | - | Messaging platform: telegram, discord, slack |
-| `bot-token` | string | - | Bot token for selected messenger |
-| `app-token` | string | - | Slack app token (required for Slack) |
+| `telegram-bot-token` | string | - | Telegram bot token from @BotFather |
+| `discord-bot-token` | string | - | Discord bot token |
+| `slack-bot-token` | string | - | Slack bot token (xoxb-...) |
+| `slack-app-token` | string | - | Slack app token (xapp-...) |
 | `dm-policy` | string | pairing | DM policy: pairing, open, closed |
 | `sandbox-mode` | string | non-main | Sandbox: all, non-main, none |
 | `install-method` | string | npm | Install method: npm, pnpm, bun, source |

config.yaml

@@ -36,26 +36,33 @@ options:
       For OpenAI: OpenAI API key
       For Google: Google Gemini API key
   
-  messenger:
+  telegram-bot-token:
     type: string
     default: ""
     description: |
-      Messaging platform to enable: 'telegram', 'discord', or 'slack'.
-      Leave empty to disable messaging channels.
+      Telegram bot token from @BotFather (e.g., 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11).
+      Leave empty to disable Telegram messaging.
   
-  bot-token:
+  discord-bot-token:
     type: string
     default: ""
     description: |
-      Bot token for the selected messenger platform.
-      For Telegram: Bot token from @BotFather
-      For Discord: Bot token from Discord Developer Portal
-      For Slack: Bot token (xoxb-...) from Slack App settings
+      Discord bot token from Discord Developer Portal.
+      Leave empty to disable Discord messaging.
   
-  app-token:
+  slack-bot-token:
     type: string
     default: ""
-    description: Slack app token (xapp-...) - only required for Slack messenger
+    description: |
+      Slack bot token (xoxb-...) from Slack App settings.
+      Leave empty to disable Slack messaging.
+  
+  slack-app-token:
+    type: string
+    default: ""
+    description: |
+      Slack app token (xapp-...) from Slack App settings.
+      Required when slack-bot-token is configured.
   
   dm-policy:
     type: string

docs/index.html

@@ -506,7 +506,7 @@ <h1>Juju Charm for<br><span class="gradient-text">OpenClaw</span></h1>
 juju config openclaw anthropic-api-key="your-key-here"
 
 # Enable messaging platforms
-juju config openclaw enable-telegram=true telegram-bot-token="your-token"</code></pre>
+juju config openclaw telegram-bot-token="your-token"</code></pre>
                 </div>
             </div>
         </section>
@@ -603,7 +603,7 @@ <h3>Configure AI Provider</h3>
                         <div class="step-content">
                             <h3>Enable Messaging Channels (Optional)</h3>
                             <p>Connect your preferred messaging platforms</p>
-                            <code>juju config openclaw \<br>  enable-telegram=true \<br>  telegram-bot-token="123456:ABC-DEF"</code>
+                            <code>juju config openclaw telegram-bot-token="123456:ABC-DEF"</code>
                         </div>
                     </div>
 
@@ -669,20 +669,20 @@ <h3>🌐 Gateway Settings</h3>
                         <h3>💬 Messaging Platforms</h3>
                         <dl>
                             <div class="config-option">
-                                <dt>enable-telegram</dt>
-                                <dd>Enable Telegram channel integration</dd>
+                                <dt>telegram-bot-token</dt>
+                                <dd>Telegram bot token from @BotFather</dd>
                             </div>
                             <div class="config-option">
-                                <dt>telegram-bot-token</dt>
-                                <dd>Telegram bot token</dd>
+                                <dt>discord-bot-token</dt>
+                                <dd>Discord bot token from Developer Portal</dd>
                             </div>
                             <div class="config-option">
-                                <dt>enable-discord</dt>
-                                <dd>Enable Discord channel integration</dd>
+                                <dt>slack-bot-token</dt>
+                                <dd>Slack bot token (xoxb-...)</dd>
                             </div>
                             <div class="config-option">
-                                <dt>enable-slack</dt>
-                                <dd>Enable Slack channel integration</dd>
+                                <dt>slack-app-token</dt>
+                                <dd>Slack app token (xapp-...)</dd>
                             </div>
                         </dl>
                     </div>

hooks/common.sh

@@ -133,46 +133,36 @@ generate_config() {
   "channels": {
 EOF
 
-    # Add messenger config based on selected platform
-    local messenger
-    messenger="$(config-get messenger)"
-    
-    if [ -n "$messenger" ]; then
-        local bot_token
-        bot_token="$(config-get bot-token)"
-        
-        case "$messenger" in
-            telegram)
-                if [ -n "$bot_token" ]; then
-                    cat >> "$config_file" <<EOF
+    # Add platform-specific messenger configs
+    local telegram_bot_token discord_bot_token slack_bot_token slack_app_token
+    telegram_bot_token="$(config-get telegram-bot-token)"
+    discord_bot_token="$(config-get discord-bot-token)"
+    slack_bot_token="$(config-get slack-bot-token)"
+    slack_app_token="$(config-get slack-app-token)"
+    
+    if [ -n "$telegram_bot_token" ]; then
+        cat >> "$config_file" <<EOF
     "telegram": {
-      "botToken": "${bot_token}"
+      "botToken": "${telegram_bot_token}"
     },
 EOF
-                fi
-                ;;
-            discord)
-                if [ -n "$bot_token" ]; then
-                    cat >> "$config_file" <<EOF
+    fi
+    
+    if [ -n "$discord_bot_token" ]; then
+        cat >> "$config_file" <<EOF
     "discord": {
-      "token": "${bot_token}"
+      "token": "${discord_bot_token}"
     },
 EOF
-                fi
-                ;;
-            slack)
-                local app_token
-                app_token="$(config-get app-token)"
-                if [ -n "$bot_token" ] && [ -n "$app_token" ]; then
-                    cat >> "$config_file" <<EOF
+    fi
+    
+    if [ -n "$slack_bot_token" ] && [ -n "$slack_app_token" ]; then
+        cat >> "$config_file" <<EOF
     "slack": {
-      "botToken": "${bot_token}",
-      "appToken": "${app_token}"
+      "botToken": "${slack_bot_token}",
+      "appToken": "${slack_app_token}"
     },
 EOF
-                fi
-                ;;
-        esac
     fi
 
     # Close channels object (remove trailing comma if exists)
@@ -389,34 +379,18 @@ validate_config() {
         errors=$((errors + 1))
     fi
 
-    local messenger
-    messenger="$(config-get messenger)"
+    local slack_bot_token slack_app_token
+    slack_bot_token="$(config-get slack-bot-token)"
+    slack_app_token="$(config-get slack-app-token)"
 
-    if [ -n "$messenger" ]; then
-        case "$messenger" in
-            telegram|discord)
-                if [ -z "$(config-get bot-token)" ]; then
-                    log_error "$messenger messenger selected but no bot-token configured"
-                    errors=$((errors + 1))
-                fi
-                ;;
-            slack)
-                if [ -z "$(config-get bot-token)" ]; then
-                    log_error "Slack messenger selected but no bot-token configured"
-                    errors=$((errors + 1))
-                fi
-                if [ -z "$(config-get app-token)" ]; then
-                    log_error "Slack messenger selected but no app-token configured"
-                    errors=$((errors + 1))
-                fi
-                ;;
-            *)
-                if [ "$messenger" != "" ]; then
-                    log_error "Invalid messenger value: $messenger (valid: telegram, discord, slack)"
-                    errors=$((errors + 1))
-                fi
-                ;;
-        esac
+    if [ -n "$slack_bot_token" ] && [ -z "$slack_app_token" ]; then
+        log_error "Slack bot-token configured but app-token is missing"
+        errors=$((errors + 1))
+    fi
+    
+    if [ -z "$slack_bot_token" ] && [ -n "$slack_app_token" ]; then
+        log_error "Slack app-token configured but bot-token is missing"
+        errors=$((errors + 1))
     fi
 
     return $errors