SmolClaw

SmolClaw is a modular autonomous-agent runtime. The repository contains the runtime core, provider and channel integrations, tool execution surfaces, security policy layers, plugin support, tests, and deployment helpers.

Features

• C runtime core with explicit ownership, structured sc_status errors, and stable public contracts under include/sc/.
• Provider routing for built-in and OpenAI-compatible model providers.
• Channel orchestration for CLI, Telegram, webhooks, and other integration surfaces.
• Tool execution framework with policy checks, receipts, workspace boundaries, and sandbox backends.
• Memory backends for local retrieval and persistence, including markdown, SQLite, and no-op implementations.
• Gateway, observability, configuration, localization, media, hardware, and plugin subsystems behind modular build flags.
• Native plugin support with optional Python script and WASM-related surfaces depending on build configuration.
• Validation support for unit tests, sanitizers, static analysis, dependency inventory, and generated documentation checks.

Repository Map

Path	Purpose
include/sc/	Stable public C API and ABI-facing contracts.
src/	Runtime, providers, channels, tools, security, memory, gateway, plugins, hardware, and support modules.
tests/	Unit tests, fixtures, fake modules, and plugin test support.
docs/	Architecture, module, configuration, lifecycle, and operations documentation.
examples/	Script and WASM plugin examples.
vendor/	Isolated third-party dependency sources.
tools/	Validation, generated-doc, and static-analysis helpers.

Build And Test

make build
make test
make validate

Useful direct CMake entry points:

cmake --preset release
cmake --build --preset release

cmake --preset asan
cmake --build --preset asan
ctest --test-dir build/asan --output-on-failure

Documentation

• Architecture overview
• Modular architecture map
• Module map
• Request lifecycle
• Runtime event loop
• Configuration
• Feature flags
• ABI policy
• C23 style guide
• Security model
• Dependency inventory
• Service management
• Run Telegram Bot With OpenAI

Acknowledgements

This project is inspired by the design and architecture of the ZeroClaw runtime.