How uniclawai/uniclaw works
UniClaw is an asynchronous, tool-using LLM assistant with console, browser, and WeChat entry points. The main workflow is user input → agent reasoning and provider selection → tool execution → streamed or final response, with sessions and context supporting continuity. The README documents additional capabilities such as search, memory, RAG, knowledge graphs, scheduling, and integrations; these are represented by their tree paths, but their internal wiring is not fully evidenced by the sampled source. Edges therefore emphasize documented entry points and avoid asserting unsampled calls.
Main entry points: registry.py Tool registry · multi_agent.py Agent runtime · main.py Mode selection · app.py Web UI
Components 26
User interfaces
- Mode selection
src/uniclaw/main.py - Console UI
src/uniclaw/console/run.py - Web UI
src/uniclaw/webui/app.py - WeChat bot
src/uniclaw/ilink_bot/manager.py
Agent runtime
- Agent runtime
src/uniclaw/agent/multi_agent.py - Tool registry
src/uniclaw/tools/registry.py - Provider router
src/uniclaw/provider/router.py - Configuration
src/uniclaw/config.py
Tools and tasks
- Search tools
src/uniclaw/tools/search/tools.py - Files and shell
src/uniclaw/tools/fs.py - Computer control
src/uniclaw/tools/computer_use/tools.py - Tasks and plans
src/uniclaw/tools/todolist/tools.py - Scheduler
src/uniclaw/tools/scheduler/scheduler.py - Download managers
src/uniclaw/tools/download/manager.py - Plugins and hooks
src/uniclaw/tools/plugins/loader.py
Context and state
- Session manager
src/uniclaw/tools/session/session_manager.py - Context management
src/uniclaw/context.py - Persistent memory
src/uniclaw/tools/memory/memory.py - Knowledge graph
src/uniclaw/tools/knowledge/graph.py - RAG retrieval
src/uniclaw/tools/rag/rag.py
External integrations
- MCP integration
src/uniclaw/tools/mcp/tools.py - A2A integration
src/uniclaw/tools/a2a/tools.py
Other components
- User
- LLM providers
- Docker
- Session files
Connections 27
- User → Mode selection: starts
- Mode selection → Console UI: launches console
- Mode selection → Web UI: launches WebUI
- Console UI → Agent runtime: submits input
- Web UI → Agent runtime: submits input
- WeChat bot → Agent runtime: provides interaction
- Agent runtime → Provider router: requests completion
- Provider router → LLM providers: sends requests
- Agent runtime → Tool registry: discovers tools
- Tool registry → Search tools: exposes tools
- Tool registry → Files and shell: exposes tools
- Tool registry → Computer control: exposes tools
- Tool registry → Tasks and plans: exposes tools
- Tool registry → Scheduler: exposes tools
- Tool registry → Download managers: exposes tools
- Tool registry → Plugins and hooks: loads extensions
- Tool registry → MCP integration: exposes tools
- Tool registry → A2A integration: exposes tools
- Agent runtime → Session manager: persists conversation
- Session manager → Session files: reads and writes
- Agent runtime → Context management: manages context
- Tool registry → Persistent memory: exposes tools
- Tool registry → Knowledge graph: exposes tools
- Tool registry → RAG retrieval: exposes tools
- Agent runtime → Configuration: uses settings
- Web UI → WeChat bot: manages bots
- MCP integration → LLM providers: optional service access