spawn/oracle
A f412fb69bc
ux: wait for OpenClaw gateway to be ready before launching TUI (#1385)
Fixes #1354 - users experienced a ~30s delay with "gateway not connected"
errors when trying to use OpenClaw immediately after launch.

Root cause: gateway takes time to bind to port 18789, but TUI launched
after only 2 seconds.

Solution: Add wait_for_openclaw_gateway() helper that polls the gateway
port (max 30s) before launching TUI, ensuring immediate usability.

Changes:
- shared/common.sh: Add wait_for_openclaw_gateway() function
- All openclaw.sh scripts (10 files): Replace sleep 2 with gateway readiness check

Agent: ux-engineer

Co-authored-by: B <6723574+louisgv@users.noreply.github.com>
Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-17 03:49:53 -05:00
..
lib feat: add server lifecycle management (reconnect + delete) (#1363) 2026-02-16 17:06:49 -08:00
aider.sh refactor: introduce cloud adapter + spawn_agent runner system (#1340) 2026-02-16 16:25:44 -08:00
amazonq.sh refactor: introduce cloud adapter + spawn_agent runner system (#1340) 2026-02-16 16:25:44 -08:00
claude.sh fix: use ~/.spawnrc for env vars instead of inlining into .bashrc (#1362) 2026-02-16 17:05:17 -08:00
cline.sh refactor: introduce cloud adapter + spawn_agent runner system (#1340) 2026-02-16 16:25:44 -08:00
codex.sh refactor: introduce cloud adapter + spawn_agent runner system (#1340) 2026-02-16 16:25:44 -08:00
continue.sh refactor: introduce cloud adapter + spawn_agent runner system (#1340) 2026-02-16 16:25:44 -08:00
gemini.sh refactor: introduce cloud adapter + spawn_agent runner system (#1340) 2026-02-16 16:25:44 -08:00
goose.sh refactor: introduce cloud adapter + spawn_agent runner system (#1340) 2026-02-16 16:25:44 -08:00
gptme.sh refactor: introduce cloud adapter + spawn_agent runner system (#1340) 2026-02-16 16:25:44 -08:00
interpreter.sh refactor: introduce cloud adapter + spawn_agent runner system (#1340) 2026-02-16 16:25:44 -08:00
kilocode.sh refactor: introduce cloud adapter + spawn_agent runner system (#1340) 2026-02-16 16:25:44 -08:00
nanoclaw.sh refactor: introduce cloud adapter + spawn_agent runner system (#1340) 2026-02-16 16:25:44 -08:00
openclaw.sh ux: wait for OpenClaw gateway to be ready before launching TUI (#1385) 2026-02-17 03:49:53 -05:00
opencode.sh refactor: introduce cloud adapter + spawn_agent runner system (#1340) 2026-02-16 16:25:44 -08:00
plandex.sh refactor: introduce cloud adapter + spawn_agent runner system (#1340) 2026-02-16 16:25:44 -08:00
README.md refactor: replace Python with jq in Hetzner lib, fix /lab → /labs URLs (#827) 2026-02-12 23:14:11 -08:00

Oracle Cloud Infrastructure

Oracle Cloud compute instances via OCI CLI. Oracle Cloud

Has a generous Always Free tier. Uses 'ubuntu' user for SSH. Requires OCI CLI installed and configured.

Prerequisites

  1. Install OCI CLI: pip install oci-cli
  2. Configure: oci setup config
  3. Set compartment: export OCI_COMPARTMENT_ID=ocid1.compartment.oc1.....

Agents

Claude Code

bash <(curl -fsSL https://openrouter.ai/labs/spawn/oracle/claude.sh)

Aider

bash <(curl -fsSL https://openrouter.ai/labs/spawn/oracle/aider.sh)

Goose

bash <(curl -fsSL https://openrouter.ai/labs/spawn/oracle/goose.sh)

Non-Interactive Mode

OCI_COMPARTMENT_ID=ocid1.compartment.oc1..... \
OCI_INSTANCE_NAME=dev-mk1 \
OPENROUTER_API_KEY=sk-or-v1-xxxxx \
  bash <(curl -fsSL https://openrouter.ai/labs/spawn/oracle/claude.sh)

Environment Variables

Variable Description Default
OCI_COMPARTMENT_ID OCI compartment OCID Auto-detected
OCI_INSTANCE_NAME Instance display name Prompted
OCI_SHAPE Compute shape VM.Standard.E2.1.Micro
OCI_SUBNET_ID Subnet OCID Auto-created
OCI_OCPUS OCPUs for flex shapes 1
OCI_MEMORY_GB Memory (GB) for flex shapes 4
OPENROUTER_API_KEY OpenRouter API key OAuth or prompted