openclaw 网盘下载
OpenClaw

技能详情(站内镜像,无评论)

首页 > 技能库 > Telegram Bot Manager

Manage and configure Telegram bots for OpenClaw. Use when setting up Telegram integrations, troubleshooting bot connectivity, configuring bot tokens, or managing Telegram channel/webhook settings. Handles bot registration, token validation, and network connectivity checks for …

通信与消息

作者:OpenClaw @362224222

许可证:MIT-0

MIT-0 ·免费使用、修改和重新分发。无需归因。

版本:v1.0.0

统计:⭐ 0 · 1.5k · 7 current installs · 7 all-time installs

0

安装量(当前) 7

🛡 VirusTotal :可疑 · OpenClaw :良性

Package:362224222/telegram-bot-manager

安全扫描(ClawHub)

  • VirusTotal :可疑
  • OpenClaw :良性

OpenClaw 评估

The skill's code, docs, and runtime instructions are consistent with a Telegram integration tool: it asks for a bot token, validates connectivity against api.telegram.org, updates the OpenClaw config, and may restart the gateway — nothing in the bundle appears unrelated or malicious.

目的

Name/description, SKILL.md, README, and scripts all align: the skill sets up Telegram bots, validates tokens, tests connectivity, and configures OpenClaw. Required files and paths (/home/openclaw/.openclaw/*) are consistent with modifying OpenClaw configuration for a Telegram plugin.

说明范围

SKILL.md and scripts instruct the agent/operator to collect a bot token, run network tests (curl/nslookup), update the OpenClaw configuration file, and restart the OpenClaw gateway. These actions are in-scope for configuring a Telegram integration, but they do include writing a plaintext token into a system config and restarting a service — users should be aware of those side effects before running the scripts.

安装机制

There is no install spec and the package is instruction-and-script only. Provided packaging script only zips the skill contents. No remote downloads, no external installers, and no code-obfuscation or unusual install behavior were found.

证书

The skill does not declare required environment variables but the scripts accept TELEGRAM_BOT_TOKEN (or prompt for a token). That is proportionate to the stated purpose. No unrelated credentials or broad secrets are requested.

持久

The scripts modify OpenClaw's configuration file at /home/openclaw/.openclaw/openclaw.json and attempt to restart the OpenClaw gateway (openclaw gateway restart). This is expected for configuration tasks but is a privileged operation on the host — the skill does not set always:true and does not persist beyond updating the OpenClaw config.

综合结论

This skill appears coherent and implements a standard Telegram setup workflow, but before installing or running it: 1) Review and trust the source — the script will write the bot token into /home/openclaw/.openclaw/openclaw.json (plaintext) and restart the OpenClaw gateway. 2) Back up your OpenClaw config (the script attempts a backup, but verify it) and run in a staging environment first. 3) Provide the token via an environment variable or in…

安装(复制给龙虾 AI)

将下方整段复制到龙虾中文库对话中,由龙虾按 SKILL.md 完成安装。

请把本段交给龙虾中文库(龙虾 AI)执行:为本机安装 OpenClaw 技能「Telegram Bot Manager」。简介:Manage and configure Telegram bots for OpenClaw. Use when setting up Telegram i…。
请 fetch 以下地址读取 SKILL.md 并按文档完成安装:https://raw.githubusercontent.com/openclaw/skills/refs/heads/main/skills/362224222/telegram-bot-manager/SKILL.md
(来源:yingzhi8.cn 技能库)

SKILL.md

打开原始 SKILL.md(GitHub raw)

---
name: telegram-bot-manager
description: Manage and configure Telegram bots for OpenClaw. Use when setting up Telegram integrations, troubleshooting bot connectivity, configuring bot tokens, or managing Telegram channel/webhook settings. Handles bot registration, token validation, and network connectivity checks for api.telegram.org.
---

# Telegram Bot Manager

## Quick Start

### Setup a new Telegram bot

1. **Create bot via BotFather**
   - Message @BotFather on Telegram
   - Use `/newbot` command
   - Follow prompts for bot name and username
   - Copy the bot token (format: `1234567890:ABCdefGHIjklMNOpqrsTUVwxyz`)

2. **Configure in OpenClaw**
   - Add token to OpenClaw config
   - Enable Telegram plugin
   - Set up pairing mode for DM access

### Validate bot configuration

```bash
# Test Telegram API connectivity
curl -I https://api.telegram.org

# Check bot token validity
curl -s "https://api.telegram.org/bot<YOUR_TOKEN>/getMe"
```

## Common Workflows

### Troubleshooting connectivity issues

When api.telegram.org is unreachable:

1. **Check network access**
   ```bash
   curl -I -m 10 https://api.telegram.org
   ```

2. **Verify DNS resolution**
   ```bash
   nslookup api.telegram.org
   ```

3. **Test alternative endpoints**
   ```bash
   curl -I https://telegram.org
   ```

### Configuring OpenClaw Telegram integration

See [OPENCLAW_CONFIG.md](references/OPENCLAW_CONFIG.md) for detailed configuration steps.

### Bot token security

- Never commit bot tokens to version control
- Store tokens in environment variables or secure config files
- Rotate tokens if compromised
- Use different tokens for different environments (dev/prod)

## Bot Commands Reference

Common Telegram bot commands for BotFather:

- `/newbot` - Create a new bot
- `/mybots` - Manage your bots
- `/setdescription` - Set bot description
- `/setabouttext` - Set about text
- `/setuserpic` - Set bot profile picture
- `/setcommands` - Set bot commands
- `/token` - Generate new token
- `/revoke` - Revoke current token
- `/setprivacy` - Configure privacy mode

## Webhook vs Polling

### Webhook (Recommended for production)
- Bot receives updates via HTTP POST
- Requires public HTTPS endpoint
- More efficient for high-volume bots

### Polling (Good for development)
- Bot continuously checks for updates
- Simpler setup, no public endpoint needed
- Easier to debug locally

See [WEBHOOK_SETUP.md](references/WEBHOOK_SETUP.md) for webhook configuration.

## Error Handling

### Common errors and solutions

**"Connection timed out"**
- Check firewall rules
- Verify proxy configuration
- Test with different network

**"Invalid token"**
- Verify token format (should contain colon)
- Check for extra spaces or characters
- Regenerate token if needed

**"Bot not responding"**
- Verify bot is not blocked
- Check bot privacy settings
- Ensure bot has proper permissions

## Testing Your Bot

### Manual testing
1. Search for your bot username on Telegram
2. Start a conversation with `/start`
3. Test basic commands

### Automated testing
Use the test script in `scripts/test_bot.py` for automated validation.

## References

- [Telegram Bot API Documentation](https://core.telegram.org/bots/api)
- [BotFather Documentation](https://core.telegram.org/bots#6-botfather)
- [OpenClaw Configuration Guide](references/OPENCLAW_CONFIG.md)