Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.clawup.org/llms.txt

Use this file to discover all available pages before exploring further.

This guide walks you through connecting Telegram and Feishu to your Claw on ClawUp. After completing these steps, your AI assistant will be able to receive and reply to messages on the connected platform.

Part 1: Connect Telegram

Step 1: Create a Telegram Bot

  1. Open Telegram and search for @BotFather
  2. Start a chat with BotFather and send the command: /newbot
  3. BotFather will ask you for a name for your bot — this is the display name (e.g., “My Assistant”)
  4. Then it will ask for a username — this must end in “bot” (e.g., TetrisBot or tetris_bot)
  5. Once created, BotFather will send you a message containing your Bot Token — it looks like this:
    8715939390:AAETud7eTEvYpWN2Z55_XXXXXXXXX
    
  6. Copy this token — you’ll use it when creating your Claw on ClawUp
⚠️ Keep your bot token secret. Anyone with this token can control your bot.
Telegram BotFather setup

Step 2: Create Your Claw

  1. On ClawUp, create a new Claw and check Telegram as the channel
  2. Paste the Bot Token from BotFather
  3. Click Create Claw

Step 3: Wait for Deployment

After clicking Create Claw:
  1. The status will show creatingreconcilingrunning
  2. This usually takes 1–3 minutes
  3. Once the status shows running, your Claw is live
Telegram deployment status

Step 4: Complete Telegram Pairing

Once your Claw is running, the Telegram bot needs to be paired:
  1. Open Telegram and find your bot (search for the username you created)
  2. Send any message to the bot (e.g., “hello”)
  3. The bot will reply with a pairing code, for example:
    “Ask the bot owner to approve with: openclaw pairing approve telegram XXXXXXX
    Copy the entire command.
  4. Go back to ClawUp Dashboard → Overview → Open Claw Chat
  5. Send the full pairing code to your Claw
  6. Your Claw will reply: “Telegram has been approved”. If your Claw does not indicate success, send this message:
    Configure Telegram, run the command: openclaw pairing approve telegram XXXXXX
  7. Go back to Telegram and send a message to your bot
  8. The bot should reply — your Telegram channel is now connected! ✅
Telegram pairing flow

Part 2: Connect Feishu

Step 1: Create a Feishu Enterprise App

  1. Go to the Feishu Open Platform and log in with your Feishu account
  2. Click Create App → select Custom App
  3. Fill in the app name and description
  4. After creation, go to the app’s settings page
  5. Copy the App ID and App Secret — you’ll use them when creating your Claw on ClawUp
Feishu create app page Feishu app credentials

Step 2: Configure Permissions

On Permissions, click Batch import and paste:
{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:read",
      "cardkit:card:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "event:ip_list",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}
Feishu configure permissions

Step 3: Enable Bot Capability

In App Capability → Bot:
  1. Enable bot capability
  2. Set the bot name

Step 4: Configure Event Subscription

⚠️ Before configuring event subscription, make sure your Claw is already created and running on ClawUp. The WebSocket connection will not activate without an active backend.
In Event Subscription:
  1. Choose Use long connection to receive events (WebSocket)
  2. Add the event: im.message.receive_v1
Feishu configure event subscription

Step 5: Publish the App

  1. Create a version in Version Management & Release
  2. Submit for review and publish
  3. You will receive a message in Feishu asking you to approve the app release. Please approve it

Step 6: Complete Feishu Pairing

Once the Claw is running:
  1. Open Feishu and find your bot (search for the bot name you set)
  2. Send any message to the bot
  3. The bot will reply with a pairing code. Copy the entire command
  4. Go back to ClawUp Dashboard → Overview → Open Claw Chat
  5. Send the full pairing code to your Claw
  6. Your Claw will reply: “Feishu has been approved.” If your Claw does not indicate success, send this message:
    Configure Feishu, run the command: openclaw pairing approve feishu XXXXXX
  7. Go back to Feishu and send a message to your bot
  8. The bot should reply — your Feishu channel is now connected! ✅
Feishu pairing flow

Troubleshooting

ProblemSolution
Bot token invalidDouble-check the token from BotFather. No extra spaces.
Claw stuck on “creating”Wait up to 5 minutes. If still stuck, try deleting and recreating.
No pairing code receivedMake sure the Claw status is “running” before messaging the bot.
Pairing code expiredSend another message to the bot to get a new code.
Feishu events not workingConfirm event subscription is set to WebSocket mode and im.message.receive_v1 is added.
Bot replies in Web Chat but not Telegram/FeishuChannel pairing has not been completed. Continue chatting with your Claw to complete it.

Summary

Telegram:
  1. @BotFather → /newbot → Get Bot Token
  2. ClawUp → Create Claw → Check Telegram → Paste Token
  3. Wait 1–3 min for “running” status
  4. Message bot on Telegram → Get pairing code → Send to Claw
  5. Verify: bot replies on Telegram ✅
Feishu:
  1. Feishu Open Platform → Create App → Get App ID + App Secret
  2. Enable Bot + Configure WebSocket Events
  3. Publish App
  4. ClawUp → Create Claw → Check Feishu → Paste Credentials
  5. Message bot on Feishu → Get pairing code → Send to Claw
  6. Verify: bot replies on Feishu ✅
Need help? Join our Telegram community @clawup