Telegram - OpenClaw Skill — OpenClaw Tutorials

Install Command

npx clawhub@latest install telegram

Installation Guide

Check Environment

Make sure Node.js 22+ and OpenClaw are installed. Run openclaw --version in your terminal to verify.

Run Installation

Run the install command above in your terminal. ClawHub will automatically download and install Telegram to the ~/.openclaw/skills/ directory.

Verify Installation

Run openclaw skills list to check your installed skills and confirm Telegram appears in the list.

Configure (Optional)

Follow the configuration instructions in the description below to add skill settings to ~/.config/openclaw/openclaw.json5.

Manual Installation: Copy the Skill folder to ~/.openclaw/skills/ or the skills/ directory in your project root. Make sure the folder contains a SKILL.md file.

Bot Operation Group Chat Support File Transfer

Detailed Description

The Telegram skill is one of the most commonly used channel integrations for OpenClaw, letting you chat with your AI assistant anytime, anywhere through Telegram.

Core Features

Private Chat: One-on-one conversation with the bot for the full AI assistant experience
Group Chat Integration: Add the bot to groups, triggered by @mention or keyword responses
Inline Mode: Invoke the bot in any chat via @botname without switching conversations
File Send & Receive: Receive user-sent files (images, documents, audio) and send files as replies
Keyboard Buttons: Create interactive menus using Inline Keyboard and Reply Keyboard

Configuration

Create a bot via @BotFather and obtain the Token.

{
  skills: {
    telegram: {
      botToken: "123456:ABC-xxx",
      allowedUsers: [],       // Empty = all users; fill in Telegram user IDs to restrict access
      groupMode: "mention",   // mention = reply when @mentioned, always = always reply
      maxMessageLength: 4096
    }
  }
}

Use Cases

Personal AI assistant: Ask questions or request task help anytime via Telegram
Group assistant: Provide real-time answers in technical discussion groups
File processing: Send a PDF for the bot to summarize, or send an image for analysis
Scheduled push: Combine with other skills (like RSS) to push information to you on a schedule

← Back to Skills List