Slack Integration Guide

Overview

Connect Tencent WorkBuddy to Slack so you can send tasks and receive results directly in your Slack workspace. This integration uses the Claw remote control feature via Socket Mode — no public webhook URL required.

Prerequisites

• A Slack workspace where you have admin permissions (or can request app installation)
• Tencent WorkBuddy installed and running on your computer
• An active Tencent WorkBuddy account

Setup Steps

Step 1: Create a Slack App

1. Go to api.slack.com/apps and sign in
2. Click "Create New App" → select "From scratch"
3. Enter an app name (e.g., "Tencent WorkBuddy") and select your workspace
4. Click "Create App"

Step 2: Enable Socket Mode

1. In the left sidebar, click "Socket Mode"
2. Toggle "Enable Socket Mode" to On
3. You will be prompted to create an App-Level Token:
   • Enter a token name (e.g., "workbuddy-socket")
   • Add the scope connections:write
   • Click "Generate"
4. Copy the generated App Token (starts with xapp-) and save it

Step 3: Get the Bot Token

1. In the left sidebar, go to "OAuth & Permissions"
2. Under "Scopes" → "Bot Token Scopes", add the following scopes:
   • app_mentions:read
   • chat:write
   • im:history
   • im:read
   • im:write
   • files:read
   • files:write
3. Scroll up and click "Install to Workspace" → "Allow"
4. Copy the Bot User OAuth Token (starts with xoxb-)

Step 4: Enable Event Subscriptions

1. In the left sidebar, click "Event Subscriptions"
2. Toggle "Enable Events" to On
3. Under "Subscribe to bot events", add:
   • message.im — receive direct messages
   • app_mention — receive @mentions
4. Click "Save Changes"

Step 5: Configure in Tencent WorkBuddy

1. In Tencent WorkBuddy, open Claw Settings
2. Select Slack from the channel list
3. Enter the Bot Token (xoxb-...) in the Bot Token field
4. Enter the App Token (xapp-...) in the App Token field
5. Click "Save"

Step 6: Complete Pairing

1. After saving, Tencent WorkBuddy will display a gateway pairing code
2. Go back to your Slack workspace and open a DM with your Tencent WorkBuddy bot
3. Send the pairing code to the bot
4. Once confirmed, the channel status will show "Connected"

Using Tencent WorkBuddy in Slack

• Direct message the Tencent WorkBuddy bot to send tasks
• Mention the bot in a channel with @Tencent WorkBuddy to assign tasks
• Upload files and images for additional context
• Receive task results and notifications directly in Slack

Troubleshooting

Issue	Solution
Bot not responding	Ensure Tencent WorkBuddy is running on your computer with Claw enabled
Socket Mode connection error	Verify the App Token has the connections:write scope
Bot token invalid	Reinstall the app to your workspace to regenerate the Bot Token
Missing message events	Confirm message.im and app_mention event subscriptions are saved
Connection drops	Check your internet connection; Tencent WorkBuddy will auto-reconnect