clawmacdo 0.79.0 → 0.81.0

package/README.md

@@ -152,6 +152,9 @@ clawmacdo wiki-tree --instance <deploy-id> --project llm_wiki --json
 clawmacdo wiki-read --instance <deploy-id> --path llm_wiki/INDEX.md --json
 clawmacdo wiki-write --instance <deploy-id> --path llm_wiki/INDEX.md \
   --content-file /tmp/INDEX.md --base-sha <sha-from-read> --json
+clawmacdo wiki-ingest --instance <deploy-id> --project wiki-163327 \
+  --source /tmp/uploaded-doc.md \
+  --prompt "Decide where this belongs and update related pages." --json
 clawmacdo wiki-export --instance <deploy-id> --project llm_wiki --json
 
 # Regenerate the OpenClaw gateway token
@@ -454,6 +457,22 @@ clawmacdo ls-restore \
   --size s-4vcpu-8gb
 ```
 
+### Fast Lightsail Restore + OpenClaw Readiness
+
+Restore a Lightsail snapshot and immediately configure Telegram pairing, OpenClaw identity, and the Remotion avatar `.env` once SSH is ready. The command batches remote edits into one SSH session and checks the Tailscale public URL and Remotion cloudflared tunnel in parallel.
+
+```bash
+clawmacdo ls-restore-fast \
+  --snapshot-name "my-openclaw-backup" \
+  --telegram-bot-token "$TELEGRAM_TOKEN" \
+  --owner-name "Kenny" \
+  --openclaw-name "John" \
+  --avatar-name "John" \
+  --json
+```
+
+Use `--telegram-pair-code <CODE>` when you already have an 8-character Telegram pairing code to approve in the same run. The default fast budgets are `--active-timeout-secs 120` and `--ssh-timeout-secs 30`; actual restore time still depends on Lightsail making the instance runnable.
+
 ### Destroy an Instance
 
 Delete an instance by name across any supported provider. Removes cloud SSH key, local key, and (for BytePlus) EIP and VPC resources.
@@ -617,11 +636,15 @@ clawmacdo wiki-write --instance my-server --path llm_wiki/new-page.md \
   --content-file /tmp/new-page.md \
   --base-sha NEW \
   --json
+clawmacdo wiki-ingest --instance my-server --project wiki-163327 \
+  --source /tmp/uploaded-doc.md \
+  --prompt "Decide where this belongs, update existing pages if needed, create new pages if needed, update index/log." \
+  --json
 clawmacdo wiki-export --instance my-server --project llm_wiki --output ~/backups/ --json
 clawmacdo wiki-delete --instance my-server --project wiki-163327 --json
 ```
 
-These commands resolve the configured OpenClaw agent workspace on the instance and only operate on safe relative Markdown paths under that workspace. `wiki-read` returns `content`, `sha256`, `mtime`, and `size`; `wiki-write` requires `--base-sha` so a web app cannot overwrite a file that changed after it was opened. Use `--base-sha NEW` only when creating a new file. `wiki-index` returns per-page hashes plus headings, tags, and Markdown/wiki links for graph or navigation UIs. `wiki-delete` is intentionally narrower: it only deletes a direct `workspace/wiki-*` project folder and rejects empty names, absolute paths, traversal, symlinks, files, and non-`wiki-*` slugs.
+These commands resolve the configured OpenClaw agent workspace on the instance and only operate on safe relative Markdown paths under that workspace. `wiki-read` returns `content`, `sha256`, `mtime`, and `size`; `wiki-write` requires `--base-sha` so a web app cannot overwrite a file that changed after it was opened. Use `--base-sha NEW` only when creating a new file. `wiki-index` returns per-page hashes plus headings, tags, and Markdown/wiki links for graph or navigation UIs. `wiki-ingest` uploads a converted Markdown source into `<project>/raw/sources/`, launches Claude Code inside that project to decide where the content belongs, and returns `{ project, source_files, changed_files, summary }` JSON for app integrations. `wiki-delete` is intentionally narrower: it only deletes a direct `workspace/wiki-*` project folder and rejects empty names, absolute paths, traversal, symlinks, files, and non-`wiki-*` slugs.
 
 ### Gateway Token Rotation
 
@@ -891,9 +914,40 @@ execSync(`${bin} deploy --provider lightsail ...`, { stdio: "inherit" });
 | `CLAWMACDO_API_KEY` | API key protecting `/api/*` endpoints | Optional (Web UI) |
 | `CLAWMACDO_PIN` | 6-digit PIN for web UI login page | Optional (Web UI) |
 | `CLAWMACDO_BIND` | Server bind address (default: `127.0.0.1`) | Optional (Web UI) |
+| `CLAWMACDO_STATE_DIR` | Directory for deploy records, SSH keys, backups, and `deployments.db` (default: `~/.clawmacdo`) | Optional |
 | `SKILLS_API_URL` | Railway skills API base URL | For skill commands |
 | `USER_SKILLS_API_KEY` | API key for user-skills endpoints | For skill commands |
 
+## Railway Persistence
+
+When running `clawmacdo serve` on Railway, attach a Railway Volume at:
+
+```text
+/app/.clawmacdo
+```
+
+This repository includes a root `Dockerfile` and `railway.toml` for the web UI. Railway should build the Rust binary and start:
+
+```sh
+clawmacdo serve --port "$PORT"
+```
+
+If Railway still starts `node /app/server.js`, remove the service-level start command override in Railway and redeploy from this repository config.
+
+Set `CLAWMACDO_STATE_DIR=/app/.clawmacdo` so deploy records, SSH keys, backups, and `deployments.db` survive redeploys. The Docker image sets this by default. If Railway provides `RAILWAY_VOLUME_MOUNT_PATH=/app/.clawmacdo`, clawmacdo also auto-detects that mount path.
+
+Railway Volumes are mounted as root by default. For non-root container images, either set `RAILWAY_RUN_UID=0` as a quick operational fix, or chown the mounted directory in the hosting app image before starting the server:
+
+```sh
+mkdir -p /app/.clawmacdo
+chown -R nextjs:nodejs /app/.clawmacdo
+exec "$@"
+```
+
+Without a persistent volume, Railway redeploys can remove `deploys/`, `keys/`, and `deployments.db`. Existing cloud instances may then be unreachable from clawmacdo unless the old deploy record and SSH private key can be recovered; after attaching the volume, destroy/recreate those orphaned instances and provision again.
+
+Railway references: [Volumes](https://docs.railway.com/volumes), [Volume permissions](https://docs.railway.com/reference/volumes).
+
 ## Skills Data API
 
 The `skills-data-api/` directory contains a standalone Node.js/Express service for browsing and serving Claude Code skill marketplace data, backed by MongoDB.
@@ -1078,4 +1132,4 @@ See [CHANGELOG.md](CHANGELOG.md) for version history and release notes.
 
 ---
 
-**Current version:** 0.79.0
+**Current version:** 0.81.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawmacdo",
-  "version": "0.79.0",
+  "version": "0.81.0",
   "description": "CLI tool for deploying OpenClaw to multiple cloud providers with pre-installed AI dev tools",
   "keywords": [
     "openclaw",
@@ -30,8 +30,8 @@
     "node": ">=16"
   },
   "optionalDependencies": {
-    "@clawmacdo/darwin-arm64": "0.79.0",
-    "@clawmacdo/linux-x64": "0.79.0",
-    "@clawmacdo/win32-x64": "0.79.0"
+    "@clawmacdo/darwin-arm64": "0.81.0",
+    "@clawmacdo/linux-x64": "0.81.0",
+    "@clawmacdo/win32-x64": "0.81.0"
   }
 }