ClawRunr/JavaClaw

这是什么？

核心功能

• 01通过 WebSocket 提供内置聊天界面，并支持 Telegram、Discord 和借助 wacli 接入的 WhatsApp
• 02任务可一次性、延迟或按 cron 定时执行，以 Markdown 文件保存
• 03技能可从工作区目录或类路径上的 skill jar 加载
• 04支持 OpenAI、Anthropic 和 Ollama 作为大模型提供方
• 05内置 MCP 客户端，可连接外部工具服务
• 06智能体可在本机读写文件并执行 bash 命令

适用场景

• 在自有硬件上运行本地 Ollama 模型，搭建可通过聊天调用的私人助手
• 用可读的 Markdown 文件定义并定时执行周期性自动化任务
• 为基于 Java 的智能体添加自定义技能或 MCP 工具服务
• 在智能体项目中学习和试验 Spring AI 与 JobRunr

快速上手

1. 1

   确认已安装 Java 25 以及 Gradle（或使用自带的 wrapper）

2. 2

   在克隆的仓库中启动应用

   ./gradlew :app:bootRun
3. 3

   在浏览器中打开引导页面并完成设置

使用前须知

• !需要 Java 25，以及 OpenAI 或 Anthropic 的 API 密钥，或一个正在运行的 Ollama 实例。
• !智能体可以在你的机器上执行 shell 命令，因此需要谨慎配置。
• !WhatsApp 支持基于非官方的 WhatsApp Web 协议，使用风险自负。
• !Spring AI 依赖锁定在 2.0.0-SNAPSHOT 版本，并非稳定发布版。

标签

常见问题

JavaClaw 是什么？

一个运行在自有设备上的 Java 个人 AI 助手，作为 LLM 智能体的网关，连接多种聊天渠道并管理任务。 JavaClaw 是一个用 Java 编写的个人 AI 助手，是 OpenClaw 思路的 Java 版本。它作为 AI 智能体的控制层，接收来自多个渠道的消息，以 Markdown 文件形式保存并调度任务，还能执行 Shell 命令、读写本地文件并浏览网页。项目基于 Spring Boot、Spring AI 和 JobRunr 构建，后台任务由 JobRunr 执行，并提供 8081 端口的监控面板。

JavaClaw 可以免费使用吗？用的什么许可证？

JavaClaw 以 LGPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。

JavaClaw 还在维护吗？

活跃维护中。JavaClaw 最近一次提交是在 2026年10月7日。

JavaClaw 适合用来做什么？

在自有硬件上运行本地 Ollama 模型，搭建可通过聊天调用的私人助手 用可读的 Markdown 文件定义并定时执行周期性自动化任务 为基于 Java 的智能体添加自定义技能或 MCP 工具服务 在智能体项目中学习和试验 Spring AI 与 JobRunr

JavaClaw 怎么安装和运行？

确认已安装 Java 25 以及 Gradle（或使用自带的 wrapper） 在克隆的仓库中启动应用: ./gradlew :app:bootRun 在浏览器中打开引导页面并完成设置

在哪里获取 JavaClaw？

源代码和安装说明在 GitHub 上：https://github.com/ClawRunr/JavaClaw