What is the limit for Telegram bot commands?

Telegram enforces a strict limit of 100 commands per bot. If your OpenClaw skills exceed this, registration will fail.

How can I hide unused commands?

Use the "excludedCommands" array in your Telegram channel configuration within openclaw.json.

Fix "BOT_COMMANDS_TOO_MUCH" Error

Telegram API Limit Reached

Telegram only allows 100 commands per bot. If you have many OpenClaw skills installed (like clawhub bundles), the automated registration will fail with a 400 error.

Seeing [telegram] setMyCommands failed: 400 Bad Request: BOT_COMMANDS_TOO_MUCH? You need to prune your command list to stay under the limit.

Next Step

Fix now, then reduce repeat incidents

If this issue keeps coming back, validate your setup in Doctor first, then harden your config.

Open Doctor Harden Config

Need proactive alerts? Join Monitor early access.

Symptoms

[telegram] setMyCommands failed: Call to 'setMyCommands' failed! (400: Bad Request: BOT_COMMANDS_TOO_MUCH)

Fix 1: Prune Unused Commands

Open your openclaw.json and find your Telegram channel configuration. Add an excludedCommands array to hide commands you don't use in the UI.

Update openclaw.json

"channels": {
  "my-bot": {
    "module": "telegram",
    "config": {
      "token": "...",
      "excludedCommands": [
        "image_gen", // Example: hide commands from bundled skills
        "web_search",
        "scrape"
      ]
    }
  }
}

Fix 2: Disable Tool-to-Command Sync

By default, OpenClaw maps every tool to a /command. You can disable this globally and only register the essentials manually.

"autoRegisterCommands": false

Fix 3: Prune Skills

If you have skills you never use, uninstalling them is the best way to keep your command list clean and your gateway fast.

Uninstall unused skills

openclaw skills list\nopenclaw skills uninstall <skill-id>

Pro Tip

Even if a command is excluded from the Telegram UI menu, your agent can still internally use the tool. This fix only affects the list that appears when you type /.

Did this guide solve your problem?