Telegram Integration Guide ​

Overview ​

Connect Tencent WorkBuddy to Telegram to send tasks and receive results through a Telegram bot. This integration uses the Claw remote control feature — once configured, you can interact with Tencent WorkBuddy directly from any Telegram client.

Prerequisites ​

  • A Telegram account
  • Tencent WorkBuddy installed and running on your computer
  • An active Tencent WorkBuddy account

Setup Steps ​

Step 1: Create a Telegram Bot via BotFather ​

  1. Open Telegram and search for @BotFather
  2. Start a chat and send the command /newbot
  3. Enter a display name for your bot (e.g., "My Tencent WorkBuddy")
  4. Enter a username for your bot — must be unique and end in bot (e.g., my_workbuddy_bot)
  5. BotFather will reply with a success message containing your Bot API Token (format: 123456789:ABCdef...)
  6. Copy and save this token securely

Tip: You can also use /mybots in BotFather to view and manage existing bots.

Step 2: Configure in Tencent WorkBuddy ​

  1. In Tencent WorkBuddy, click the Claw icon in the sidebar
  2. Go to Claw Settings → Channels
  3. Select Telegram from the channel list
  4. Paste the Bot API Token you copied from BotFather into the token field
  5. Click "Save"

Step 3: Start Using the Bot ​

  1. In Telegram, search for your bot by its username (e.g., @my_workbuddy_bot)
  2. Open the chat and click "Start"
  3. Send a message — Tencent WorkBuddy will respond through the bot in real time

Using Tencent WorkBuddy in Telegram ​

  • Send text messages to assign tasks to Tencent WorkBuddy
  • Send photos, documents, and files as additional context
  • Use /clear to clear conversation history
  • Receive formatted results with Markdown support

Security Tips ​

  • Keep your Bot API token confidential — treat it like a password
  • Do not share the token publicly or commit it to version control
  • You can revoke and regenerate the token at any time via @BotFather (/mybots → select bot → API Token → Revoke current token)

Troubleshooting ​

IssueSolution
Bot not respondingEnsure Tencent WorkBuddy is running with Claw enabled
Messages not deliveredCheck your internet connection on both devices
Bot token invalidRegenerate the token via @BotFather and update it in Tencent WorkBuddy Claw settings
Bot shows "unavailable"Make sure you have started a chat with the bot (send /start)