diff --git a/roles/custom/matrix-bot-baibot/defaults/main.yml b/roles/custom/matrix-bot-baibot/defaults/main.yml
index 7db11b811..c22621b85 100644
--- a/roles/custom/matrix-bot-baibot/defaults/main.yml
+++ b/roles/custom/matrix-bot-baibot/defaults/main.yml
@@ -405,7 +405,9 @@ matrix_bot_baibot_config_agents_static_definitions_openai_config_extension_yaml:
 
 matrix_bot_baibot_config_agents_static_definitions_openai_config_base_url: https://api.openai.com/v1
 
-# The API key is intentionally not required. Some OpenAI-compatible APIs do not require a key.
+# Required when this provider is enabled.
+# For OpenAI-compatible APIs that need no key, baibot has a separate `openai_compat` provider,
+# which this role does not expose.
 matrix_bot_baibot_config_agents_static_definitions_openai_config_api_key: ""
 
 matrix_bot_baibot_config_agents_static_definitions_openai_config_text_generation_enabled: true