⚠
High Risk:This skill has significant security concerns. Review the findings below before installing.

radio-copilot

⚠Caution·Scanned 2/17/2026

The skill predicts satellite passes and sends WhatsApp alerts using ~/.clawdbot/radio-copilot/config.json and the clawdbot CLI. It fetches TLEs from https://tle.ivanstanojevic.me/api/tle/${norad}, invokes ssh, and executes user-configured shell commands via subprocess.run(cmd, shell=True), exporting RADIO_RUN_DIR.

from clawhub.ai·v6057f6b·24.8 KB·0 installs
Scanned from 0.1.0 at 6057f6b · Transparency log ↗
$ vett add clawhub.ai/davestarling/radio-copilotReview security findings before installing

radio-copilot (Moltbot/Clawdbot add-on)

A zero-AI satellite pass planner + orchestrator that can:

  • predict upcoming satellite passes over a given lat/lon (NORAD + TLE)
  • notify you on WhatsApp with manual dish alignment info (AOS/LOS az+el, track direction, inclination)
  • (optional) trigger remote capture on a Raspberry Pi and remote decode on a Jetson (disabled by default)

This repo is the skeleton/orchestration layer. It’s designed to be safe and production-friendly: nothing transmits or captures unless you enable it.

Example alert

What you need

  • Node.js (for pass prediction)
  • Python 3 (for the orchestrator)
  • A Moltbot/Clawdbot instance configured for WhatsApp notifications

Optional (when you’re ready to automate captures):

  • Raspberry Pi with RTL-SDR dongle (USB)
  • Jetson (or any Linux host) to run SatDump decode jobs

Data flow

  1. Pass prediction
  • scripts/pass_predictor.mjs fetches a TLE for a satellite by NORAD ID and predicts passes above a minimum elevation.
  • Output includes:
    • start/max/end times
    • AOS/LOS azimuth/elevation (for manual pointing)
    • a simple compass track direction (AOS→LOS)
  1. Orchestrator
  • scripts/orchestrator.py reads config, calls the predictor, dedupes alerts, and sends a WhatsApp message before the pass.
  • It can also (optionally) run capture and decode hooks (disabled by default).
  1. State + run folders
  • State is persisted so you don’t get spammy repeats.
  • Run folders are created per pass under ~/.clawdbot/radio-copilot/runs/… (for future capture/decode artifacts).

Configuration

Copy the example config:

mkdir -p ~/.clawdbot/radio-copilot
cp config.example.json ~/.clawdbot/radio-copilot/config.json
chmod 600 ~/.clawdbot/radio-copilot/config.json

Edit ~/.clawdbot/radio-copilot/config.json:

  • observer.lat / observer.lon
  • satellites[] NORAD IDs (e.g. NOAA 19 = 33591)
  • schedule:
    • alertLeadMinutes
    • minRepeatMinutes (anti-spam backstop)

Install & run (system cron)

Run every 5 minutes:

*/5 * * * * /usr/bin/python3 /path/to/radio-copilot/scripts/orchestrator.py \
  >> ~/.clawdbot/radio-copilot/orchestrator.log 2>&1

License

MIT