openclaw-core 0.1.0

Core types, configuration, and storage for OpenClaw
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

# openclaw-core

> **Core infrastructure for the community Rust implementation of [OpenClaw](https://github.com/openclaw/openclaw)**

[![Crates.io](https://img.shields.io/crates/v/openclaw-core.svg)](https://crates.io/crates/openclaw-core)
[![Documentation](https://docs.rs/openclaw-core/badge.svg)](https://docs.rs/openclaw-core)
[![License](https://img.shields.io/badge/license-MIT-blue.svg)](../../LICENSE)

Part of [openclaw-rs](https://github.com/openclaw/openclaw-rs), a community Rust implementation of [OpenClaw](https://github.com/openclaw/openclaw). This crate provides core types, configuration, events, and security primitives.

## Features

- **Types**: Core identifiers (AgentId, SessionKey, ChannelId, PeerId)
- **Config**: JSON5 configuration loading and validation
- **Events**: Append-only event store with CRDT projections (sled-backed)
- **Secrets**: AES-256-GCM encrypted credential storage
- **Auth**: Authentication profile management
- **Validation**: Input validation and sanitization

## Usage

```rust
use openclaw_core::{Config, EventStore, SessionEvent, SessionEventKind, ApiKey};

// Load configuration
let config = Config::load()?;

// Create event store
let store = EventStore::open(Path::new("~/.openclaw/sessions"))?;

// Append event
let event = SessionEvent::new(
    session_key,
    "default".to_string(),
    SessionEventKind::MessageReceived {
        content: "Hello".to_string(),
        attachments: vec![],
    },
);
store.append(&event)?;

// Get projection
let projection = store.get_projection(&session_key)?;

// Secure API key handling
let key = ApiKey::new("sk-...".to_string());
println!("{}", key); // Prints "[REDACTED]"
```

## License

MIT License - see [LICENSE](../../LICENSE) for details.