radio-copilot

What This Skill Does

radio-copilot is a specialized satellite tracking and orchestration agent designed for radio enthusiasts and SDR (Software Defined Radio) operators. It bridges the gap between raw TLE (Two-Line Element) data and actionable intelligence by calculating upcoming satellite passes for specific geographic locations. The skill provides precise telemetry data for NOAA APT, METEOR LRPT, and ISS passes, outputting essential alignment metrics like AOS (Acquisition of Signal) and LOS (Loss of Signal) azimuth and elevation, track direction, and orbital inclination. Beyond mere calculation, it acts as a zero-AI automated scheduler that integrates seamlessly with existing hardware setups, such as Raspberry Pi-based SDR capture rigs and NVIDIA Jetson decoding pipelines.

Installation

To integrate this skill, ensure you have the OpenClaw environment initialized. First, install the package using the command: clawhub install openclaw/skills/skills/davestarling/moltbot-satellite-copilot. Once installed, navigate to the configuration directory: mkdir -p ~/.clawdbot/radio-copilot. Copy the provided template using cp config.example.json ~/.clawdbot/radio-copilot/config.json. Crucially, set restricted permissions with chmod 600 ~/.clawdbot/radio-copilot/config.json to protect your location and API configurations. Finally, schedule the orchestrator using a system cron job to run every five minutes, ensuring continuous monitoring of satellite trajectories.

Use Cases

This skill is perfect for DIY weather satellite enthusiasts who want automated alerts before a pass occurs. It is ideal for users managing remote SDR stations who require hands-free notification via WhatsApp. Additionally, it serves as a powerful utility for educational settings or amateur radio clubs aiming to automate the collection of orbital imagery without constant manual monitoring of TLE updates or pass prediction websites.

Example Prompts

1. "radio-copilot, when is the next NOAA 19 pass above 20 degrees elevation for my current location?"
2. "radio-copilot, send me a summary of all scheduled ISS passes for the next 24 hours including AOS and LOS data."
3. "radio-copilot, configure the system to trigger a capture script for any METEOR M2 pass that exceeds a 45-degree maximum elevation."

Tips & Limitations

While the core prediction engine is extremely robust, remember that the accuracy of your tracking is highly dependent on the currency of your TLE files. Ensure your orchestrator environment has internet access to pull updated orbital data. The tool is designed to be a 'zero-AI' scheduler for stability; do not rely on LLM inference for the core telemetry calculations. For best results, use a high-gain directional antenna, and ensure that the hooks for your Jetson/Pi devices are verified via a dry run before relying on them for critical capture tasks.