Skip to content

Setup UI: debug console + config editor + backup import#34

Merged
vignesh07 merged 2 commits into
mainfrom
setup-console-import
Jan 30, 2026
Merged

Setup UI: debug console + config editor + backup import#34
vignesh07 merged 2 commits into
mainfrom
setup-console-import

Conversation

@vignesh07

@vignesh07 vignesh07 commented Jan 30, 2026

Copy link
Copy Markdown
Owner

Summary

Adds Option A (safe command runner) and setup UI improvements for Railway deployments.

Also updates the README with an "Official template / endorsements" section and includes the Railway deploy-count screenshot.

Changes

  • /setup now includes a Debug Console (no shell; allowlisted actions):
    • wrapper-managed: gateway.start|stop|restart
    • CLI: openclaw status|health|doctor|--version, openclaw logs --tail N, openclaw config get <path>
  • /setup now includes an advanced raw config editor for the on-disk config (openclaw.json by default):
    • reload + save
    • on save: writes a timestamped .bak-* backup and restarts gateway
  • Adds Import backup support:
    • POST /setup/import with a .tar.gz created by /setup/export
    • extraction is limited to /data (Railway volume) + basic path traversal guards
    • stops gateway before restore, restarts after
  • README: add "Official template / endorsements" + deploy-count screenshot (assets/railway-deploys.jpg)

Notes / TODO

X (Twitter) blocks automated fetching in our environment, so the README includes TODO placeholders for the two endorsement tweet screenshots. If you upload those images to the repo, I can wire them in and remove the TODO text.

Security / guardrails

  • No interactive terminal / no arbitrary command execution
  • Import is only allowed when both OPENCLAW_STATE_DIR and OPENCLAW_WORKSPACE_DIR are under /data
  • Tar extraction filters unsafe paths (.., absolute paths, drive letters)

How to test

  • Deploy on Railway with a Volume mounted at /data
  • Set: OPENCLAW_STATE_DIR=/data/.openclaw, OPENCLAW_WORKSPACE_DIR=/data/workspace, SETUP_PASSWORD=...
  • Visit /setup:
    • run gateway.restart
    • run openclaw status and openclaw logs --tail 200
    • edit config and save (verify restart)
    • export backup, then import it back and confirm restart

@vignesh07 vignesh07 merged commit b51ebf3 into main Jan 30, 2026
1 check passed
gginesta pushed a commit to gginesta/clawdbot-railway-template that referenced this pull request Apr 28, 2026
- Added explicit rule to MEMORY.md Automated Maintenance Rules
- Added rule to fleet-wide OPERATIONAL-GUIDELINES.md (top priority)
- Added Lesson vignesh07#34 about this incident
- Updated daily memory with incident details
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant