JavaClaw:基于SpringBoot4+SpringAI+Spring单体构建的大龙虾


JavaClaw 是一款基于 Java 的OpenClaw大龙虾,运行在你自己的设备上。它作为一个 AI 智能体的控制平面(网关),可以跨多个通信渠道进行交互、管理任务、执行 shell 命令、浏览网页等——同时让你的数据保留在本地。

功能

  • 多渠道支持——Telegram(内置)、聊天界面(WebSocket),以及可扩展的渠道架构,用于添加更多平台
  • 任务管理——创建、安排(一次性、延迟或通过 cron 定时重复执行)任务,并以人类可读的 Markdown 文件形式追踪任务
  • 可扩展技能——将 SKILL.md 文件放入 workspace/skills/ 目录,智能体在运行时就能自动识别并使用
  • 大模型提供商选择——可接入 OpenAI、Anthropic 或 Ollama(本地模型),在初始化过程中可随时切换
  • MCP 支持——提供模型上下文协议客户端,用于连接外部工具服务器
  • Shell 与文件访问——智能体可以读写文件,并在你的机器上运行 bash 命令
  • 智能网页工具——支持 Brave 网页搜索和智能网页抓取
  • 后台任务——由 JobRunr 提供支持,内置仪表盘可通过 :8081 访问
  • 隐私优先——完全运行在你自己的硬件上;除非你配置了外部大模型,否则不会有任何数据离开本地


核心架构

项目不是随便拼的,而是典型 Java 企业级堆栈

 技术栈

  • Spring Boot 4(主框架)
  • Spring AI(LLM 接入层)
  • Spring Modulith(模块化架构)
  • JobRunr(任务调度核心)
  • H2(默认数据库)

典型结构:

JavaClaw/
├── base/       # 核心:智能体、任务、工具、通道
├── app/        # Web UI + 启动入口
└── plugins/    # 插件(如 Telegram)

这其实就是:

base = 智能体内核
app = 运行容器
plugins = 外部能力扩展

这设计是“可长期维护”的,而不是 demo 项。


JavaClaw 的核心价值 = JobRunr + AI

JobRunr 是什么? 一个 Java 的后台任务调度系统(类似于:Quartz、Celery(Python 版)、Sidekiq(Ruby 版))

它的特点是:

  • 支持延迟 / 定时 / 重试
  • 支持分布式执行
  • 数据持久化存储
  • 自带可视化仪表盘

JavaClaw 的做法是: “我帮你注册一个任务,并且这个任务可观测、可重试”!