Aws Claw: Asistente de IA para AWS 🤖❤️☁️

Aws Claw es una extensión para Visual Studio Code (y sus forks, incluyendo Google Antigravity, Windsurf, etc.) que integra la interacción con AWS en tu experiencia de chat. Utiliza lenguaje natural para inspeccionar y operar recursos de AWS con tus credenciales existentes. La extensión expone herramientas compatibles con AWS que ejecutan acciones directamente en tu nombre.

💬 Modos de Chat

• Modo Agente o Plan: La extensión registra herramientas de servicios de AWS que el asistente de IA puede invocar según tus solicitudes. Puedes hacer preguntas y el asistente llamará a las herramientas adecuadas para obtener datos o realizar acciones. Recomendamos comenzar con este modo para la mayoría de los casos de uso.

• Modo Preguntar o Editar: También puedes hacer preguntas o emitir comandos directamente usando el prefijo "@aws" en la entrada del chat. El asistente responderá con la información solicitada o realizará las acciones especificadas. Recomendamos este modo para consultas rápidas, tareas sencillas o si no tienes acceso al modo Agente/Plan.

Related MCP server: AWS MCP Server

🔌 Soporte para MCP

• Vscode: No es necesario configurar un servidor MCP. Aws Claw está integrado en el chat de Vscode (Copilot) y no requiere configuración adicional. Simplemente inicia un chat sobre tus recursos de AWS.

• Google Antigravity / Windsurf / Otros: Necesitas un servidor MCP local para conectar estos editores con Aws Claw. Consulta el README_MCP para obtener instrucciones de configuración detalladas.

🔑 Servicios de AWS compatibles

Haz clic aquí para ver la lista completa de servicios y acciones de AWS compatibles.

🤖 Herramientas disponibles

• Sesión y STS: gestionar perfil/región/endpoint, actualizar credenciales, GetCallerIdentity, tokens de sesión.

• S3: listar buckets/objetos, obtener/poner/eliminar objetos.

• SQS y SNS: listar colas/temas, enviar/recibir/eliminar mensajes, obtener URLs de colas.

• EC2: describir instancias, imágenes, VPCs, grupos de seguridad, salida de consola.

• Lambda y Step Functions: invocar funciones, listar máquinas de estado y ejecuciones.

• EMR: describir clústeres, pasos, estudios, ejecuciones de notebooks y políticas de escalado.

• CloudWatch Logs: buscar y recuperar eventos de registro.

• CloudFormation: listar pilas (stacks), describir recursos y eventos de pilas.

• RDS y RDS Data: listar instancias/clústeres de DB; ejecutar SQL mediante la API de RDS Data.

• DynamoDB: listar tablas, describir tablas, escanear/consultar elementos.

• IAM y STS: utilidades de identidad y credenciales.

• API Gateway, Glue: gestión de servicios y soporte para endpoints compatibles con S3.

• Operaciones de archivo: trabajar con el contexto del espacio de trabajo local.

❓ Preguntas y respuestas

Autenticación

• P: ¿Cómo se autentica Aws Claw en AWS?
  R: Utiliza tus credenciales de AWS existentes configuradas localmente (a través de la configuración de AWS CLI, SSO, variables de entorno, etc.) y la cadena de proveedores del SDK de AWS.

• P: ¿La extensión almacena mis credenciales de AWS?
  R: No, las credenciales no se guardan fuera del estado global de VS Code. Puedes actualizar o borrar las credenciales almacenadas en caché desde la Paleta de comandos.

Permisos

• P: ¿Qué permisos se requieren?
  R: La extensión invoca las APIs de AWS utilizando los permisos de tu cuenta. Utiliza políticas de IAM de privilegios mínimos y verifica el perfil activo antes de ejecutar acciones de modificación.

• P: ¿Puedo usar esta extensión con varias cuentas de AWS?
  R: Sí, puedes cambiar de perfil usando el selector de AWS en la barra de estado o mediante comandos en la Paleta de comandos.

Coste

• P: ¿Existe algún coste asociado al uso de esta extensión?
  R: La extensión en sí es gratuita, pero las llamadas a la API de AWS pueden generar costes según tu uso y los precios de AWS.

Seguridad

• P: ¿Mis credenciales de AWS están expuestas a Copilot u otros servicios de IA?
  R: No, tus credenciales de AWS son gestionadas localmente por la extensión y no se envían a ningún servicio de IA externo.

Seguridad (Safety)

• P: ¿Es posible que la extensión realice acciones no deseadas en mi cuenta de AWS?
  R: La extensión siempre solicita tu confirmación para las siguientes acciones antes de ejecutarlas:

  • put, post, upload, download, delete, copy, create, update, insert, commit, rollback, send, publish, invoke, start, execute.

  • Las acciones de List, get, describe, search, scan, query son de solo lectura y seguras.

• P: ¿Puedo ver las llamadas a la API de AWS que se están realizando?
  R: Sí, puedes ver el historial de llamadas a la API de AWS en el panel "Command History" y en el canal de salida llamado "Aws Claw-Log". Para abrir el canal de salida, ve a Ver -> Salida, luego selecciona "Aws Claw-Log" en el menú desplegable. Para abrir el panel "Command History", haz clic en el comando "Aws Claw: Open Command History" desde la Paleta de comandos. Puedes ver las respuestas de las llamadas a la API cuando exportas el historial a un archivo.

📺 Capturas de pantalla

⚙️ Requisitos previos

• Credenciales de AWS configuradas localmente (a través de la configuración de AWS CLI, SSO, variables de entorno u otros métodos compatibles).

🏁 Inicio rápido

1. Credenciales de AWS: Asegúrate de tener las credenciales de AWS configuradas localmente. Puedes usar AWS CLI para configurar perfiles o SSO.

2. Probar conectividad: Haz clic en "🔌Aws" en la barra de estado y ejecuta "Aws Claw: Test AWS Connection" para verificar el acceso a AWS. Puedes establecer el perfil, la región y el endpoint predeterminados (para Localstack) si lo necesitas.

3. Google Antigravity / Windsurf / Otros: Necesitas un servidor MCP local para conectar estos editores con Aws Claw. Consulta el README_MCP para obtener instrucciones de configuración detalladas.

4. Abrir Chat: Abre el Chat (usa @aws en el modo Preguntar o Editar) y haz una pregunta, por ejemplo:

   • Lista mis buckets de S3

   • Muestra los últimos eventos de registro de CloudWatch para /aws/lambda/my-fn

   • Describe las instancias EC2 en us-west-2

   • Publica un mensaje en mi tema de SNS

5. Revisar resultados: El asistente llamará a la herramienta adecuada, transmitirá los resultados y sugerirá acciones de seguimiento.

🧠 Instalar habilidades

Aws Claw incluye un conjunto de habilidades de agente que enseñan a GitHub Copilot cómo trabajar con los servicios de AWS. Instálalas con:

npx skills add necatiarslan/awsclaw

Una vez instaladas, las habilidades están disponibles en tus sesiones de agente y proporcionan al asistente un conocimiento profundo de los servicios de AWS, mejores prácticas y orientación sobre el uso de herramientas para todos los servicios compatibles.

👮 Autenticación y seguridad

• Credenciales: Resueltas a través de la cadena de proveedores del SDK de AWS. El perfil seleccionado se almacena en el estado global de VS Code y se vuelve a aplicar en todas las sesiones.

• Privacidad: No se conservan credenciales fuera del estado global de VS Code. Puedes actualizar o borrar las credenciales almacenadas en caché desde la Paleta de comandos.

• Permisos: El asistente invoca las APIs de AWS utilizando los permisos de tu cuenta. Utiliza políticas de IAM de privilegios mínimos y verifica el perfil activo antes de ejecutar acciones de modificación.

📋 TAREAS PENDIENTES

• Añadir más servicios y acciones de AWS.

  • Nivel 1: ECS, EKS, Secrets Manager, Systems Manager, ECR, Métricas y alarmas de CloudWatch

  • Nivel 2: ElastiCache, EventBridge, Kinesis, Route53, EFS, Cloud Trail, KMS, ELB

  • Nivel 3: X-Ray, Athena, Redshift

• Mejorar la comprensión del lenguaje natural para consultas específicas de AWS.

• Panel de configuración similar al de Copilot para una mejor experiencia de usuario.

💖 Enlaces

• Problemas y solicitudes de funciones: https://github.com/necatiarslan/awsclaw/issues

• Patrocinador: https://github.com/sponsors/necatiarslan

• Licencia: MIT