AGENT SKILL

asl-control

Monitor and control AllStar Link amateur radio nodes via REST API

License 许可
MIT
最近更新
2026-06-07
Stars
★ 0
Forks
1

01 前言 Front Matter

name
asl-control
metadata
{ "openclaw": { "emoji": "📡", "requires": { "env": [ "ASL_PI_IP", "ASL_API_KEY" ], "bins": [ "python3" ] } } }
description
Monitor and control AllStar Link amateur radio nodes via REST API

03 SKILL.md 正文

AllStar Link Node Control

Control and monitor your AllStar Link node through the ASL Agent REST API.


Prerequisites

This skill is a client. It talks to an ASL3 agent backend that must be running independently on a Raspberry Pi (or any host reachable over your network).

You need:

  • A Raspberry Pi running the asl-agent FastAPI service (see backend/ in this repo for the server code)
  • The Pi must be reachable from wherever OpenClaw runs -- Tailscale is the recommended way
  • The Pi's config.yaml (at /opt/asl-agent/config.yaml) contains your API key and node number

Environment variables (set in your secrets file, e.g. ~/.config/secrets/api-keys.env):

  • ASL_PI_IP -- IP address of the Pi (Tailscale IP preferred, works from anywhere)
  • ASL_API_KEY -- Bearer token from the Pi's config.yaml
  • ASL_API_BASE -- (optional) override the full base URL if you're not on port 8073. Format: http://host:port
  • ASL_STATE_DIR -- (optional) override where favorites/net state files are stored. Default: ~/.openclaw/state/asl-control/

Usage

All commands go through the Python client. Always source your secrets first:

source ~/.config/secrets/api-keys.env
python3 {baseDir}/scripts/asl-tool.py <command> [flags]

Every command supports --out json (default, machine-readable) or --out text (human-readable one-liner).

Quick reference

# Status & monitoring
python3 {baseDir}/scripts/asl-tool.py status --out text
python3 {baseDir}/scripts/asl-tool.py nodes --out text
python3 {baseDir}/scripts/asl-tool.py report --out text
python3 {baseDir}/scripts/asl-tool.py audit --lines 20

# Connect / disconnect
python3 {baseDir}/scripts/asl-tool.py connect 55553 --out text
python3 {baseDir}/scripts/asl-tool.py connect 55553 --monitor-only --out text
python3 {baseDir}/scripts/asl-tool.py disconnect 55553 --out text

# Favorites
python3 {baseDir}/scripts/asl-tool.py favorites list
python3 {baseDir}/scripts/asl-tool.py favorites set mynet 55553
python3 {baseDir}/scripts/asl-tool.py favorites remove mynet
python3 {baseDir}/scripts/asl-tool.py connect-fav mynet --out text

# Net profiles (timed sessions, auto-disconnect default)
python3 {baseDir}/scripts/asl-tool.py net list
python3 {baseDir}/scripts/asl-tool.py net set ares 55553 --duration-minutes 90
python3 {baseDir}/scripts/asl-tool.py net start ares --out text
python3 {baseDir}/scripts/asl-tool.py net status --out text
python3 {baseDir}/scripts/asl-tool.py net tick --out text
python3 {baseDir}/scripts/asl-tool.py net stop --out text
python3 {baseDir}/scripts/asl-tool.py net remove ares

# Watch (JSON-line event stream)
python3 {baseDir}/scripts/asl-tool.py watch --interval 5 --emit-initial

State files

Favorites and net session state live outside the repo, so they survive updates:

  • ~/.openclaw/state/asl-control/favorites.json
  • ~/.openclaw/state/asl-control/net-profiles.json
  • ~/.openclaw/state/asl-control/net-session.json

Net tick (cron)

Auto-disconnect only fires when net tick runs. Wire it to cron for enforcement:

* * * * * /bin/bash -c 'source ~/.config/secrets/api-keys.env && python3 /path/to/asl-tool.py net tick --out text >> ~/.openclaw/state/asl-control/tick.log 2>&1'

Natural language dispatch

When the user asks in natural language, translate to the Python client:

  • "Check my node" -> asl-tool.py report --out text
  • "What's connected?" -> asl-tool.py nodes --out text
  • "Connect to node 55553" -> asl-tool.py connect 55553 --out text
  • "Connect to node 55553 monitor only" -> asl-tool.py connect 55553 --monitor-only --out text
  • "Connect to <favorite name>" -> asl-tool.py connect-fav "<name>" --out text
  • "Disconnect from node 55553" -> asl-tool.py disconnect 55553 --out text
  • "List my favorites" -> asl-tool.py favorites list --out text
  • "Start net <name>" -> asl-tool.py net start <name> --out text
  • "Net status" -> asl-tool.py net status --out text
  • "Show audit log" -> asl-tool.py audit --lines 20 --out text

Notes

  • Tailscale IP is preferred over LAN IP for ASL_PI_IP (works from anywhere on the mesh)
  • Some nodes auto-reconnect after disconnect due to the AllStar scheduler on your node. That's an ASL config behavior, not an API bug. Disable the scheduler first if you need connections to stay dropped.
  • All commands are logged to the audit trail on the Pi at /opt/asl-agent/audit.log

04 同仓库更多 Skills

javimosch
javimosch/open-claw-skills

crowd-prompting

A marketplace where AI agents improve prompts, system instructions, tool descriptions, and other text-based content with domain expertise from real-world operations — and earn tokens for valuable contributions.

★ 0
javimosch
javimosch/open-claw-skills

ceaser

Interact with the Ceaser privacy protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- shield, unshield, note management, and protocol queries. All ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). Ceaser is a privacy-preserving ETH wrapper using Noir/UltraHonk zero-knowledge proofs on Base L2 (chain ID 8453).

★ 0
javimosch
javimosch/open-claw-skills

ceaser-send

Fully automated private ETH transfer via Ceaser Protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- all ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). WARNING -- creates observable on-chain links between user wallet and hot wallet (see Privacy Warning). Generates an ephemeral hot wallet with BIP-39 mnemonic recovery, user funds it, agent signs and broadcasts the Shield TX automatically. Exactly one manual step required (funding the hot wallet with ETH). Uses Noir/UltraHonk zero-knowledge proofs.

★ 0
javimosch
javimosch/open-claw-skills

dilemm-ai

Compete in DilemmAI, the prisoner's dilemma AI arena at dilemm.ai. Use when an OpenClaw agent wants to create an account, design and submit strategy prompts for their bot, enter matchmaking, analyze historical matches and leaderboards, and iterate on bot strategy. Requires headless browser automation (no API available yet).

★ 0
javimosch
javimosch/open-claw-skills

moldium

Post and manage content on the Moldium blog platform. Triggered by "post to Moldium", "write a blog post", "publish an article", etc.

★ 0
javimosch
javimosch/open-claw-skills

arxiv-paper-reviews

Interact with arXiv Crawler API to fetch papers, read reviews, submit comments, search papers, and import papers. Use when working with arXiv papers, fetching paper lists by date/category/interest, viewing paper details with comments, submitting paper reviews, searching papers by title, or importing papers from arXiv URLs via API at http://weakaccept.top:8000/.

★ 0