clawmemory

# ClawMemory

Encrypted on-chain storage on BSC. Free tier: 10 named slots × 10KB each, permanent, no MMP needed.

---

## 🚀 ALWAYS START HERE — Check State First

**Every time this skill is triggered**, run the status check before anything else:

```bash
bash ~/.openclaw/workspace/skills/clawmemory/scripts/check-status.sh
```

Parse the JSON output and branch:

| Condition | Action |
|-----------|--------|
| `installed: false` | → **Step 1: Install** |
| `has_wallet: false` | → **Step 2: Create Wallet** |
| `has_bnb: false` | → **Step 3: Fund Wallet** |
| All true | → Ready, proceed to requested action |

---

## 📦 Step 1 — Install

```bash
bash ~/.openclaw/workspace/skills/clawmemory/scripts/install.sh
```

Say: "正在安装 ClawMemory，复制文件并安装依赖，大约需要 30 秒..."

After done, continue to Step 2.

---

## 👛 Step 2 — Create Wallet

```bash
bash ~/.openclaw/workspace/skills/clawmemory/scripts/setup-wallet.sh
```

Parse JSON output:
- Get `address` and `privateKey`
- Say to user:

> "✅ 钱包已创建！
>
> 钱包地址：`<address>`
>
> ⚠️ **请立即保存你的私钥，关闭此窗口后将无法再次查看：**
> `<privateKey>`
>
> 妥善保管私钥，任何人拿到私钥都能控制你的钱包。"

Wait for user to confirm they've saved the private key, then continue to Step 3.

---

## ⛽ Step 3 — Fund Wallet

Say to user:

> "需要少量 BNB 作为 Gas 费（手续费）。
>
> 请向以下地址转入 **0.01 BNB**（约 $5-6，足够使用很长时间）：
>
> `<wallet_address>`
>
> 可以从任何交易所或钱包转账，选择 **BNB Smart Chain (BSC)** 网络。
>
> 转账完成后告诉我，我来确认。"

After user confirms, check balance:

```bash
bash ~/.openclaw/workspace/skills/clawmemory/scripts/check-status.sh
```

- `has_bnb: true` → Continue to Step 4
- `has_bnb: false` → "还没收到，通常需要 1-2 分钟，稍等一下再确认？"

---

## 🎉 Step 4 — First Save (Guided Test)

Say:
> "太好了！现在来试一下第一次存储。"

Run a test save to the "default" slot:

```bash
node ~/.openclaw/workspace/skills/clawmemory/scripts/append-and-save.js \
  --slot "default"...