Repolode
ClawRunr

ClawRunr/JavaClaw

Assistente pessoal de IA em Java para seus próprios dispositivos, que funciona como gateway para um agente LLM em canais de chat, tarefas, shell e web.

Estrelas
753
Forks
167
Issues abertas
27
Último commit
há 15 dias

O que é?

JavaClaw é um assistente pessoal de IA escrito em Java, uma adaptação para Java da ideia do OpenClaw. Ele funciona como plano de controle para um agente de IA que recebe mensagens de vários canais, agenda e acompanha tarefas armazenadas como arquivos Markdown, executa comandos shell, lê e grava arquivos locais e navega na web. O projeto é baseado em Spring Boot, Spring AI e JobRunr, e o trabalho em segundo plano é executado pelo JobRunr, com um dashboard na porta 8081.

O agente pode usar um modelo da OpenAI, Anthropic ou um modelo local do Ollama, além de se conectar a servidores de ferramentas externos pelo Model Context Protocol. As skills são adicionadas colocando um arquivo SKILL.md em uma pasta do workspace ou empacotando-as como jars no classpath. Uma página de configuração guiada em /onboarding cuida do provedor, das credenciais, dos canais e dos plugins.

O projeto começou como uma demonstração do JobRunr e agora é apresentado como um convite aberto para a comunidade Java construir agentes de IA baseados em Java em conjunto.

Recursos principais

  • 01Interface de chat via WebSocket, além de canais do Telegram, Discord e WhatsApp por meio do wacli
  • 02Tarefas agendadas para uma única execução, com atraso ou via cron, armazenadas como arquivos Markdown
  • 03Skills carregadas de pastas do workspace ou de jars de skills no classpath
  • 04Compatibilidade com OpenAI, Anthropic e Ollama como provedores de LLM
  • 05Cliente MCP para conectar servidores de ferramentas externos
  • 06O agente pode ler e gravar arquivos e executar comandos bash na máquina local

Casos de uso

  • Executar um assistente auto-hospedado que responde a mensagens de chat no seu próprio hardware usando um modelo local do Ollama
  • Agendar tarefas automatizadas recorrentes descritas em arquivos Markdown legíveis
  • Ampliar um agente baseado em Java com skills personalizadas ou servidores de ferramentas MCP
  • Experimentar Spring AI e JobRunr em um projeto de agente

Início rápido

  1. 1

    Verifique se Java 25 e Gradle (ou o wrapper incluído) estão instalados

  2. 2

    Inicie o app a partir do repositório clonado

    ./gradlew :app:bootRun
  3. 3

    Abra a página de integração inicial no navegador e conclua a configuração

Antes de usar

  • Requer Java 25 e uma chave de API de LLM (OpenAI ou Anthropic) ou uma instância do Ollama em execução.
  • O agente pode executar comandos de shell na sua máquina, então precisa ser configurado com cuidado.
  • O suporte ao WhatsApp depende do protocolo não oficial do WhatsApp Web e é usado por sua conta e risco.
  • O Spring AI está fixado na dependência 2.0.0-SNAPSHOT, que não é uma versão estável.

Em coleções

Tópicos

Perguntas frequentes

O que é JavaClaw?
Assistente pessoal de IA em Java para seus próprios dispositivos, que funciona como gateway para um agente LLM em canais de chat, tarefas, shell e web. JavaClaw é um assistente pessoal de IA escrito em Java, uma adaptação para Java da ideia do OpenClaw. Ele funciona como plano de controle para um agente de IA que recebe mensagens de vários canais, agenda e acompanha tarefas armazenadas como arquivos Markdown, executa comandos shell, lê e grava arquivos locais e navega na web. O projeto é baseado em Spring Boot, Spring AI e JobRunr, e o trabalho em segundo plano é executado pelo JobRunr, com um dashboard na porta 8081.
JavaClaw é gratuito? Qual é a licença?
JavaClaw é open source sob a licença LGPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
JavaClaw ainda é mantido?
Manutenção ativa. O último commit de JavaClaw foi em 7 de out. de 2026.
Para que posso usar JavaClaw?
Executar um assistente auto-hospedado que responde a mensagens de chat no seu próprio hardware usando um modelo local do Ollama Agendar tarefas automatizadas recorrentes descritas em arquivos Markdown legíveis Ampliar um agente baseado em Java com skills personalizadas ou servidores de ferramentas MCP Experimentar Spring AI e JobRunr em um projeto de agente
Como instalar JavaClaw?
Verifique se Java 25 e Gradle (ou o wrapper incluído) estão instalados Inicie o app a partir do repositório clonado: ./gradlew :app:bootRun Abra a página de integração inicial no navegador e conclua a configuração
Onde consigo JavaClaw?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/ClawRunr/JavaClaw

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados