Chameleon Labs Help - Administrator Commands
Mention @ChatMaster in any channel to start a free AI conversation powered by leading models from OpenAI, Anthropic, and Google.
Access Required: These commands require the Administrator permission on your Discord server. Server owners and users with the Administrator permission can use these commands. Available permissions vary by guild/server configuration.
AI-Multi
Add a personality to multi-LLM channel configuration.
Adds a personality (or all personalities) to a channel's multi-LLM configuration. The personality's model and settings will be used when mentioned in conversations.
Special Keyword: Use 'All' to add all available personalities at once, then use /multi_llm remove to exclude specific ones if needed.
Note: This uses the legacy multi-LLM system. For the new personality-based conversations, simply mention personality names in your messages!
Examples:
/multi_llm add channel:#chat personality:Einstein
/multi_llm add channel:#chat personality:Sysop
/multi_llm add channel:#chat personality:All
Remove all multi-LLM configuration from a channel.
Removes the entire multi-LLM configuration from a channel, reverting it to single-model behavior.
Examples:
/multi_llm clear channel:#chat
Remove a personality from multi-LLM channel configuration.
Removes a specific personality from a channel's multi-LLM configuration.
Workflow Tip: After using /multi_llm add personality:All, use this command to exclude specific personalities you don't want in the channel.
Examples:
/multi_llm remove channel:#chat personality:Einstein
General
Delete a news item (admin only).
Remove a news item from the server news board. Requires administrator permissions.
Examples:
/news delete news_id:5
Add or edit a news/announcement item (admin only).
Opens a multi-line editor to create or edit news items. Supports full markdown formatting. You can paste multi-line content directly. Requires administrator permissions or being in the config admin_user_ids list.
Examples:
/news edit
/news edit news_id:5
List all news items with IDs (admin only).
Show a complete list of all news items with their IDs for management purposes. Requires administrator permissions.
Examples:
/news list
Reports
Add a GitHub repo for /report
Configure a GitHub repository that users can select when filing reports. Issues will be created in the selected repo.
Examples:
/report_admin add_repo name:ImageAI repo:lelandg/ImageAI
/report_admin add_repo name:QuickStock repo:lelandg/QuickStock categories:error,suggestion
Edit a repo's configuration
Modify a GitHub repository configuration including name, repo URL, categories, or enabled status.
Examples:
/report_admin edit_repo name:ImageAI enabled:False
/report_admin edit_repo name:ImageAI new_name:ImageAI-Pro
/report_admin edit_repo name:ImageAI categories:error,suggestion,other
Show configured repos for /report
Display all GitHub repositories configured for the /report command in this server.
Examples:
/report_admin list_repos
Remove a repo from /report options
Remove a GitHub repository from the list of available repos for filing reports.
Examples:
/report_admin remove_repo name:ImageAI
Resolve or reopen a GitHub issue (admin).
Close a GitHub issue with a resolution (completed, not_planned, duplicate, invalid) or reopen a closed issue. Adds an optional comment before closing.
Examples:
/reports resolve issue_number:123 resolution:Completed
/reports resolve issue_number:45 resolution:Duplicate comment:'See #42'
/reports resolve issue_number:67 resolution:Reopen comment:'New info available'
Administration
Immediate restart without graceful shutdown (admin only).
Exits the process immediately. In supervised mode, exits with code 101 to trigger an instant restart.
Examples:
/admin_fast_restart
Restart the ChatMaster process (admin only).
Performs a self-restart by re-execing the Python process after closing connections.
Examples:
/admin_restart
Clear and resync all bot commands (admin only).
Clears all registered commands and re-syncs them with Discord. Use this to fix duplicate commands or sync issues.
What it does:
- Clears all bot commands from Discord
- Re-registers all commands
- Syncs them back to Discord
This may take a few seconds to complete.
Examples:
/admin_resync_commands
Stop the ChatMaster process (admin only).
Closes Discord and storage, then exits the process.
Examples:
/admin_shutdown
Show all channels where bot responses are disabled (admin only).
Lists all channels that have been excluded from bot responses. Admin only command.
Examples:
/channel list_excluded
Show all channels where the bot can respond (admin only).
Lists all text channels that are NOT excluded, organized by category. These are the channels where the bot will respond to mentions and interactions. Admin only command.
Examples:
/channel list_included
[Admin] Export all data for this guild to JSON.
Exports all guild-specific data to a JSON file for backup or transfer.
Examples:
/data_admin export_guild
[Admin] Show data statistics for this guild.
Shows counts of records stored for this guild across major tables.
Examples:
/data_admin guild_stats
🤖 Create a new AI personality profile (admin only).
Administrator Only
Define a custom AI personality with a unique name, description, and system prompt. Optionally specify a model and temperature override.
Multi-LLM Conversations: Once created, mention personality names in messages to trigger group conversations where multiple AI personalities respond in turn!
💡 *For a complete guide, use /multi_llm guide*
Examples:
/personality create name:Sysop description:Grumpy BBS admin system_prompt:You are a grumpy BBS sysop from the 90s
/personality create name:Helper description:Friendly assistant system_prompt:You are helpful model:claude-sonnet-4-5
🤖 Set default AI personality for the server (admin only).
Administrator Only
Sets the default personality for the server. This personality will be used for users who have not selected a specific personality with /be (or /act).
Examples:
/personality default personality:Sysop
🤖 Delete an AI personality profile (admin only).
Administrator Only
Soft-delete a personality, making it unavailable for use. Deleted personalities can be restored with /personality restore. Active conversations using this personality will continue until they end.
Examples:
/personality delete personality:OldPersonality
🤖 Restore a deleted AI personality (admin only).
Administrator Only
Restore a soft-deleted personality, making it available for use again. You need the personality ID, which you can find from the deletion message or by checking the database.
Examples:
/personality restore personality_id:42
Set the default category for private channels.
Admins pick the category where new private channels are created by default.
Examples:
/private set_category category:#Private
Transfer ownership of a private channel.
Grants the new owner permissions on the channel and removes explicit permissions for the old owner. Requires Manage Channels.
Examples:
/private transfer channel:#private-foo new_owner:@user
[Admin] Trigger full reindex of messages for semantic search.
Generates embeddings for all unindexed messages in this guild. May take a while for large message histories.
Examples:
/semantic reindex
[Admin] Show semantic search indexing statistics.
Displays model info, indexed message count, worker status, and coverage percentage.
Examples:
/semantic status
[Admin] Enable or disable semantic search.
Toggles semantic search on/off. When disabled, the bot uses keyword-only (FTS5) search.
Examples:
/semantic toggle enabled:true
/semantic toggle enabled:false
Configure tool pipeline iteration limits and timeouts
Adjust the tool-call pipeline settings for this server.
Parameters (all optional):
* max_iterations - Maximum tool-call loop iterations (1-20)
* timeout - Overall pipeline timeout in seconds (10-300)
* call_timeout - Per-tool-call timeout in seconds (5-60)
When called with no parameters, displays the current values.
Settings are stored per-guild and override config.yaml defaults.
Examples:
/toolconfig
/toolconfig max_iterations:10 timeout:120 call_timeout:30
Alert API
[Admin] List all API keys or keys for a specific user.
Admin command to view all registered Alert API keys in the system, or filter by a specific user.
Examples:
/alert_api_admin list
/alert_api_admin list user:@someone
[Admin] Revoke a user's API key.
Admin command to revoke any user's API key by name.
Examples:
/alert_api_admin revoke user:@someone key_name:home-server
[Admin] Show Alert API usage statistics.
Shows statistics about API key usage, including total keys, active keys, and alert counts.
Examples:
/alert_api_admin stats