How umr-xiaomai/seekclaw works
SeekClaw is a .NET AI-agent runtime with CLI and Electron desktop clients, plus a web documentation and skills portal. The main workflow starts with a user request in a client, reaches the runtime through its facade or local daemon, and is handled by the Agent using model providers and tools before results return through events. The runtime also supports workspaces, persistent sessions, skills, MCP, scheduled tasks, computer use, and verification. Relationships for unsampled subsystems follow explicit README architecture statements; their internal call paths are not asserted here.
Main entry points: SeekClawRuntime.cs Runtime Facade · Agent.cs Agent Loop · Program.cs Docs and Skills Portal · EventBus.cs Event Bus
Components 26
User Clients
- CLI
seekclaw_cli/Program.cs - Desktop UI
seekclaw_desktop/src/renderer/src/App.vue - Daemon Client
seekclaw_desktop/src/main/daemon-client.ts
Runtime Orchestration
- Daemon Server
seekclaw_runtime/Daemon/DaemonServer.cs - Runtime Facade
seekclaw_runtime/SeekClawRuntime.cs - Agent Loop
seekclaw_runtime/Agents/Agent.cs - Event Bus
seekclaw_runtime/Events/EventBus.cs
Agent Capabilities
- Provider Routing
seekclaw_runtime/Providers/ProviderManager.cs - Built-in Tools
seekclaw_runtime/Tools/Builtin - MCP Integrations
seekclaw_runtime/Mcp/McpManager.cs - Computer Use
seekclaw_runtime/ComputerUse/ComputerTools.cs - Skills
seekclaw_runtime/Skills/SkillManager.cs - Prompt System
seekclaw_runtime/Prompts/PromptProvider.cs - Subagents
seekclaw_runtime/SubAgents/SubAgentRunner.cs - Build Verification
seekclaw_runtime/Verification/BuildVerifier.cs - Scheduled Tasks
seekclaw_runtime/Scheduling/ScheduleService.cs
Runtime State
- Workspace Manager
seekclaw_runtime/Workspaces/WorkspaceManager.cs - Configuration
seekclaw_runtime/Configuration/ConfigStore.cs - Session Store
seekclaw_runtime/Sessions/SessionStore.cs - SQLite Database
seekclaw_runtime/Data/SeekClawDatabase.cs
Web Portal
- Docs and Skills Portal
seekclaw_webserver/Program.cs - Authentication
seekclaw_webserver/Services/AuthService.cs - Skills Service
seekclaw_webserver/Services/SkillService.cs - Portal Database
seekclaw_webserver/Data/AppDbContext.cs
Other components
- User
- Portal User
Connections 32
- User → CLI: enters request
README.md - User → Desktop UI: enters request
README.md - CLI → Runtime Facade: invokes runtime
README.md - Desktop UI → Daemon Client: sends commands
- Daemon Client → Daemon Server: uses JSONL IPC
README.md - Daemon Server → Agent Loop: dispatches turns
README.md - Runtime Facade → Agent Loop: provides runtime
README.md - Agent Loop → Provider Routing: requests completions
README.md - Agent Loop → Built-in Tools: dispatches tools
README.md - Agent Loop → Session Store: persists sessions
README.md - Agent Loop → Build Verification: runs verification
README.md - Agent Loop → Event Bus: publishes events
README.md - Event Bus → CLI: updates terminal
README.md - Event Bus → Daemon Server: notifies clients
README.md - Runtime Facade → Configuration: loads settings
seekclaw_runtime/SeekClawRuntime.cs - Runtime Facade → Workspace Manager: composes workspace
seekclaw_runtime/SeekClawRuntime.cs - Runtime Facade → Skills: attaches skills
seekclaw_runtime/SeekClawRuntime.cs - Runtime Facade → Subagents: registers runner
seekclaw_runtime/SeekClawRuntime.cs - Runtime Facade → Built-in Tools: registers built-ins
seekclaw_runtime/SeekClawRuntime.cs - Skills → Prompt System: contributes prompts
seekclaw_runtime/Skills/SkillManager.cs - MCP Integrations → Built-in Tools: registers tools
README.md - MCP Integrations → Prompt System: provides prompts
README.md - Agent Loop → Computer Use: uses computer tools
README.md - Runtime Facade → Scheduled Tasks: hosts schedules
seekclaw_runtime/Scheduling/ScheduleService.cs - Session Store → SQLite Database: stores sessions
seekclaw_runtime/Sessions/SessionStore.cs - SQLite Database → Runtime Facade: is composed by
seekclaw_runtime/SeekClawRuntime.cs - Portal User → Docs and Skills Portal: visits portal
README.md - Docs and Skills Portal → Authentication: routes authentication
seekclaw_webserver/Program.cs - Docs and Skills Portal → Skills Service: routes skill market
seekclaw_webserver/Program.cs - Authentication → Portal Database: reads and writes
seekclaw_webserver/Services/AuthService.cs - Skills Service → Portal Database: reads and writes
seekclaw_webserver/Services/SkillService.cs - Docs and Skills Portal → Skills: publishes market API
README.md