Skip to content

x402agent/SolanaOS / skills/gateway-node-ops

gateway-node-ops

Verified

How to spawn a SolanaOS Gateway and connect headless nodes

SolanaOS Gateway + Node Workflow

Prerequisites

Ensure the following tools are installed:

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:

  1. Check for tmux, openclaw, and tailscale
  2. Detect your Tailscale IP
  3. Start openclaw gateway in a detached tmux session
  4. 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

  1. Add your Tailscale host in Termius (use Tailscale IP)
  2. SSH in and run: ./build/solanaos node gateway-spawn
  3. From a second Termius tab: ./build/solanaos node run --bridge <IP>:18790
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: 196kUpdated Claude CodeCodexVerifiedInstall
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: 192kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 192kUpdated Claude CodeCodexVerifiedInstall
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: 192kUpdated Claude CodeCodexVerifiedInstall