rsclaw 2026.5.1

AI Agent Engine Compatible with 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
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119

//! Simple token-bucket rate limiter for WS write operations.

use std::time::{Duration, Instant};

/// Per-connection token bucket rate limiter.
///
/// Write methods (sessions.send, chat.send, config.set, etc.) consume one
/// token per call.  Read methods (health, agents.list, etc.) are free.
/// Tokens refill at a fixed rate.
pub struct RateLimiter {
    tokens: u32,
    max_tokens: u32,
    last_refill: Instant,
    refill_interval: Duration,
}

impl RateLimiter {
    /// Create a new rate limiter.
    ///
    /// `max_tokens` is the burst capacity.  `refill_interval` is how often
    /// the full bucket is restored.  For example, 30 tokens with a 60-second
    /// refill means 30 write requests per minute.
    pub fn new(max_tokens: u32, refill_interval: Duration) -> Self {
        Self {
            tokens: max_tokens,
            max_tokens,
            last_refill: Instant::now(),
            refill_interval,
        }
    }

    /// Default limiter: 30 writes per minute.
    pub fn default_write_limiter() -> Self {
        Self::new(30, Duration::from_secs(60))
    }

    /// Try to consume one token.  Returns `true` if allowed, `false` if
    /// rate-limited.
    pub fn check(&mut self) -> bool {
        self.refill();
        if self.tokens > 0 {
            self.tokens -= 1;
            true
        } else {
            false
        }
    }

    /// Refill tokens based on elapsed time.
    fn refill(&mut self) {
        let elapsed = self.last_refill.elapsed();
        if elapsed >= self.refill_interval {
            self.tokens = self.max_tokens;
            self.last_refill = Instant::now();
        }
    }

    /// Returns true if the given method is a write operation that should
    /// be rate-limited.
    pub fn is_write_method(method: &str) -> bool {
        matches!(
            method,
            "sessions.send"
                | "sessions.create"
                | "sessions.patch"
                | "sessions.compact"
                | "sessions.reset"
                | "sessions.delete"
                | "chat.send"
                | "chat.abort"
                | "agents.create"
                | "agents.update"
                | "agents.delete"
                | "agent.send"
                | "config.set"
                | "config.patch"
                | "config.apply"
                | "cron.add"
                | "cron.remove"
                | "cron.run"
                | "cron.update"
                | "cron.delete"
                | "memory.store"
                | "exec.approval.set"
                | "exec.approval.resolve"
                | "system.shutdown"
                | "system.stop"
                | "system.restart"
                | "system.update.run"
                | "node.pair.request"
                | "node.pair.approve"
                | "node.pair.reject"
        )
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn allows_up_to_max() {
        let mut rl = RateLimiter::new(3, Duration::from_secs(60));
        assert!(rl.check());
        assert!(rl.check());
        assert!(rl.check());
        assert!(!rl.check());
    }

    #[test]
    fn write_methods_classified() {
        assert!(RateLimiter::is_write_method("sessions.send"));
        assert!(RateLimiter::is_write_method("chat.send"));
        assert!(RateLimiter::is_write_method("config.set"));
        assert!(!RateLimiter::is_write_method("health"));
        assert!(!RateLimiter::is_write_method("agents.list"));
        assert!(!RateLimiter::is_write_method("models.list"));
    }
}