JobRunr giới thiệu ClawRunr: Tác nhân AI mã nguồn mở dành cho Java

JobRunr, một thư viện xử lý tác vụ nền nổi tiếng cho hệ sinh thái Java, đã chính thức giới thiệu ClawRunr. Đây là một tác nhân AI (AI agent) mã nguồn mở được thiết kế để chạy trên phần cứng của người dùng, nhằm giải quyết các vấn đề về tính bền vững, lập lịch và giám sát trong các tác vụ AI dài hạn.

Trước đây có tên là JavaClaw, dự án này kết hợp khả năng tương tác hội thoại với việc thực thi các tác vụ nền theo lịch trình, định kỳ hoặc một lần duy nhất. ClawRunr cho phép người dùng tạo lời nhắc, tự động hóa công việc lặp lại, kết nối các công cụ thông qua giao thức MCP (Model Context Protocol) và tương tác qua nhiều kênh như web chat, Telegram và Discord.

Kiến trúc và Công nghệ nền tảng

ClawRunr được xây dựng dựa trên các công nghệ hiện đại như Java 25, Spring Boot, Spring AI, Spring Modulith và chính JobRunr. Trạng thái của hệ thống được lưu trữ trong cơ sở dữ liệu nhúng H2. Về mặt kiến trúc, dự án được chia thành ba module chính:

• Base: Chứa lõi của tác nhân, bao gồm tác vụ, công cụ, kênh và cấu hình.
• App: Điểm vào của Spring Boot, giao diện người dùng onboarding và web chat tích hợp sẵn.
• Plugin: Cung cấp các tính năng tùy chọn như Brave Search, tích hợp Discord, Telegram và Playwright.

Hệ thống hỗ trợ nhiều nhà cung cấp mô hình ngôn ngữ lớn (LLM) bao gồm OpenAI, Anthropic và Ollama. Đặc biệt, khi sử dụng Ollama, ClawRunr có thể chạy hoàn toàn end-to-end trên mô hình cục bộ, đảm bảo không có dữ liệu nào rời khỏi phần cứng của người dùng.

Quản lý tác vụ và Tự động hóa

JobRunr đóng vai trò trung tâm trong việc xử lý các tác vụ bất đồng bộ của ClawRunr. Các tác vụ do người dùng tạo được lưu trữ dưới dạng tệp Markdown trong thư mục workspace/tasks/, được tổ chức theo ngày và gắn thẻ trạng thái trong vòng đời: todo (cần làm) → in_progress (đang thực hiện) → completed (hoàn thành) hoặc awaiting_human_input (chờ nhập liệu).

Các tác vụ định kỳ được lưu trữ trong workspace/tasks/recurring/ và lập lịch thông qua hỗ trợ cron của JobRunr, đi kèm với khả năng thử lại tự động và giám sát qua bảng điều khiển (dashboard).

Hệ thống công cụ và Kỹ năng mở rộng

ClawRunr đi kèm với bộ công cụ tích hợp sẵn để quản lý tác vụ, thực thi lệnh shell, truy cập tệp và thu thập dữ liệu web (web scraping). Dự án cũng hỗ trợ tích hợp máy chủ MCP qua cả HTTP và stdio, cũng như Brave Search.

Một tính năng đáng chú ý là tích hợp tùy chọn Playwright để tự động hóa trình duyệt, bao gồm điều hướng trang, nhấp chuột vào phần tử, thực thi JavaScript và chụp màn hình. Ngoài ra, ClawRunr cung cấp chế độ khám phá công cụ động dựa trên mẫu Tool Search Tool của Spring AI, sử dụng tìm kiếm từ khóa Lucene để tìm ra các công cụ phù hợp thay vì tải tất cả định nghĩa công cụ vào mỗi lời nhắc.

Hệ thống "kỹ năng" (skills) của ClawRunr hoạt động dựa trên tệp tin. Người dùng có thể thêm khả năng mới bằng cách tạo một thư mục trong workspace/skills/ và đặt một tệp SKILL.md bên trong. Thời gian chạy sẽ quét thư mục kỹ năng và cung cấp hướng dẫn đó cho tác nhân mà không cần thay đổi mã hay triển khai lại.

Cấu hình và Triển khai

Quá trình thiết lập ban đầu được thực hiện thông qua quy trình onboarding có hướng dẫn, giúp người dùng chọn nhà cung cấp (OpenAI, Anthropic hoặc Ollama), cấu hình thông tin đăng nhập và mô hình, tùy chỉnh lời nhắc của tác nhân và thiết lập các kênh như Telegram hoặc Discord. Cấu hình được lưu trữ trong tệp application.yaml và các thay đổi được áp dụng ngay lập tức.

ClawRunr ban đầu bắt đầu như một bằng chứng về khái niệm (proof of concept) để chứng minh cách JobRunr có thể được áp dụng cho các tác nhân AI. Đội ngũ JobRunr sau đó đã viết lại triển khai và phát hành dự án cho cộng đồng Java theo giấy phép LGPL-3.0.