clawshell 0.0.1

A security privileged process for the OpenClaw ecosystem.
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
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147

use crate::process;

use clap::builder::Styles;
use clap::builder::styling::{Ansi256Color, AnsiColor, Color, Effects, Style};
use clap::{Parser, Subcommand};

fn default_config_path() -> String {
    process::default_config_path()
        .to_string_lossy()
        .into_owned()
}

/// The banner line shown before every --help output.
const BANNER: &str =
    "\n  🦊🦀 \x1b[1;38;5;208mClawShell\x1b[0m  \x1b[38;5;208mSecuring OpenClaw\x1b[0m\n";

/// Build clap Styles using our theme color: xterm-256 color 208 ≈ RGB(236, 142, 65).
const fn cli_styles() -> Styles {
    const THEME: Option<Color> = Some(Color::Ansi256(Ansi256Color(208)));

    Styles::styled()
        .header(Style::new().fg_color(THEME).effects(Effects::BOLD))
        .usage(Style::new().fg_color(THEME).effects(Effects::BOLD))
        .literal(Style::new().fg_color(THEME))
        .placeholder(Style::new().fg_color(Some(Color::Ansi(AnsiColor::BrightBlack))))
        .valid(
            Style::new()
                .fg_color(Some(Color::Ansi(AnsiColor::Green)))
                .effects(Effects::BOLD),
        )
        .invalid(
            Style::new()
                .fg_color(Some(Color::Ansi(AnsiColor::Red)))
                .effects(Effects::BOLD),
        )
        .error(
            Style::new()
                .fg_color(Some(Color::Ansi(AnsiColor::Red)))
                .effects(Effects::BOLD),
        )
}

#[derive(Parser)]
#[command(
    name = "clawshell",
    about = "The security middleware designed to strap onto the OpenClaw ecosystem.",
    version,
    styles = cli_styles(),
    before_help = BANNER,
    after_help = "EXAMPLES:\n  \
        clawshell start                       Start with default config\n  \
        clawshell start -c /etc/clawshell/clawshell.toml  Start with a custom config\n  \
        clawshell stop                        Stop ClawShell\n  \
        clawshell status                      Check if ClawShell is running\n  \
        clawshell restart                     Restart ClawShell\n  \
        clawshell logs --level error          Show only error logs\n  \
        clawshell logs --filter \"timeout\"     Filter logs by keyword\n  \
        clawshell config                      Display current configuration\n  \
        clawshell config --edit               Edit the configuration file\n  \
        clawshell onboard                     Set up the clawshell system user\n  \
        clawshell uninstall                   Remove ClawShell from the system\n  \
        clawshell version                     Show version information"
)]
#[derive(Debug)]
pub struct Cli {
    #[command(subcommand)]
    pub command: Commands,
}

#[derive(Debug, Subcommand)]
pub enum Commands {
    /// Start ClawShell
    #[command(before_help = BANNER)]
    Start {
        /// Path to the configuration file
        #[arg(short, long, default_value_t = default_config_path())]
        config: String,

        /// Run in the foreground (don't daemonize)
        #[arg(short, long)]
        foreground: bool,
    },

    /// Stop ClawShell
    #[command(before_help = BANNER)]
    Stop,

    /// Check the status of ClawShell
    #[command(before_help = BANNER)]
    Status,

    /// Restart ClawShell
    #[command(before_help = BANNER)]
    Restart {
        /// Path to the configuration file
        #[arg(short, long, default_value_t = default_config_path())]
        config: String,
    },

    /// View ClawShell logs
    #[command(before_help = BANNER)]
    Logs {
        /// Filter by log level (trace, debug, info, warn, error)
        #[arg(short, long)]
        level: Option<String>,

        /// Filter logs by keyword
        #[arg(short, long)]
        filter: Option<String>,

        /// Number of lines to show (default: 50)
        #[arg(short, long, default_value = "50")]
        num: usize,

        /// Follow log output (like tail -f)
        #[arg(long)]
        follow: bool,
    },

    /// View and edit the ClawShell configuration
    #[command(before_help = BANNER)]
    Config {
        /// Path to the configuration file
        #[arg(short = 'f', long = "file", default_value_t = default_config_path())]
        config: String,

        /// Open the configuration file in an editor
        #[arg(short, long)]
        edit: bool,
    },

    /// Set up the clawshell system user and permissions
    #[command(before_help = BANNER)]
    Onboard,

    /// Completely uninstall ClawShell from the system
    #[command(before_help = BANNER)]
    Uninstall {
        /// Skip the confirmation prompt
        #[arg(short = 'y', long)]
        yes: bool,
    },

    /// Show the current version of ClawShell
    #[command(before_help = BANNER)]
    Version,
}