Summary

JavaClaw is a Java-based, privacy-first personal AI assistant running locally. It acts as a control plane for an AI agent, enabling multi-channel interaction, task management, shell execution, and web browsing, all while keeping data private. Targets Java developers and AI enthusiasts seeking a customizable, extensible AI agent framework.

How It Works

Built on Spring Boot, Spring AI, and JobRunr, JavaClaw uses a modular architecture. The agent acts as a gateway. Extensibility is key: add communication channels, integrate custom skills via SKILL.md, and select LLM providers (OpenAI, Anthropic, Ollama). Background jobs for task management are handled by JobRunr.

Quick Start & Requirements

• Run: ./gradlew :app:bootRun (Gradle).
• Prerequisites: Java 25 (required), Gradle, LLM API key (OpenAI/Anthropic) or Ollama.
• Setup: 7-step onboarding at http://localhost:8080/onboarding for LLM, agent, and integrations.
• Docs: Release Demo Video, Website links available.

Highlighted Details

• Multi-Channel: Telegram, Chat UI (WebSocket), extensible.
• Task Management: Markdown tasks, one-off, delayed, cron scheduling.
• Extensible Skills: Add capabilities via workspace/skills/ and SKILL.md.
• LLM Choice: OpenAI, Anthropic, local Ollama, switchable.
• MCP Support: Model Context Protocol client for external tools.
• Shell & File Access: Agent executes bash commands, accesses files.
• Background Jobs: JobRunr for async tasks, dashboard at http://localhost:8081.

Maintenance & Community

An "open invitation to the Java community" for collaborative development of Java-based AI agents. Specific community links or contributor details are not detailed.

Licensing & Compatibility

Open-source, details in LICENSE. Specific license type and compatibility notes for commercial use or closed-source linking are not explicitly stated.

Limitations & Caveats

Originally a demo, it may still be evolving. Uses Spring AI snapshot (2.0.0-SNAPSHOT), indicating potential instability. Requires Java 25, a very recent/future Java version, limiting adoption on older environments.