Expand description
ZeptoClaw - Ultra-lightweight personal AI assistant
Re-exports§
pub use agent::CompactionStrategy;pub use agent::ContextMonitor;pub use config::CompactionConfig;pub use safety::taint::TaintConfig;pub use safety::taint::TaintEngine;pub use safety::taint::TaintLabel;pub use safety::taint::TaintViolation;pub use safety::SafetyConfig;pub use safety::SafetyLayer;pub use safety::SafetyResult;pub use agent::AgentLoop;pub use agent::ContextBuilder;pub use agent::SwarmScratchpad;pub use agent::ZeptoAgent;pub use agent::ZeptoAgentBuilder;pub use bus::InboundMessage;pub use bus::MediaAttachment;pub use bus::MediaType;pub use bus::MessageBus;pub use bus::OutboundMessage;pub use channels::AcpChannel;pub use channels::BaseChannelConfig;pub use channels::Channel;pub use channels::ChannelManager;pub use channels::ChannelPluginAdapter;pub use channels::SlackChannel;pub use channels::TelegramChannel;pub use channels::WhatsAppCloudChannel;pub use config::Config;pub use cron::CronJob;pub use cron::CronPayload;pub use cron::CronSchedule;pub use cron::CronService;pub use cron::OnMiss;pub use error::ProviderError;pub use error::Result;pub use error::ZeptoError;pub use heartbeat::ensure_heartbeat_file;pub use heartbeat::HeartbeatResult;pub use heartbeat::HeartbeatService;pub use heartbeat::HEARTBEAT_PROMPT;pub use providers::ChatOptions;pub use providers::ClaudeProvider;pub use providers::LLMProvider;pub use providers::LLMResponse;pub use providers::LLMToolCall;pub use providers::OpenAIProvider;pub use providers::ToolDefinition;pub use providers::Usage;pub use runtime::available_runtimes;pub use runtime::create_runtime;pub use runtime::CommandOutput;pub use runtime::ContainerConfig;pub use runtime::ContainerRuntime;pub use runtime::DockerRuntime;pub use runtime::NativeRuntime;pub use runtime::RuntimeError;pub use runtime::RuntimeResult;pub use config::ContainerAgentBackend;pub use gateway::generate_env_file_content;pub use gateway::is_docker_available;pub use gateway::is_docker_available_with_binary;pub use gateway::parse_marked_response;pub use gateway::resolve_backend;pub use gateway::AgentRequest;pub use gateway::AgentResponse;pub use gateway::AgentResult;pub use gateway::ContainerAgentProxy;pub use gateway::ResolvedBackend;pub use gateway::StartupGuard;pub use gateway::RESPONSE_END_MARKER;pub use gateway::RESPONSE_START_MARKER;pub use health::get_rss_bytes;pub use health::health_port;pub use health::start_health_server;pub use health::start_health_server_legacy;pub use health::start_periodic_usage_flush;pub use health::HealthCheck;pub use health::HealthRegistry;pub use health::HealthStatus;pub use health::UsageMetrics;pub use security::validate_extra_mounts;pub use security::validate_path_in_workspace;pub use security::AgentMode;pub use security::AgentModeConfig;pub use security::CategoryPermission;pub use security::DeviceInfo;pub use security::ModePolicy;pub use security::PairedDevice;pub use security::PairingManager;pub use security::SafePath;pub use security::ShellAllowlistMode;pub use security::ShellSecurityConfig;pub use session::Message;pub use session::Role;pub use session::Session;pub use session::SessionManager;pub use session::ToolCall;pub use tools::composed::CreateToolTool;pub use tools::cron::CronTool;pub use tools::custom::CustomTool;pub use tools::delegate::DelegateTool;pub use tools::spawn::SpawnTool;pub use tools::BinaryPluginTool;pub use tools::BrowserTool;pub use tools::DocxReadTool;pub use tools::EchoTool;pub use tools::FindTool;pub use tools::GitTool;pub use tools::GoogleSheetsTool;pub use tools::GrepTool;pub use tools::HardwareTool;pub use tools::HttpRequestTool;pub use tools::MemoryGetTool;pub use tools::MemorySearchTool;pub use tools::MessageTool;pub use tools::PdfReadTool;pub use tools::ProjectTool;pub use tools::R8rTool;pub use tools::ReminderTool;pub use tools::SearxngSearchTool;pub use tools::StripeTool;pub use tools::Tool;pub use tools::ToolCategory;pub use tools::ToolContext;pub use tools::ToolRegistry;pub use tools::WebFetchTool;pub use tools::WebSearchTool;pub use tools::WhatsAppTool;
Modules§
- agent
- Agent module - Core AI agent logic and conversation handling
- audit
- Structured audit logging for security-sensitive events.
- auth
- OAuth authentication module for LLM providers.
- batch
- Batch processing of multiple prompts from a file.
- bus
- Message Bus Module
- cache
- LLM response caching with TTL, LRU eviction, and JSON persistence.
- channels
- Channels module - Communication channels (Telegram, Discord, etc.)
- config
- Configuration management for ZeptoClaw
- cron
- Cron service for scheduling background agent turns.
- deps
- Dependency manager — install, lifecycle, and health check for external deps.
- devices
- Device event system — monitors hardware events and notifies the agent.
- error
- Error types for ZeptoClaw
- gateway
- Gateway module for containerized agent support
- hands
- Hands-lite registry and manifest parsing.
- hardware
- Hardware discovery – USB device enumeration, board registry, and introspection.
- health
- HTTP health server for ZeptoClaw.
- heartbeat
- Heartbeat service - periodic agent wake-up for background tasks.
- hooks
- Hook system for ZeptoClaw agent loop.
- kernel
- Thin kernel — coordination, not orchestration.
- mcp_
server - MCP Server — exposes ZeptoClaw tools to MCP-capable clients.
- memory
- Workspace memory utilities (OpenClaw-style markdown memory).
- migrate
- OpenClaw → ZeptoClaw migration module.
- peripherals
- Hardware peripherals – STM32, Arduino, RPi GPIO, etc.
- plugins
- Plugin system for ZeptoClaw
- providers
- Providers module - LLM providers (OpenAI, Anthropic, etc.)
- r8r_
bridge - r8r bridge integration for ZeptoClaw.
- routines
- Routines — event/webhook/cron triggered automations.
- runtime
- Container runtime module for ZeptoClaw
- safety
- Safety layer for ZeptoClaw — output sanitization and threat detection.
- security
- Security module for ZeptoClaw
- session
- Session module - Session and conversation state management
- skills
- Skills system - markdown skill discovery and loading.
- tools
- Tools module - Tool definitions and execution for LLM function calling
- transcription
- Provider-agnostic audio transcription service.
- tunnel
- Tunnel module for exposing local ports via public URLs.
- utils
- Utils module - Utility functions and helpers
Macros§
- log_
component - Emit a component-tagged tracing event.