{
  "schemaVersion": "1.0",
  "item": {
    "slug": "asl-control",
    "name": "Allstar Link node control ASL3 (ASL3 Node Control)",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/KJ5IRQ/asl-control",
    "canonicalUrl": "https://clawhub.ai/KJ5IRQ/asl-control",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/asl-control",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=asl-control",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "asl-node-aliases.json",
      "scripts/asl-api.sh",
      "scripts/asl-tool.py"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/asl-control"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/asl-control",
    "agentPageUrl": "https://openagent3.xyz/skills/asl-control/agent",
    "manifestUrl": "https://openagent3.xyz/skills/asl-control/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/asl-control/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "AllStar Link Node Control",
        "body": "Control and monitor your AllStar Link node through the ASL Agent REST API."
      },
      {
        "title": "Prerequisites",
        "body": "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).\n\nYou need:\n\nA Raspberry Pi running the asl-agent FastAPI service (see backend/ in this repo for the server code)\nThe Pi must be reachable from wherever OpenClaw runs -- Tailscale is the recommended way\nThe Pi's config.yaml (at /opt/asl-agent/config.yaml) contains your API key and node number\n\nEnvironment variables (set in your secrets file, e.g. ~/.config/secrets/api-keys.env):\n\nASL_PI_IP -- IP address of the Pi (Tailscale IP preferred, works from anywhere)\nASL_API_KEY -- Bearer token from the Pi's config.yaml\nASL_API_BASE -- (optional) override the full base URL if you're not on port 8073. Format: http://host:port\nASL_STATE_DIR -- (optional) override where favorites/net state files are stored. Default: ~/.openclaw/state/asl-control/"
      },
      {
        "title": "Usage",
        "body": "All commands go through the Python client. Always source your secrets first:\n\nsource ~/.config/secrets/api-keys.env\npython3 {baseDir}/scripts/asl-tool.py <command> [flags]\n\nEvery command supports --out json (default, machine-readable) or --out text (human-readable one-liner)."
      },
      {
        "title": "Quick reference",
        "body": "# Status & monitoring\npython3 {baseDir}/scripts/asl-tool.py status --out text\npython3 {baseDir}/scripts/asl-tool.py nodes --out text\npython3 {baseDir}/scripts/asl-tool.py report --out text\npython3 {baseDir}/scripts/asl-tool.py audit --lines 20\n\n# Connect / disconnect\npython3 {baseDir}/scripts/asl-tool.py connect 55553 --out text\npython3 {baseDir}/scripts/asl-tool.py connect 55553 --monitor-only --out text\npython3 {baseDir}/scripts/asl-tool.py disconnect 55553 --out text\n\n# Favorites\npython3 {baseDir}/scripts/asl-tool.py favorites list\npython3 {baseDir}/scripts/asl-tool.py favorites set mynet 55553\npython3 {baseDir}/scripts/asl-tool.py favorites remove mynet\npython3 {baseDir}/scripts/asl-tool.py connect-fav mynet --out text\n\n# Net profiles (timed sessions, auto-disconnect default)\npython3 {baseDir}/scripts/asl-tool.py net list\npython3 {baseDir}/scripts/asl-tool.py net set ares 55553 --duration-minutes 90\npython3 {baseDir}/scripts/asl-tool.py net start ares --out text\npython3 {baseDir}/scripts/asl-tool.py net status --out text\npython3 {baseDir}/scripts/asl-tool.py net tick --out text\npython3 {baseDir}/scripts/asl-tool.py net stop --out text\npython3 {baseDir}/scripts/asl-tool.py net remove ares\n\n# Watch (JSON-line event stream)\npython3 {baseDir}/scripts/asl-tool.py watch --interval 5 --emit-initial"
      },
      {
        "title": "State files",
        "body": "Favorites and net session state live outside the repo, so they survive updates:\n\n~/.openclaw/state/asl-control/favorites.json\n~/.openclaw/state/asl-control/net-profiles.json\n~/.openclaw/state/asl-control/net-session.json"
      },
      {
        "title": "Net tick (cron)",
        "body": "Auto-disconnect only fires when net tick runs. Wire it to cron for enforcement:\n\n* * * * * /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'"
      },
      {
        "title": "Natural language dispatch",
        "body": "When the user asks in natural language, translate to the Python client:\n\n\"Check my node\" -> asl-tool.py report --out text\n\"What's connected?\" -> asl-tool.py nodes --out text\n\"Connect to node 55553\" -> asl-tool.py connect 55553 --out text\n\"Connect to node 55553 monitor only\" -> asl-tool.py connect 55553 --monitor-only --out text\n\"Connect to <favorite name>\" -> asl-tool.py connect-fav \"<name>\" --out text\n\"Disconnect from node 55553\" -> asl-tool.py disconnect 55553 --out text\n\"List my favorites\" -> asl-tool.py favorites list --out text\n\"Start net <name>\" -> asl-tool.py net start <name> --out text\n\"Net status\" -> asl-tool.py net status --out text\n\"Show audit log\" -> asl-tool.py audit --lines 20 --out text"
      },
      {
        "title": "Notes",
        "body": "Tailscale IP is preferred over LAN IP for ASL_PI_IP (works from anywhere on the mesh)\nSome 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.\nAll commands are logged to the audit trail on the Pi at /opt/asl-agent/audit.log"
      }
    ],
    "body": "AllStar Link Node Control\n\nControl and monitor your AllStar Link node through the ASL Agent REST API.\n\nPrerequisites\n\nThis 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).\n\nYou need:\n\nA Raspberry Pi running the asl-agent FastAPI service (see backend/ in this repo for the server code)\nThe Pi must be reachable from wherever OpenClaw runs -- Tailscale is the recommended way\nThe Pi's config.yaml (at /opt/asl-agent/config.yaml) contains your API key and node number\n\nEnvironment variables (set in your secrets file, e.g. ~/.config/secrets/api-keys.env):\n\nASL_PI_IP -- IP address of the Pi (Tailscale IP preferred, works from anywhere)\nASL_API_KEY -- Bearer token from the Pi's config.yaml\nASL_API_BASE -- (optional) override the full base URL if you're not on port 8073. Format: http://host:port\nASL_STATE_DIR -- (optional) override where favorites/net state files are stored. Default: ~/.openclaw/state/asl-control/\nUsage\n\nAll commands go through the Python client. Always source your secrets first:\n\nsource ~/.config/secrets/api-keys.env\npython3 {baseDir}/scripts/asl-tool.py <command> [flags]\n\n\nEvery command supports --out json (default, machine-readable) or --out text (human-readable one-liner).\n\nQuick reference\n# Status & monitoring\npython3 {baseDir}/scripts/asl-tool.py status --out text\npython3 {baseDir}/scripts/asl-tool.py nodes --out text\npython3 {baseDir}/scripts/asl-tool.py report --out text\npython3 {baseDir}/scripts/asl-tool.py audit --lines 20\n\n# Connect / disconnect\npython3 {baseDir}/scripts/asl-tool.py connect 55553 --out text\npython3 {baseDir}/scripts/asl-tool.py connect 55553 --monitor-only --out text\npython3 {baseDir}/scripts/asl-tool.py disconnect 55553 --out text\n\n# Favorites\npython3 {baseDir}/scripts/asl-tool.py favorites list\npython3 {baseDir}/scripts/asl-tool.py favorites set mynet 55553\npython3 {baseDir}/scripts/asl-tool.py favorites remove mynet\npython3 {baseDir}/scripts/asl-tool.py connect-fav mynet --out text\n\n# Net profiles (timed sessions, auto-disconnect default)\npython3 {baseDir}/scripts/asl-tool.py net list\npython3 {baseDir}/scripts/asl-tool.py net set ares 55553 --duration-minutes 90\npython3 {baseDir}/scripts/asl-tool.py net start ares --out text\npython3 {baseDir}/scripts/asl-tool.py net status --out text\npython3 {baseDir}/scripts/asl-tool.py net tick --out text\npython3 {baseDir}/scripts/asl-tool.py net stop --out text\npython3 {baseDir}/scripts/asl-tool.py net remove ares\n\n# Watch (JSON-line event stream)\npython3 {baseDir}/scripts/asl-tool.py watch --interval 5 --emit-initial\n\nState files\n\nFavorites and net session state live outside the repo, so they survive updates:\n\n~/.openclaw/state/asl-control/favorites.json\n~/.openclaw/state/asl-control/net-profiles.json\n~/.openclaw/state/asl-control/net-session.json\nNet tick (cron)\n\nAuto-disconnect only fires when net tick runs. Wire it to cron for enforcement:\n\n* * * * * /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'\n\nNatural language dispatch\n\nWhen the user asks in natural language, translate to the Python client:\n\n\"Check my node\" -> asl-tool.py report --out text\n\"What's connected?\" -> asl-tool.py nodes --out text\n\"Connect to node 55553\" -> asl-tool.py connect 55553 --out text\n\"Connect to node 55553 monitor only\" -> asl-tool.py connect 55553 --monitor-only --out text\n\"Connect to <favorite name>\" -> asl-tool.py connect-fav \"<name>\" --out text\n\"Disconnect from node 55553\" -> asl-tool.py disconnect 55553 --out text\n\"List my favorites\" -> asl-tool.py favorites list --out text\n\"Start net <name>\" -> asl-tool.py net start <name> --out text\n\"Net status\" -> asl-tool.py net status --out text\n\"Show audit log\" -> asl-tool.py audit --lines 20 --out text\nNotes\nTailscale IP is preferred over LAN IP for ASL_PI_IP (works from anywhere on the mesh)\nSome 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.\nAll commands are logged to the audit trail on the Pi at /opt/asl-agent/audit.log"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/KJ5IRQ/asl-control",
    "publisherUrl": "https://clawhub.ai/KJ5IRQ/asl-control",
    "owner": "KJ5IRQ",
    "version": "0.1.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/asl-control",
    "downloadUrl": "https://openagent3.xyz/downloads/asl-control",
    "agentUrl": "https://openagent3.xyz/skills/asl-control/agent",
    "manifestUrl": "https://openagent3.xyz/skills/asl-control/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/asl-control/agent.md"
  }
}