ClawRunr/JavaClaw

어떤 프로젝트인가요?

핵심 기능

• 01WebSocket 기반 채팅 UI와 wacli를 통한 Telegram, Discord, WhatsApp 채널 지원
• 02한 번 실행, 지연 실행 또는 cron 방식으로 예약하고 Markdown 파일에 저장하는 작업
• 03작업 공간 폴더 또는 클래스패스의 skill jar에서 스킬 로드
• 04LLM 제공자로 OpenAI, Anthropic, Ollama 지원
• 05외부 도구 서버 연결을 위한 MCP 클라이언트
• 06에이전트가 로컬 머신의 파일을 읽고 쓰며 bash 명령을 실행

활용 사례

• 로컬 Ollama 모델을 사용해 자체 하드웨어에서 채팅 메시지에 응답하는 셀프 호스팅 비서 운영
• 읽기 쉬운 Markdown 파일로 작성한 반복 자동화 작업 예약
• 사용자 지정 스킬이나 MCP 도구 서버로 Java 기반 에이전트 확장
• 에이전트 프로젝트에서 Spring AI와 JobRunr 실험

빠른 시작

1. 1

   Java 25와 Gradle(또는 포함된 wrapper)이 설치되어 있는지 확인하세요

2. 2

   clone한 저장소에서 앱을 시작하세요

   ./gradlew :app:bootRun
3. 3

   브라우저에서 온보딩 페이지를 열고 설정을 완료하세요

사용 전 알아둘 점

• !Java 25와 LLM API 키(OpenAI 또는 Anthropic) 또는 실행 중인 Ollama 인스턴스가 필요합니다.
• !에이전트가 컴퓨터에서 셸 명령을 실행할 수 있으므로 신중하게 구성해야 합니다.
• !WhatsApp 지원은 비공식 WhatsApp Web 프로토콜을 사용하므로, 사용에 따른 책임은 사용자에게 있습니다.
• !Spring AI가 2.0.0-SNAPSHOT 의존성으로 고정되어 있어 안정 버전이 아닙니다.

토픽

자주 묻는 질문

JavaClaw은(는) 무엇인가요?

내 기기에서 실행하는 Java 기반 개인 AI 비서로, 채팅 채널과 작업, 셸, 웹을 아우르는 LLM 에이전트의 게이트웨이 역할을 합니다. JavaClaw는 Java로 작성된 개인 AI 비서로, OpenClaw 아이디어를 Java로 포팅한 프로젝트입니다. 여러 채널에서 메시지를 받고, Markdown 파일로 저장된 작업을 예약하고 추적하며, 셸 명령을 실행하고, 로컬 파일을 읽고 쓸 뿐 아니라 웹도 탐색하는 AI 에이전트의 제어 플레인 역할을 합니다. Spring Boot, Spring AI, JobRunr를 기반으로 하며, 백그라운드 작업은 JobRunr를 통해 실행되고 대시보드는 8081 포트에서 제공됩니다.

JavaClaw은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

JavaClaw은(는) LGPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

JavaClaw은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. JavaClaw의 마지막 커밋은 2026년 10월 7일입니다.

JavaClaw은(는) 어디에 사용할 수 있나요?

로컬 Ollama 모델을 사용해 자체 하드웨어에서 채팅 메시지에 응답하는 셀프 호스팅 비서 운영 읽기 쉬운 Markdown 파일로 작성한 반복 자동화 작업 예약 사용자 지정 스킬이나 MCP 도구 서버로 Java 기반 에이전트 확장 에이전트 프로젝트에서 Spring AI와 JobRunr 실험

JavaClaw는 어떻게 설치하나요?

Java 25와 Gradle(또는 포함된 wrapper)이 설치되어 있는지 확인하세요 clone한 저장소에서 앱을 시작하세요: ./gradlew :app:bootRun 브라우저에서 온보딩 페이지를 열고 설정을 완료하세요

JavaClaw은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/ClawRunr/JavaClaw