tel-start
启动 Telegram Webhook 服务器
Security Assessment
About tel-start
The `tel-start` skill is designed to launch a Telegram Webhook server that integrates with the Claude Code system. It automates the startup process of both global (main) and project-specific servers within tmux sessions, ensuring that the webhook server is running reliably and accessible. This skill addresses the common challenge of managing multiple Telegram bot integrations and webhook endpoints across different projects, simplifying deployment and maintenance for developers who need consistent and isolated server environments.
The skill provides several core capabilities. It can start the main server using a global configuration file or project servers using project-specific configurations. It automatically checks and installs necessary Python dependencies, launches a Cloudflared tunnel for secure external access, and manages tmux sessions to run servers in the background. The session names and ports are determined based on configuration, Git repository names, or directory names, with ports for project servers allocated incrementally starting from 8100. The skill also performs health checks and maintains a history of the last 10 project sessions. Additionally, it supports user interaction for selecting which project servers to start, offering a multi-selection prompt based on recent sessions.
This skill is ideal for developers and teams who maintain multiple Telegram bot projects or require an automated setup for webhook servers. It is particularly useful in scenarios where multiple project environments need to run simultaneously without port conflicts. Use cases include testing Telegram bot integrations, deploying project-specific webhook servers quickly, and ensuring that global and project-specific Claude Code integrations are consistently available. Target users include Python developers, DevOps engineers, and project teams managing bot infrastructure and webhook endpoints.
FAQ
How do I start the main Telegram Webhook server?
You can start the main server by running the tel-start script directly: `./.claude/templates/tel-start.sh`. It will use the global configuration located at `~/.claude-telegram/config.json` and run in the `main` tmux session on port 8000.
Can I run multiple project servers simultaneously?
Yes, the skill allows launching multiple project-specific servers. It reads the recent projects from `~/.claude-telegram/sessions.json` and prompts you to select which projects to start. Each project server is assigned a unique port starting from 8100.
What dependencies are required to use tel-start?
The skill requires Bash, Python libraries (flask, requests), tmux, and jq. If any Python dependencies are missing, they are installed automatically, while missing system tools require manual setup as indicated in the error messages.
How does tel-start handle configuration files?
Project-specific configurations take priority if `.claude-telegram/config.json` exists in the current directory. Otherwise, it falls back to the global configuration `~/.claude-telegram/config.json`. The session name and port are determined from these configurations or inferred from Git repository names or the directory name.
What should I do if a port is already in use?
If a port is occupied, tel-start will display a warning with the PID of the process using that port. You can terminate the existing process using `kill <PID>` or configure a different port in the project configuration.
Install tel-start
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
blueif16/claude-code-with-telegram