ClawRunr

AI Agents. Pure Java.

A community-driven AI agent runtime built on Spring AI and JobRunr. Multi-channel, extensible, and runs entirely on your hardware.

Quick Start

# Prerequisites: Java 25 + an LLM API key (or Ollama)
$ git clone https://github.com/jobrunr/agentrunr.git
$ cd clawrunr
# Run it
$ ./gradlew :app:bootRun
# Then open http://localhost:8080/onboarding

Requires Java 25 and Gradle. Supports OpenAI, Anthropic, and Ollama out of the box.

What It Does

💬

Multi-Channel

Talk to your agent on Telegram, via the built-in Chat UI, or extend with your own channel. The architecture is pluggable by design.

🧠

Pick Your Brain

Plug in OpenAI, Anthropic, or run fully local with Ollama. Switch providers during onboarding, no code changes needed.

📋

Task Management

Schedule one-off, delayed, or cron-based tasks as human-readable Markdown files. Your agent organizes its own work.

Background Jobs

Powered by JobRunr. Reliable, persistent background processing with a built-in dashboard. The kind of infrastructure AI agents actually need.

🔌

Extensible Skills

Drop a SKILL.md into the workspace and the agent picks it up at runtime. No recompilation, no redeployment. Just capabilities.

🔒

Privacy First

Runs entirely on your hardware. No data leaves your machine unless you explicitly configure an external LLM provider.

🔗

MCP Support

Model Context Protocol client built-in. Connect external tool servers and expand your agent's reach beyond the JVM.

🛠️

Shell & File Access

Your agent can read and write files, run shell commands, search the web, and scrape pages. Full system-level autonomy.

Built With

Community

Built for the Java Community

ClawRunr started as a proof of concept showing what's possible when you combine Spring AI with reliable background processing. Now it's yours. Fork it, extend it, make it do things we never imagined.

Project Structure

ClawRunr/
├── base/ # Core: agent, tasks, tools, channels, config
├── app/ # Spring Boot entry point, onboarding UI, chat
├── plugins/ # Channel plugins (Telegram, ...)
└── workspace/ # Agent home: prompts, skills, tasks, memory