x402agent/SolanaOS / skills/gateway-node-ops
gateway-node-ops
VerifiedHow to spawn a SolanaOS Gateway and connect headless nodes
SolanaOS Gateway + Node Workflow
Prerequisites
Ensure the following tools are installed:
tmux—brew install tmuxtailscale— https://tailscale.com/downloadopenclaw—npm install -g openclawgo— https://go.dev/dl/
Build SolanaOS
// turbo
cd /Users/8bit/solanaos && go build -ldflags="-s -w" -o build/solanaos .
Spawn the Gateway (Quick)
Option A: Via SolanaOS CLI
// turbo
./build/solanaos node gateway-spawn
This will:
- Check for tmux, openclaw, and tailscale
- Detect your Tailscale IP
- Start
openclaw gatewayin a detached tmux session - Print connection info for remote nodes
Option B: Via Shell Script
// turbo
./scripts/gateway-spawn.sh
Same result, but works without building SolanaOS first.
Pair a Node
From the hardware device (Orin Nano, RPi, etc.), run:
./build/solanaos node pair --bridge <TAILSCALE_IP>:18790 --display-name "My Orin Nano"
Then approve from the gateway host:
openclaw nodes approve <requestId>
Run the Node
./build/solanaos node run --bridge <TAILSCALE_IP>:18790
Auto-Spawn at Daemon Launch
To make the daemon automatically spawn a gateway at startup:
GATEWAY_AUTO_SPAWN=true ./build/solanaos daemon
Or set in .env:
GATEWAY_AUTO_SPAWN=true
GATEWAY_SPAWN_PORT=18790
GATEWAY_USE_TAILSCALE=true
Manage the Gateway
// turbo
# Check status
./scripts/gateway-spawn.sh --status
# Kill the gateway
./build/solanaos node gateway-kill
# Or via script
./scripts/gateway-spawn.sh --kill
# Attach to see gateway logs
tmux attach -t solanaos-gw
Cross-Compile for Hardware
# Raspberry Pi (ARM64)
GOOS=linux GOARCH=arm64 go build -ldflags="-s -w" -o build/solanaos-linux-arm64 .
# NVIDIA Orin Nano (ARM64)
GOOS=linux GOARCH=arm64 go build -ldflags="-s -w" -o build/solanaos-orin .
Termius SSH Workflow
- Add your Tailscale host in Termius (use Tailscale IP)
- SSH in and run:
./build/solanaos node gateway-spawn - From a second Termius tab:
./build/solanaos node run --bridge <IP>:18790
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |