Slack Setup

Slack integration is ideal for business teams and enterprise workflows. This guide covers the complete setup process for connecting your AI employee to Slack.

Works with both PicoClaw and Moltis.

What You'll Need

• A Slack workspace where you have admin permissions
• ~15 minutes for setup

Important: Moltis uses Socket Mode for Slack, not webhooks. This means Moltis requires an App-Level Token (app_token) in addition to the Bot Token. PicoClaw can optionally use Socket Mode via app_token as well.

Step 1: Create Slack App

Open Slack API

1. Go to api.slack.com/apps
2. Click Create New App
3. Choose From scratch

Configure App

1. Enter an App Name (e.g., "AI Assistant")
2. Select your Workspace
3. Click Create App

Step 2: Configure Bot Permissions

Add Bot Token Scopes

1. In your app settings, go to OAuth & Permissions
2. Scroll to Scopes section
3. Under Bot Token Scopes, add:

Step 3: Enable Socket Mode (Required for Moltis)

Moltis Slack integration uses Socket Mode instead of webhook-based event subscriptions. PicoClaw can also use Socket Mode if an app_token is provided.

Generate App-Level Token

1. In your app settings, go to Basic Information
2. Scroll down to App-Level Tokens
3. Click Generate Token and Scopes
4. Give it a name (e.g., "socket-mode")
5. Add the scope: connections:write
6. Click Generate
7. Copy the token (starts with xapp-)

Important: Save this token immediately. This is your app_token and is required for Moltis.

Enable Socket Mode

1. Go to Socket Mode in the left sidebar
2. Toggle Enable Socket Mode to On

Step 4: Subscribe to Events

Configure Events

1. Go to Event Subscriptions
2. Toggle Enable Events to On

Note: With Socket Mode enabled, you do not need to provide a Request URL. Slack routes events through the WebSocket connection.

Subscribe to Bot Events

Under Subscribe to bot events, add:

Save Changes

Click Save Changes at the bottom of the page.

Step 5: Install App to Workspace

Install the App

1. Go to Install App in the sidebar
2. Click Install to Workspace
3. Review the permissions
4. Click Allow

Copy Bot Token

After installation, you'll see:

• Bot User OAuth Token -- Copy this token

The token starts with xoxb-

Step 6: Get Your User ID

Find Your Slack User ID

1. In Slack, click on your profile picture
2. Click Profile
3. Click the More (...) button
4. Click Copy member ID

Step 7: Configure in MakersFuel

Configuration fields differ depending on your claw type.

PicoClaw Fields

Moltis Fields

Critical: Moltis Slack requires the app_token field. Without it, the Slack channel will not connect. PicoClaw can work without app_token but gains Socket Mode capability if one is provided.

DM Policy (Moltis)

Setup Steps

1. Go to your employee's configuration page
2. Find the Channels section
3. Click Add Channel or enable Slack
4. Fill in the fields for your claw type
5. Click Save to apply the configuration

Step 8: Invite Bot to Channels

Add to Channels

Your bot needs to be invited to channels where you want it to work:

1. Open the channel in Slack
2. Type /invite @YourBotName
3. Or click the channel name -> Integrations -> Add apps

Start Chatting

Test your bot:

• @mention the bot: @YourBot hello!
• Send a direct message to the bot
• Use slash commands if configured

Features

Slash Commands

You can configure custom slash commands for your bot.

Message Types

Thread Support

Your bot can respond in threads:

• Maintains conversation context
• Keeps channels organized
• Reference parent messages

Configuration Reference

PicoClaw Access Control

PicoClaw uses the allow_from field:

Moltis Access Control

Moltis uses dm_policy and allowlist:

Channel Restrictions

Control where the bot responds:

• Invite bot only to specific channels
• Use Slack's permissions to restrict access
• Configure via workspace admin settings

Troubleshooting

"Bot not responding"

1. Check scopes -- Ensure all required scopes are added
2. Check app_token -- Moltis requires the xapp- App-Level Token
3. Check Socket Mode -- Ensure Socket Mode is enabled in Slack app settings
4. Invite to channel -- Bot must be in the channel
5. Verify events -- Check event subscriptions are configured

"Missing scope" error

• Go to OAuth & Permissions
• Add the missing scope
• Reinstall app to workspace

"Invalid token" error

• Token may have been regenerated
• Copy the new token from Install App page
• Update in MakersFuel

Events not triggering

1. Verify event subscriptions are enabled
2. Ensure Socket Mode is enabled (for Moltis)
3. Ensure bot is invited to the channel
4. Check subscribed events list

Bot can't see messages

• Requires channels:history or groups:history scope
• Bot must be a member of the channel
• Check channel type (public vs private)

Moltis not connecting

• Verify app_token (starts with xapp-) is provided
• Ensure the App-Level Token has the connections:write scope
• Check that Socket Mode is toggled on in Slack app settings

Best Practices

Next Steps

• Employee Channels Overview -- Learn about other channels
• WhatsApp Setup -- Add WhatsApp channel
• Tools & Skills -- Extend capabilities