Restructure deployment guide: local, VPS, Docker, VPS+Docker, OpenClaw

Clear separation of all deployment scenarios:
- Local desktop: bun add + snowball login
- VPS: import token or install Chromium
- Docker: install in container + import token
- VPS+Docker: SSH → docker exec chain for install + token
- OpenClaw: clawhub install (local) or skills add (Docker)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: baixianger

README.md

@@ -35,6 +35,9 @@ bun add -g snowball-cli
 # AI agent skill (Claude Code, Cursor, Windsurf, etc.)
 npx skills add https://github.com/baixianger/snowball-cli     # or
 bunx skills add https://github.com/baixianger/snowball-cli
+
+# OpenClaw agent
+clawhub install baixianger/snowball-cli
 ```
 
 ## Quick start
@@ -228,62 +231,80 @@ Browser detection order: `CHROME_PATH` env → `--chrome` flag → Chrome → Ch
 
 Auto headless: on Linux without `DISPLAY`, Chrome launches with `--headless` automatically.
 
-## Headless / VPS deployment
+## Deployment guide
 
-No Chrome needed — transfer your token from a local machine:
+### Local desktop (macOS / Windows / Linux)
 
 ```bash
-# One-liner: export from local, import on VPS
-ssh vps "snowball import $(snowball export)"
-
-# Or step by step
-snowball export                    # prints base64 on local machine
-ssh vps "snowball import <base64>" # paste on VPS
+bun add -g snowball-cli
+snowball login    # QR in terminal, simplest
 ```
 
-Alternatively, install Chromium on the VPS and login there:
+### VPS (headless server)
 
-```bash
-# Debian/Ubuntu
-apt install -y chromium-browser
-snowball login    # auto-detects headless, QR shows in SSH terminal
+**Option A: Import token from local (recommended, no browser needed)**
 
-# Custom path
-snowball login --chrome /snap/bin/chromium
+```bash
+ssh vps "curl -fsSL https://bun.sh/install | bash && ~/.bun/bin/bun add -g snowball-cli"
+ssh vps "~/.bun/bin/snowball import $(snowball export)"
 ```
 
-## Docker / OpenClaw integration
+**Option B: Install Chromium on VPS and login there**
 
-In Docker containers or AI agent platforms (OpenClaw, etc.) where there's no browser:
+```bash
+ssh vps "apt install -y chromium-browser"
+ssh vps "~/.bun/bin/snowball login"    # auto-headless, QR in SSH terminal
+```
 
-**New image:**
+### Docker container
 
-```dockerfile
-FROM oven/bun:latest
-RUN bun add -g snowball-cli
+```bash
+docker exec <container> bash -c "
+  curl -fsSL https://bun.sh/install | bash
+  ~/.bun/bin/bun add -g snowball-cli
+"
+docker exec <container> ~/.bun/bin/snowball import $(snowball export)
 ```
 
-**Running container** (e.g. OpenClaw, persistent dir at `/home/node/.openclaw`):
+For persistence, install bun into a mounted volume (see OpenClaw section below).
+
+### VPS + Docker (e.g. OpenClaw on VPS)
 
 ```bash
-# Install bun + snowball-cli into OpenClaw's persistent workspace
-docker exec <container> bash -c "
+# Install inside Docker container on VPS
+ssh vps "docker exec <container> bash -c '
   export BUN_INSTALL=/home/node/.openclaw/.bun
   curl -fsSL https://bun.sh/install | bash
   /home/node/.openclaw/.bun/bin/bun add -g snowball-cli
-"
+'"
 
-# Import token from host
-docker exec <container> /home/node/.openclaw/.bun/bin/snowball import $(snowball export)
+# Import token: local → VPS → Docker container
+ssh vps "docker exec <container> /home/node/.openclaw/.bun/bin/snowball import $(snowball export)"
 ```
 
-Everything lives under `/home/node/.openclaw/` — survives container restarts.
+## OpenClaw integration
 
-**Install as AgentSkill** (inside container or on host with OpenClaw workspace mounted):
+**Local OpenClaw:**
 
 ```bash
-cd /home/node/.openclaw/workspace    # or your mounted workspace path
-bunx skills add https://github.com/baixianger/snowball-cli
+clawhub install baixianger/snowball-cli
+```
+
+**Docker OpenClaw** (persistent dir `/home/node/.openclaw`):
+
+```bash
+# Install AgentSkill
+docker exec <container> bash -c "
+  cd /home/node/.openclaw/workspace
+  /home/node/.openclaw/.bun/bin/bunx skills add https://github.com/baixianger/snowball-cli
+"
+```
+
+**Custom Docker image:**
+
+```dockerfile
+FROM oven/bun:latest
+RUN bun add -g snowball-cli
 ```
 
 ## License

README.zh-CN.md

@@ -35,6 +35,9 @@ bun add -g snowball-cli
 # AI Agent 技能（Claude Code、Cursor、Windsurf 等）
 npx skills add https://github.com/baixianger/snowball-cli     # 或
 bunx skills add https://github.com/baixianger/snowball-cli
+
+# OpenClaw agent
+clawhub install baixianger/snowball-cli
 ```
 
 ## 快速开始
@@ -228,62 +231,119 @@ snowball login
 
 自动无头：Linux 上没有 `DISPLAY` 时，Chrome 自动以 `--headless` 模式启动。
 
-## 无头服务器 / VPS 部署
+## 部署指南
+
+### 本地桌面（macOS / Windows / Linux 桌面）
+
+```bash
+bun add -g snowball-cli
+snowball login    # 终端内扫码，最简单
+```
+
+### VPS（无头服务器）
 
-不需要浏览器 — 从本地机器传输 token：
+**方式 A：从本地导入 token（推荐，不需要浏览器）**
 
 ```bash
-# 一行搞定：本地导出，VPS 导入
-ssh vps "snowball import $(snowball export)"
+# 先在 VPS 上装 snowball-cli
+ssh vps "curl -fsSL https://bun.sh/install | bash && ~/.bun/bin/bun add -g snowball-cli"
 
-# 或者分步
-snowball export                    # 本地打印 base64
-ssh vps "snowball import <base64>" # VPS 上粘贴
+# 一行导入 token
+ssh vps "~/.bun/bin/snowball import $(snowball export)"
 ```
 
-也可以在 VPS 上装 Chromium 直接扫码登录：
+**方式 B：VPS 上装 Chromium 直接登录**
 
 ```bash
 # Debian/Ubuntu
-apt install -y chromium-browser
-snowball login    # 自动检测无头模式，二维码在 SSH 终端显示
+ssh vps "apt install -y chromium-browser"
+ssh vps "~/.bun/bin/snowball login"    # 自动无头模式，QR 在 SSH 终端显示
+```
+
+### Docker 容器
 
-# 指定路径
-snowball login --chrome /snap/bin/chromium
+```bash
+# 进容器装 bun + snowball-cli
+docker exec <容器> bash -c "
+  curl -fsSL https://bun.sh/install | bash
+  ~/.bun/bin/bun add -g snowball-cli
+"
+
+# 从宿主机导入 token
+docker exec <容器> ~/.bun/bin/snowball import $(snowball export)
 ```
 
-## Docker / OpenClaw 集成
+如果需要持久化，把 bun 装到挂载目录（见下方 OpenClaw 章节）。
 
-在 Docker 容器或 AI Agent 平台（OpenClaw 等）中没有浏览器：
+### VPS 上的 Docker（如 VPS 上跑 OpenClaw）
 
-**新镜像：**
+```bash
+# 先确保本地已登录
+snowball status
 
-```dockerfile
-FROM oven/bun:latest
-RUN bun add -g snowball-cli
+# SSH 到 VPS，在 Docker 容器内安装并导入
+ssh vps "docker exec <容器> bash -c '
+  export BUN_INSTALL=/home/node/.openclaw/.bun
+  curl -fsSL https://bun.sh/install | bash
+  /home/node/.openclaw/.bun/bin/bun add -g snowball-cli
+'"
+
+# 本地 → VPS → Docker 容器，一行导入 token
+ssh vps "docker exec <容器> /home/node/.openclaw/.bun/bin/snowball import $(snowball export)"
 ```
 
-**已运行的容器**（如 OpenClaw，持久化目录 `/home/node/.openclaw`）：
+## OpenClaw 集成
+
+### 本机运行的 OpenClaw
+
+直接从 ClawHub 安装：
+
+```bash
+clawhub install baixianger/snowball-cli
+```
+
+导入 token（OpenClaw agent 调用 snowball 命令时需要）：
+
+```bash
+snowball export | xargs -I {} snowball import {}
+# 或者直接用同一台机器的 token，无需导入
+```
+
+### Docker 中的 OpenClaw
+
+OpenClaw 的持久化目录是 `/home/node/.openclaw`，安装到这里容器重启不丢。
+
+**Step 1：在容器中安装 bun + snowball-cli**
 
 ```bash
-# 在 OpenClaw 持久化目录中安装 bun + snowball-cli
 docker exec <容器> bash -c "
   export BUN_INSTALL=/home/node/.openclaw/.bun
   curl -fsSL https://bun.sh/install | bash
   /home/node/.openclaw/.bun/bin/bun add -g snowball-cli
 "
+```
 
-# 从宿主机导入 token
+**Step 2：从宿主机导入 token**
+
+```bash
 docker exec <容器> /home/node/.openclaw/.bun/bin/snowball import $(snowball export)
 ```
 
-全部装在 `/home/node/.openclaw/` 下，容器重启不丢。
-
-**作为 AgentSkill 安装**（在容器内或宿主机挂载的 workspace 目录中）：
+**Step 3：安装 AgentSkill**
 
 ```bash
-cd /home/node/.openclaw/workspace    # 或宿主机上的挂载路径
-bunx skills add https://github.com/baixianger/snowball-cli
+# 在容器内
+docker exec <容器> bash -c "
+  cd /home/node/.openclaw/workspace
+  /home/node/.openclaw/.bun/bin/bunx skills add https://github.com/baixianger/snowball-cli
+"
+```
+
+### 自建 Docker 镜像
+
+```dockerfile
+FROM oven/bun:latest
+RUN bun add -g snowball-cli
 ```
 
 ## 协议