Repolode
ClawRunr

ClawRunr/JavaClaw

Asistente personal de IA basado en Java para tus propios dispositivos, que actúa como puerta de enlace para un agente LLM en canales de chat, tareas, shell y web.

Estrellas
753
Forks
167
Issues abiertos
27
Último commit
hace 15 días

¿Qué es?

JavaClaw es un asistente personal de IA escrito en Java, una adaptación a Java de la idea de OpenClaw. Funciona como plano de control de un agente de IA que recibe mensajes de varios canales, programa y realiza el seguimiento de tareas guardadas como archivos Markdown, ejecuta comandos de shell, lee y escribe archivos locales y navega por la web. Está basado en Spring Boot, Spring AI y JobRunr. El trabajo en segundo plano se ejecuta mediante JobRunr, que ofrece un panel de control en el puerto 8081.

El agente puede usar OpenAI, Anthropic o un modelo local de Ollama, y se conecta a servidores de herramientas externos mediante el Model Context Protocol. Para añadir skills, basta con colocar un archivo SKILL.md en una carpeta del workspace o empaquetarlas como archivos JAR en el classpath. Una página guiada de incorporación en /onboarding permite configurar el proveedor, las credenciales, los canales y los plugins.

El proyecto comenzó como una demo de JobRunr y ahora invita a la comunidad Java a crear juntos agentes de IA basados en Java.

Funciones clave

  • 01Interfaz de chat mediante WebSocket, además de canales de Telegram, Discord y WhatsApp a través de wacli
  • 02Tareas programadas para una sola ejecución, con retraso o mediante cron, guardadas como archivos Markdown
  • 03Skills cargadas desde carpetas del workspace o desde archivos JAR de skills en el classpath
  • 04Admite OpenAI, Anthropic y Ollama como proveedores de LLM
  • 05Cliente MCP para conectar servidores de herramientas externos
  • 06El agente puede leer y escribir archivos, y ejecutar comandos bash en la máquina local

Casos de uso

  • Ejecutar un asistente autoalojado que responda mensajes de chat en tu propio hardware con un modelo local de Ollama
  • Programar tareas automatizadas recurrentes descritas en archivos Markdown fáciles de leer
  • Ampliar un agente basado en Java con skills personalizadas o servidores de herramientas MCP
  • Experimentar con Spring AI y JobRunr en un proyecto de agentes

Inicio rápido

  1. 1

    Comprueba que Java 25 y Gradle (o el wrapper incluido) estén instalados

  2. 2

    Inicia la aplicación desde el repositorio clonado

    ./gradlew :app:bootRun
  3. 3

    Abre la página de incorporación en el navegador y completa la configuración

Antes de usarlo

  • Requiere Java 25 y una clave de API de LLM (OpenAI o Anthropic) o una instancia de Ollama en ejecución.
  • El agente puede ejecutar comandos de shell en tu máquina, por lo que debe configurarse con cuidado.
  • La compatibilidad con WhatsApp depende del protocolo no oficial de WhatsApp Web y se utiliza bajo tu propia responsabilidad.
  • Spring AI está fijado a la dependencia 2.0.0-SNAPSHOT, que no es una versión estable.

Temas

Preguntas frecuentes

¿Qué es JavaClaw?
Asistente personal de IA basado en Java para tus propios dispositivos, que actúa como puerta de enlace para un agente LLM en canales de chat, tareas, shell y web. JavaClaw es un asistente personal de IA escrito en Java, una adaptación a Java de la idea de OpenClaw. Funciona como plano de control de un agente de IA que recibe mensajes de varios canales, programa y realiza el seguimiento de tareas guardadas como archivos Markdown, ejecuta comandos de shell, lee y escribe archivos locales y navega por la web. Está basado en Spring Boot, Spring AI y JobRunr. El trabajo en segundo plano se ejecuta mediante JobRunr, que ofrece un panel de control en el puerto 8081.
¿JavaClaw es gratuito? ¿Qué licencia tiene?
JavaClaw es open source bajo la licencia LGPL-3.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿JavaClaw sigue mantenido?
Mantenimiento activo. El último commit de JavaClaw fue el 7 oct 2026.
¿Para qué puedo usar JavaClaw?
Ejecutar un asistente autoalojado que responda mensajes de chat en tu propio hardware con un modelo local de Ollama Programar tareas automatizadas recurrentes descritas en archivos Markdown fáciles de leer Ampliar un agente basado en Java con skills personalizadas o servidores de herramientas MCP Experimentar con Spring AI y JobRunr en un proyecto de agentes
¿Cómo se instala JavaClaw?
Comprueba que Java 25 y Gradle (o el wrapper incluido) estén instalados Inicia la aplicación desde el repositorio clonado: ./gradlew :app:bootRun Abre la página de incorporación en el navegador y completa la configuración
¿Dónde consigo JavaClaw?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/ClawRunr/JavaClaw

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados