channel-setup

Channel Setup Guide

Use this skill when the user wants to connect KiraClaw to Slack, Telegram, or Discord from the Channels screen.

General Rules

• Open Settings > Channels.
• Fill in the fields for the platform you want to enable.
• Save the settings.
• Restart the engine after enabling or changing channel credentials.
• Allowed Names should include the human names or handles that are allowed to talk to the bot on that platform.

Slack

Fill in:

• Slack Enabled
• Slack Bot Token
• Slack App Token
• Slack Signing Secret
• Slack Team ID
• Slack Allowed Names

Required Slack-side setup:

• Install the Slack app into the target workspace.
• Ensure the bot is invited to the channels you want it to read or post in.
• If testing in a channel, mention the bot or talk in a DM depending on the current channel rules.

Telegram

Fill in:

• Telegram Enabled
• Telegram Bot Token
• Telegram Allowed Names

Required Telegram-side setup:

• Create a bot with @BotFather and copy the bot token.
• Add the bot to the target DM, group, or channel.
• For groups, mention the bot when needed.
• If group behavior is limited, check the bot privacy settings in BotFather.

Discord

Fill in:

• Discord Enabled
• Discord Bot Token
• Discord Allowed Names

Required Discord-side setup:

• Create a Discord application and bot in the Discord Developer Portal.
• Copy the bot token into Discord Bot Token.
• Enable the Message Content Intent for the bot.
• Invite the bot to the server with the required read/send permissions.

Practical Advice

• If the user is unsure what to enter, explain the fields one by one.
• If a platform is not responding, first check the token, then whether the bot was invited, then whether the engine was restarted.
• If the user asks for live diagnosis, inspect runtime status and recent logs after confirming the channel was saved and restarted.