How netclaw-dev/netclaw works
Netclaw is a self-hosted autonomous operations agent: users connect through the CLI or a chat channel, the daemon hosts sessions, invokes tools and persists state, then returns results through the initiating interface. The graph preserves the documented provider, memory, scheduling, background-job, and skill-feed capabilities as distinct branches. Several links are dashed because the relevant implementation was not sampled; paths identify existing source files or directories, not inferred filenames.
Main entry points: Netclaw.Daemon Daemon · SessionProtocol.cs Session Protocol · Netclaw.Channels Chat Channels · Program.cs CLI
Components 22
User Interfaces
- CLI
src/Netclaw.Cli/Program.cs - Daemon
src/Netclaw.Daemon - Chat Channels
src/Netclaw.Channels - Channel Pipeline
src/Netclaw.Actors/Channels/ChannelPipeline.cs
Agent Sessions
- Session Protocol
src/Netclaw.Actors/Sessions/SessionProtocol.cs - Turn Context
src/Netclaw.Actors/Channels/TurnContext.cs - Tool Execution
src/Netclaw.Actors/Sessions/Pipelines/SessionToolExecutionPipeline.cs - Session Compaction
src/Netclaw.Actors/Sessions/Pipelines/SessionCompactionPipeline.cs - Memory Recall
src/Netclaw.Actors/Sessions/Pipelines/SessionRecallManager.cs
Agent Capabilities
- Background Jobs
src/Netclaw.Actors/Jobs - Reminders
src/Netclaw.Actors/Reminders - Memory Curation
src/Netclaw.Actors/Memory/MemoryCurationPipeline.cs - Embedding Warmup
src/Netclaw.Daemon/Services/EmbeddingWarmupHostedService.cs - Skill Feeds
feeds
Configuration and State
- Configuration
src/Netclaw.Configuration/NetclawPaths.cs - Session Storage
src/Netclaw.Daemon/Gateway/SqliteSessionStorageResolver.cs - Storage Layout
src/Netclaw.Tools.Abstractions/SessionStoragePaths.cs - OAuth Token State
src/Netclaw.Configuration/OAuthTokenExpiryStorage.cs
External Integrations
- LLM Providers
src/Netclaw.Providers/LlmProviderServiceExtensions.cs - LLM Service
- Chat Platforms
Other components
- Operator
Connections 22
- Operator → CLI: runs commands
README.md - CLI → Daemon: connects locally
README.md - Daemon → Session Protocol: hosts sessions
README.md - Chat Platforms → Chat Channels: sends messages
- Chat Channels → Channel Pipeline: routes input
- Channel Pipeline → Session Protocol: dispatches turns
- Session Protocol → Turn Context: carries context
src/Netclaw.Actors/Channels/TurnContext.cs - Session Protocol → Tool Execution: runs tools
src/Netclaw.Actors/Sessions/Pipelines/SessionToolExecutionPipeline.cs - Session Protocol → Session Compaction: compacts history
- Session Protocol → Memory Recall: recalls memories
- Daemon → LLM Providers: configures providers
- LLM Providers → LLM Service: sends requests
- Tool Execution → Background Jobs: dispatches jobs
src/Netclaw.Actors/Sessions/Pipelines/SessionToolExecutionPipeline.cs - Daemon → Reminders: runs schedules
- Memory Recall → Memory Curation: searches memories
- Embedding Warmup → Memory Curation: repairs embeddings
- Daemon → Skill Feeds: manages feeds
- Daemon → Session Storage: persists sessions
README.md - Session Storage → Storage Layout: creates layouts
src/Netclaw.Daemon/Gateway/SqliteSessionStorageResolver.cs - Daemon → Configuration: reads settings
README.md - Configuration → OAuth Token State: stores token state
src/Netclaw.Configuration/OAuthTokenExpiryStorage.cs - Chat Channels → Chat Platforms: sends responses