---
title: "issue-bot: bot de Telegram con Claude Code · Lázaro Santana"
description: "issue-bot: bot de Telegram que recibe incidencias de QA de un WordPress local, acuerda un plan y aplica el arreglo con Claude Code. Node.js, código abierto."
url: https://lazarosantana.dev/proyectos/issue-bot/
---

proyecto propio · código abierto

# Un bot que corrige *incidencias*

issue-bot recibe por Telegram las incidencias de QA de un sitio WordPress local, acuerda un plan por chat, aplica la corrección con Claude Code y devuelve un informe de antes y después. Lo escribí entero yo.

[Ver el código](https://github.com/Lacho00/issue-bot) [Leer la guía paso a paso](https://github.com/Lacho00/issue-bot/blob/main/docs/GUIDE.md)

*github.com/Lacho00/issue-bot*

issue-bot: bot de Telegram que corrige incidencias de QA con Claude Code

**206** pruebas automáticas

**13** pull requests fusionados

**MIT** código abierto

Qué es

Un bot de Telegram que lleva una incidencia de QA hasta el informe

Mi papel

Idea, diseño, código, pruebas y despliegue, yo solo

Estado

En uso diario sobre mis sitios locales de WordPress

Licencia

MIT, el código está en GitHub

// el bot, paso a paso

## Una cara para cada paso

La mascota es un robot con un bicho en la antena. Su expresión sigue el recorrido de una incidencia, y el informe dibuja la contenta, la preocupada o la neutral según el estado de las incidencias.

Mascota de issue-bot pensando, con burbujas sobre la cabeza

01 · detecta **Pensando**

Mascota de issue-bot con gesto neutral

02 · planea **Neutral**

Mascota de issue-bot con los ojos entornados, trabajando

03 · corrige **Trabajando**

Mascota de issue-bot sonriendo, con la incidencia resuelta

04 · informa **Contenta**

Mascota de issue-bot preocupada, con una incidencia pendiente

si queda algo **Preocupada**

// el problema

## De QA al informe

Un equipo de QA manda incidencias sueltas: capturas, textos reenviados, álbumes. Alguien tiene que averiguar de qué sitio hablan, abrir el código, proponer una corrección, aplicarla y demostrar que quedó bien.

issue-bot hace ese recorrido con una persona al mando. Reenvías los mensajes, aprueba el plan y recibes un informe con la captura de QA junto a la de Claude.

01

### Detecta el sitio

Saca los dominios de las URL del mensaje y los busca en los `.wp-create.json` y en los vhosts de Apache. Si hay una sola coincidencia abre el trabajo; si hay varias o ninguna, pregunta con botones.

02

### Acuerda un plan

Agrupa los mensajes en un lote que se cierra tras 2 minutos o con `/plan`. Claude lee el sitio, propone un plan y no toca nada hasta que pulsas Aprobar plan.

03

### Corrige con Claude Code

Ejecuta Claude Code sin cabeza bajo una política estricta de permisos. No hace commit ni push: los cambios quedan en el árbol de trabajo para que los revises.

04

### Informa antes y después

Genera un HTML con indicadores de estado y una tarjeta por incidencia, con la captura de QA y la de Claude lado a lado. Lo que escribas después es una corrección y abre otra ronda.

// seguridad

## Control antes que velocidad

El bot ejecuta Claude Code sobre los ficheros de tus sitios, movido por mensajes de Telegram. Lo traté como acceso remoto a esa máquina.

// lo que decide el hook

- `git commit`*denegado*
- `git push`*denegado*
- `borrar en la base de datos`*denegado*
- `cambiar.claude`*denegado*
- `escribir en el sitio`*sandbox*
- `red desde Bash`*sin red*
- `escribir en fase de plan`*ninguna*

**Un solo dueño** ignora a cualquier otro usuario y a cualquier otro chat; el primer mensaje registra al dueño

**Hook antes de cada herramienta** un `PreToolUse` deniega `git commit`, `push`, borrados de base de datos y cambios en `.claude` antes de cualquier regla de permiso

**Bash en un sandbox** bwrap sin red, con escritura solo en el sitio y en la carpeta del trabajo; en la fase de plan, en ninguna

**Preguntar lo dudoso** lo que ninguna lista cubre sale con botones Permitir y Denegar, y la denegación siempre gana

**Sin tocar producción** pensado para copias locales de desarrollo, no para sitios en producción

// en cifras

## Números del proyecto

**206** pruebas automáticas, todas en verde

**13** pull requests fusionados

**2.829** líneas de JavaScript en 22 módulos

**MIT** licencia abierta, el código completo está en GitHub

issue-bot es una herramienta personal, no un trabajo para un cliente: no hay resultados de negocio que contar. Las cifras salen del repositorio.

Node.js 22 grammY Claude Code Telegram Bot API MCP SDK Zod Playwright WP-CLI systemd GitHub Actions

// pruébalo

[Ver el código](https://github.com/Lacho00/issue-bot) [Leer la guía paso a paso](https://github.com/Lacho00/issue-bot/blob/main/docs/GUIDE.md)

[¿Necesitas algo así? → IA y automatización](https://lazarosantana.dev/servicios/automatizacion-ia/)

[← todas las herramientas](https://lazarosantana.dev/#p-tools) proyecto propio

// tu proyecto

## ¿Tienes un proyecto en mente?

Cuéntame qué necesitas. Te respondo en menos de 24 h y, si encaja, recibes una propuesta cerrada por escrito.

[Pedir cotización](https://lazarosantana.dev/contacto/#formulario) [Ver servicios](https://lazarosantana.dev/servicios/)
