private-chat

# Private Chat Skill

A skill for OpenClaw that enables encrypted conversation mode. Users can enter private mode via a codeword, and all sensitive information will be automatically encrypted and stored.

## Features

- 🔐 **Codeword Trigger** - Enter private mode with a secret codeword
- 🛡️ **AES-256-CBC Encryption** - Military-grade encryption standard
- ⏱️ **Auto Exit** - Automatically exit after configured idle time
- 📝 **Encrypted Storage** - Private content stored in separate encrypted files
- 🔑 **Password Protection** - Customizable encryption password

## Installation

```bash
clawhub install private-chat
```

## Configuration

1. Copy the example config:
```bash
cp config.example.json config.json
```

2. Edit `config.json`:
```json
{
  "codeword": "your-secret-codeword",
  "password": "your-encryption-password",
  "autoExitMinutes": 1,
  "storageFile": "memory/private-vault.md"
}
```

## Usage

### Enter Private Mode

User enters the codeword (default: `lgbt`):
```
lgbt
```

AI responds:
```
Entering Private Mode 🔒

Welcome back. How can I help you?
```

### Store Sensitive Information

In private mode, tell AI sensitive info directly:
```
My bank card password is 123456
```

AI will auto-encrypt and respond:
```
Securely stored ✅

Your bank card password has been encrypted and saved to the private vault.

Storage: memory/private-vault.md
Encryption: AES-256-CBC
```

### Retrieve Encrypted Content

In private mode, ask:
```
What's my bank card password?
```

AI will decrypt and show:
```
Your bank card password: 123456
```

### Exit Private Mode

Automatically exits after configured idle time (default: 1 minute).

Or manually send exit codeword:
```
exit
```

## Decryption Methods

### Command Line

```bash
# Method 1: Direct decryption
./scripts/private-vault.sh decrypt "your-password" "ENC[v1:SALT:BASE64]"

# Method 2: Interactive
cd skills/private-chat
./scripts/private-vault.sh interactive
```

### Manual Decryption

Encrypted format: `ENC[v1:SALT:B...

# Private Chat for OpenClaw

🔐 Private Chat Mode - Add encrypted conversation capabilities to your OpenClaw assistant

[📖 中文文档](README.zh.md)

## Features

- 🔑 **Codeword Trigger** - Enter private mode with a secret codeword
- 🛡️ **AES-256-CBC Encryption** - Military-grade encryption for sensitive information
- ⏱️ **Auto Timeout** - Automatic exit to prevent information leakage
- 📝 **Secure Storage** - Encrypted content stored in separate files
- 🔓 **Decrypt Anytime** - Command-line and interactive decryption tools provided

## Demo

### Enter Private Mode
```
User: lgbt
AI: Entering Private Mode 🔒
    Welcome back. How can I help you?
```

### Store Sensitive Information
```
User: My bank card password is 123456
AI: Securely stored ✅
    Your bank card password has been encrypted and saved.
    Storage: memory/private-vault.md
    Encryption: AES-256-CBC
```

### Retrieve Encrypted Content
```
User: What's my bank card password?
AI: Your bank card password: 123456
```

## Installation

```bash
clawhub install private-chat
```

## Configuration

1. Copy example config:
```bash
cd skills/private-chat
cp config.example.json config.json
```

2. Edit `config.json`:
```json
{
  "codeword": "your-secret-codeword",
  "password": "your-encryption-password",
  "autoExitMinutes": 1,
  "storageFile": "memory/private-vault.md"
}
```

## Encryption Format

All encrypted content uses standard format:
```
ENC[v1:SALT:BASE64]
```

Example:
```
ENC[v1:a1b2c3d4:U2FsdGVkX1+...]
```

## Decryption Tools

### Command Line

```bash
# Encrypt
./scripts/private-vault.sh encrypt "password" "secret text"

# Decrypt
./scripts/private-vault.sh decrypt "password" "ENC[v1:...]"

# Interactive
./scripts/private-vault.sh interactive
```

### Using OpenSSL

```bash
echo "BASE64_CONTENT" | base64 -d | \
  openssl enc -aes-256-cbc -d -k "password" -pbkdf2
```

## Security Tips

⚠️ **Please ensure:**
- Use a strong password (16+ chars, mixed case + numbers + symbols)
- Regularly backup `mem...