业余无线电节点控制

技能简介

通过REST API连接并管理AllStar Link业余无线电节点，支持状态查询、节点连接/断开、收藏夹与定时网络会话管理。

能做什么

• 查询节点状态、在线节点列表与运行报告
• 连接或断开指定节点，支持仅监听模式
• 管理常用节点收藏夹，快速一键连接
• 创建带自动断开时间的网络会话配置
• 输出JSON或纯文本格式，便于脚本集成
• 查看操作审计日志与实时事件流

使用说明

前置条件：需独立部署asl-agent后端服务（通常运行于Raspberry Pi），并通过Tailscale等方式确保网络可达。

安装步骤：

1. 克隆技能仓库到本地
2. 在~/.config/secrets/api-keys.env中配置环境变量：
   ASL_PI_IP=Pi的IP地址（推荐Tailscale IP）
   ASL_API_KEY=从Pi的config.yaml获取的Bearer令牌
   ASL_API_BASE（可选）= 自定义基础URL
   ASL_STATE_DIR（可选）= 状态文件存储路径

基本用法：

source ~/.config/secrets/api-keys.env
python3 {baseDir}/scripts/asl-tool.py status --out text
python3 {baseDir}/scripts/asl-tool.py connect 55553 --out text
python3 {baseDir}/scripts/asl-tool.py favorites list
python3 {baseDir}/scripts/asl-tool.py net start ares --out text

所有命令支持--out json（默认，机器可读）或--out text（人类可读单行输出）。

定时任务配置：将以下cron条目添加到系统以启用自动断开检查：
* * * * * /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'

输入与输出

见下方输入与输出表格。

风险提示

• 部分节点因AllStar调度器配置可能在断开后自动重连，需先禁用调度器才能保持断开状态
• API密钥与节点信息需妥善保管，避免泄露导致未授权访问
• 依赖外部asl-agent服务，若Pi离线或网络不可达则所有命令失败
• 定时断开功能依赖cron正确配置，未配置时网络会话不会自动结束

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/kj5irq/asl-control/SKILL.md
来源类型：GitHub仓库