convez.ai
AgenteAutomaçãoIntermediário
vallemrv

Claude Bot via Telegram

vallemrv/claude-bot

Controle remoto do Claude Code via Telegram com sessões reanudáveis

Ver no GitHub
InicialPluginScore · de 0 a 100

Agent de Telegram que integra o Claude Code para executar tarefas complexas pelo celular. Oferece streaming em tempo real, gerenciamento de múltiplos projetos/sessões, transcrição de áudio e confirmação de permissões via botões — tudo controlado de forma segura por um único administrador.

Instalação

$npx convez-ai vallemrv/claude-bot

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 1 mês
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Executar tarefas de desenvolvimento sem estar na frente do computador
  • Gerenciar múltiplos projetos e sesões em paralelo pelo celular
  • Dictar prompts via áudio e acompanhar progresso em tempo real
  • Confirmar ou recusar ações de IA antes da execução

Veredito

Ferramenta robusta para developers que precisam controlar o Claude Code remotamente. Implementação técnica sólida (Agent SDK, streaming, MCP tool de permissões), segurança adequada com autenticação por admin ID e modos de permissão granulares. Caso de uso bem específico mas poderoso.

README

A tradução para o português deste README ainda está na fila.

claude-bot 🤖

Control remoto de Claude Code por Telegram — clon de opencode-bot adaptado a Claude. Habla con Claude desde el móvil, gestiona múltiples proyectos y sesiones, ve el progreso en vivo y recibe el resultado al terminar.

Usa el Claude Agent SDK por debajo (mismo login de Claude Code, sin API key aparte): streaming en vivo, sesiones reanudables, permisos inline, tool de preguntas, interrupción.

Arquitectura

Tú (Telegram) ──prompt──▶ telegram_bot.py ──▶ claude_client (Agent SDK)
                              ▲                      │ streaming
                              └── status en vivo ◀───┘ (texto, tools, tokens, coste)
MóduloFunción
src/telegram_bot.pyBot: comandos, status en vivo, permisos, preguntas, send mode, uploads, audio
src/claude_client.pyEnvoltura del Agent SDK: run() → eventos normalizados; tool MCP ask_user
src/db.pySQLite: sesión activa + modelo por sesión (la conversación la guarda Claude en disco)
src/md2tgv2.pyMarkdown → Telegram MarkdownV2
src/transcription.pyTranscripción de voz (X.AI Grok STT)

Comandos

ComandoDescripción
/startEstado: sesión activa, proyecto, modelo, permisos
/openBrowser de carpetas → abrir proyecto / crear o elegir sesión
/sessionsGestionar sesiones de un proyecto (activar / borrar)
/projectsProyectos con sesiones
/modelsCambiar modelo (opus / sonnet / haiku)
/permisosModo de permisos (bypass / acceptEdits / default / plan)
/send · /endsendEnviar a otro proyecto sin cambiar la sesión activa
/closeBorrar todas las sesiones de un proyecto
/escCancelar la tarea en curso
/restartReiniciar el bot (si está como servicio systemd)

Conversaciones paralelas: responde (reply) a un mensaje del bot para continuar esa sesión concreta; varios proyectos pueden trabajar a la vez. Envía audio para dictar y archivos para guardarlos en el proyecto activo.

Puesta en marcha

python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
cp .env.example .env   # rellena TELEGRAM_BOT_TOKEN y TELEGRAM_ADMIN_ID
./run.sh

Requisitos: claude CLI con sesión iniciada, Python 3.11+. Para audio: XAI_API_KEY.

Dejarlo siempre activo

Ver claude-bot.service.example (servicio systemd de usuario).

🔒 Seguridad

Solo responde a TELEGRAM_ADMIN_ID. Con PERMISSION_MODE=bypassPermissions Claude ejecuta todo sin preguntar — úsalo solo en tu máquina. Cambia a default con /permisos para que te pida confirmación (botones) en cada acción.

Ver o original no GitHub

Bom para

Relacionados