How tsukhani/jclaw works
JClaw is a Java AI-assistant and automation platform. Its primary workflow is an operator or channel user submitting a conversation, which is routed through the application to an agent; the agent builds context, calls an LLM and tools, then returns a response through the originating channel. The repository also contains persistent memory, model routing, scheduled work, and browser/scrape capabilities. The map combines README-described capabilities with relationships visible in indexed references and excerpts; unsampled implementation details are not inferred as call edges.
Main entry points: AgentRunner.java Agent Execution · ApiConversationsController.java Conversation Handling · ContextWindowManager.java Context Management · ToolRegistry.java Agent Tools
Components 20
User Interaction
- Web Frontend
frontend - HTTP API
app/controllers - Chat Channels
app/channels
Agent Runtime
- Conversation Handling
app/controllers/ApiConversationsController.java - Agent Execution
app/agents/AgentRunner.java - Context Management
app/agents/ContextWindowManager.java - Context Compression
app/agents/CompressionPipeline.java
AI Capabilities
- LLM Providers
app/llm/LlmProvider.java - Model Router
app/llm/routing/ModelRouter.java - Agent Memory
app/memory/JpaMemoryStore.java - Agent Tools
app/agents/ToolRegistry.java - MCP Integration
app/mcp/McpConnectionManager.java
Automation
- Browser And Scraping
app/services/scrape/ScrapeJobService.java - Scheduled Tasks
app/services/TaskSchedulingService.java - Task Execution
app/services/TaskExecutor.java
Platform State
- Domain Records
app/models/Conversation.java - Configuration
app/services/ConfigService.java - Event Logging
app/services/EventLogger.java - Message Search
app/services/search/LuceneIndexer.java
Other components
- User
Connections 22
- User → Web Frontend: uses chat
README.md - User → Chat Channels: messages through
README.md - Web Frontend → HTTP API: requests
- HTTP API → Conversation Handling: routes conversations
app/controllers/ApiConversationsController.java - Conversation Handling → Agent Execution: queues turns
app/controllers/ApiConversationsController.java - Chat Channels → Agent Execution: delivers turns
- Agent Execution → Context Management: prepares context
- Context Management → Context Compression: compresses messages
- Agent Execution → LLM Providers: calls model
README.md - Agent Execution → Agent Tools: executes tools
README.md - Agent Execution → Agent Memory: uses memory
README.md - Model Router → LLM Providers: selects model
README.md - Agent Tools → MCP Integration: exposes MCP tools
app/mcp/McpConnectionManager.java - Agent Tools → Browser And Scraping: runs scrape jobs
app/services/scrape/ScrapeJobService.java - Scheduled Tasks → Task Execution: dispatches work
- Conversation Handling → Domain Records: reads and writes
app/controllers/ApiConversationsController.java - Conversation Handling → Message Search: uses message search
app/controllers/ApiConversationsController.java - Context Management → Configuration: reads settings
app/agents/ContextWindowManager.java - Context Compression → Configuration: reads settings
app/agents/CompressionPipeline.java - Browser And Scraping → Domain Records: persists jobs
app/services/scrape/ScrapeJobService.java - Browser And Scraping → Agent Execution: invokes agent
app/services/scrape/ScrapeJobService.java - Event Logging → Domain Records: persists event logs
app/services/EventLogger.java