{
  "schemaVersion": "1.0",
  "item": {
    "slug": "aria2-json-rpc",
    "name": "Aria2 Json Rpc",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/azzgo/aria2-json-rpc",
    "canonicalUrl": "https://clawhub.ai/azzgo/aria2-json-rpc",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/aria2-json-rpc",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=aria2-json-rpc",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "CONFIG.md",
      "IMPLEMENTATION_SUMMARY.md",
      "SKILL.md",
      "config.example.json",
      "references/aria2-methods.md",
      "references/execution-guide.md"
    ],
    "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/aria2-json-rpc"
    },
    "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/aria2-json-rpc",
    "agentPageUrl": "https://openagent3.xyz/skills/aria2-json-rpc/agent",
    "manifestUrl": "https://openagent3.xyz/skills/aria2-json-rpc/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/aria2-json-rpc/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": "What This Skill Does",
        "body": "This skill enables you to control aria2 download manager through natural language commands:\n\nDownload files (HTTP/HTTPS/FTP/Magnet/Torrent/Metalink)\nMonitor download progress and status\nControl downloads (pause, resume, remove)\nManage batch operations (pause all, resume all)\nView statistics and configure options"
      },
      {
        "title": "How to Use (For AI Agents)",
        "body": "⚠️ CRITICAL: DO NOT manually construct JSON-RPC requests.\n\n✅ ALWAYS use the Python scripts in the scripts/ directory.\n\n⚠️ IMPORTANT: Use python3 command, NOT python (especially on macOS where python symlink doesn't exist)"
      },
      {
        "title": "Workflow (MUST FOLLOW)",
        "body": "Step 1: Check Configuration Status\n\nBefore executing any aria2 commands, ALWAYS check if configuration is ready:\n\npython3 scripts/config_loader.py test\n\nIf successful: Proceed to execute user's command\nIf failed: Guide user to initialize configuration (see Step 2)\n\nStep 2: Initialize Configuration (if needed)\n\nIf connection test fails, guide user to set up configuration:\n\n# Recommended: User config (survives skill updates)\npython3 scripts/config_loader.py init --user\n\n# Alternative: Local config (project-specific)\npython3 scripts/config_loader.py init --local\n\nThen instruct user to edit the generated config file with their aria2 server details.\n\nStep 3: Execute User Commands\n\nOnce configuration is ready, execute the requested aria2 operations."
      },
      {
        "title": "Example Workflow",
        "body": "User: \"download http://example.com/file.zip\"\n\nYou execute:\n\n# 1. Check configuration\npython3 scripts/config_loader.py test\n\nIf test passes:\n\n# 2. Execute download command\npython3 scripts/rpc_client.py aria2.addUri '[\"http://example.com/file.zip\"]'\n\nYou respond: \"✓ Download started! GID: 2089b05ecca3d829\"\n\nIf test fails:\n\nConfiguration not ready. Please initialize:\n1. Run: python3 scripts/config_loader.py init --user\n2. Edit ~/.config/aria2-skill/config.json with your aria2 server details\n3. Run: python3 scripts/config_loader.py test (to verify)"
      },
      {
        "title": "Documentation Structure",
        "body": "For detailed execution instructions, see:\n\nreferences/execution-guide.md - Complete guide for AI agents with:\n\nCommand mapping table (user intent → script call)\nParameter formatting rules\nStep-by-step examples\nCommon mistakes to avoid\nResponse formatting guidelines\n\nFor aria2 method reference, see:\n\nreferences/aria2-methods.md - Detailed aria2 RPC method documentation"
      },
      {
        "title": "Common Commands Quick Reference",
        "body": "User IntentCommand ExampleDownload a filepython3 scripts/rpc_client.py aria2.addUri '[\"http://example.com/file.zip\"]'Check statuspython3 scripts/rpc_client.py aria2.tellStatus <GID>List active downloadspython3 scripts/rpc_client.py aria2.tellActiveList stopped downloadspython3 scripts/rpc_client.py aria2.tellStopped 0 100Pause downloadpython3 scripts/rpc_client.py aria2.pause <GID>Resume downloadpython3 scripts/rpc_client.py aria2.unpause <GID>Show statisticspython3 scripts/rpc_client.py aria2.getGlobalStatShow versionpython3 scripts/rpc_client.py aria2.getVersionPurge resultspython3 scripts/rpc_client.py aria2.purgeDownloadResult\n\nFor detailed usage and more commands, see execution-guide.md."
      },
      {
        "title": "Available Scripts",
        "body": "scripts/rpc_client.py - Main interface for RPC calls\nscripts/examples/list-downloads.py - Formatted download list\nscripts/examples/pause-all.py - Pause all downloads\nscripts/examples/add-torrent.py - Add torrent downloads\nscripts/examples/monitor-downloads.py - Real-time monitoring\nscripts/examples/set-options.py - Modify options"
      },
      {
        "title": "Configuration",
        "body": "Scripts automatically load configuration from multiple sources with the following priority (highest to lowest):"
      },
      {
        "title": "Configuration Priority",
        "body": "Environment Variables (highest priority - temporary override)\n\nARIA2_RPC_HOST, ARIA2_RPC_PORT, ARIA2_RPC_PATH, etc.\nBest for: CI/CD pipelines, temporary overrides, testing\nNote: For reference only. Agents should use config files instead.\n\n\n\nSkill Directory Config (project-specific configuration)\n\nLocation: skills/aria2-json-rpc/config.json\nBest for: Project-specific settings, local testing, development\n⚠️ Warning: Lost when running npx skills add to update the skill\n\n\n\nUser Config Directory (global fallback, update-safe) 🆕\n\nLocation: ~/.config/aria2-skill/config.json\nBest for: Personal default settings across all projects\n✅ Safe: Survives skill updates via npx skills add\n\n\n\nDefaults (localhost:6800)\n\nZero-configuration fallback for local development"
      },
      {
        "title": "Configuration Options",
        "body": "host: Hostname or IP address (default: localhost)\nport: Port number (default: 6800)\npath: URL path (default: null). Set to /jsonrpc for standard aria2, or custom path for reverse proxy\nsecret: RPC secret token (default: null)\nsecure: Use HTTPS instead of HTTP (default: false)\ntimeout: Request timeout in milliseconds (default: 30000)"
      },
      {
        "title": "Quick Setup (For AI Agents)",
        "body": "IMPORTANT: Always use Python scripts to manage configuration. Do NOT use shell commands directly.\n\nStep 1: Check current configuration status\n\npython3 scripts/config_loader.py show\n\nStep 2: Initialize configuration if needed\n\nUser config (recommended - survives updates):\n\npython3 scripts/config_loader.py init --user\n\nLocal config (project-specific):\n\npython3 scripts/config_loader.py init --local\n\nStep 3: Guide user to edit the config file\n\nAfter initialization, the tool will display the config file path. Instruct user to edit it with their aria2 server details (host, port, secret, etc.).\n\nStep 4: Verify configuration\n\npython3 scripts/config_loader.py test\n\nExample config file content:\n\n{\n  \"host\": \"localhost\",\n  \"port\": 6800,\n  \"secret\": \"your-secret-token\",\n  \"secure\": false,\n  \"timeout\": 30000\n}"
      },
      {
        "title": "Configuration Management (For AI Agents)",
        "body": "Available Python scripts for configuration management:\n\n# Check current configuration and source\npython3 scripts/config_loader.py show\n\n# Initialize user config (recommended - update-safe)\npython3 scripts/config_loader.py init --user\n\n# Initialize local config (project-specific)\npython3 scripts/config_loader.py init --local\n\n# Test connection to aria2 server\npython3 scripts/config_loader.py test\n\nAgent Workflow for Configuration Setup:\n\nCheck if config exists: Run python3 scripts/config_loader.py show\nIf config missing or invalid: Guide user to run python3 scripts/config_loader.py init --user\nUser edits config: Tell user the file path and required fields (host, port, secret)\nVerify setup: Run python3 scripts/config_loader.py test\nProceed with operations: Once test passes, execute user's aria2 commands"
      },
      {
        "title": "Advanced Configuration",
        "body": "Reverse Proxy Setup:\n\nFor reverse proxy setups like https://example.com:443/jsonrpc, the config file should contain:\n\n{\n  \"host\": \"example.com\",\n  \"port\": 443,\n  \"path\": \"/jsonrpc\",\n  \"secret\": \"your-secret-token\",\n  \"secure\": true\n}\n\nEnvironment Variables (for reference only):\n\nConfiguration can also be overridden via environment variables:\n\nARIA2_RPC_HOST: Hostname\nARIA2_RPC_PORT: Port number\nARIA2_RPC_PATH: URL path\nARIA2_RPC_SECRET: Secret token\nARIA2_RPC_SECURE: \"true\" or \"false\"\n\nNote: Use Python scripts for configuration management. Environment variables are documented here for reference only."
      },
      {
        "title": "Key Principles (For AI Agents)",
        "body": "Never construct JSON-RPC requests manually\nAlways call Python scripts via Bash tool using python3 (not python)\nAlways check configuration before executing commands:\n\nRun python3 scripts/config_loader.py test first\nIf test fails, guide user through initialization\n\n\nNever run raw shell commands (mkdir, cat, export, etc.) directly\n\nUse Python scripts: config_loader.py init, config_loader.py show, etc.\n\n\nParse script output and format for users\nRefer to execution-guide.md when unsure"
      },
      {
        "title": "Download Management",
        "body": "Add downloads (HTTP/FTP/Magnet/Torrent/Metalink)\nPause/resume (individual or all)\nRemove downloads\nAdd with custom options"
      },
      {
        "title": "Monitoring",
        "body": "Check download status\nList active/waiting/stopped downloads\nGet global statistics\nReal-time monitoring"
      },
      {
        "title": "Configuration",
        "body": "Get/change download options\nGet/change global options\nQuery aria2 version\nList available methods"
      },
      {
        "title": "Maintenance",
        "body": "Purge download results\nRemove specific results"
      },
      {
        "title": "Need Help?",
        "body": "Execution details: references/execution-guide.md\nMethod reference: references/aria2-methods.md\nTroubleshooting: references/troubleshooting.md\naria2 official docs: https://aria2.github.io/"
      }
    ],
    "body": "What This Skill Does\n\nThis skill enables you to control aria2 download manager through natural language commands:\n\nDownload files (HTTP/HTTPS/FTP/Magnet/Torrent/Metalink)\nMonitor download progress and status\nControl downloads (pause, resume, remove)\nManage batch operations (pause all, resume all)\nView statistics and configure options\nHow to Use (For AI Agents)\n\n⚠️ CRITICAL: DO NOT manually construct JSON-RPC requests.\n\n✅ ALWAYS use the Python scripts in the scripts/ directory.\n\n⚠️ IMPORTANT: Use python3 command, NOT python (especially on macOS where python symlink doesn't exist)\n\nWorkflow (MUST FOLLOW)\n\nStep 1: Check Configuration Status\n\nBefore executing any aria2 commands, ALWAYS check if configuration is ready:\n\npython3 scripts/config_loader.py test\n\nIf successful: Proceed to execute user's command\nIf failed: Guide user to initialize configuration (see Step 2)\n\nStep 2: Initialize Configuration (if needed)\n\nIf connection test fails, guide user to set up configuration:\n\n# Recommended: User config (survives skill updates)\npython3 scripts/config_loader.py init --user\n\n# Alternative: Local config (project-specific)\npython3 scripts/config_loader.py init --local\n\n\nThen instruct user to edit the generated config file with their aria2 server details.\n\nStep 3: Execute User Commands\n\nOnce configuration is ready, execute the requested aria2 operations.\n\nExample Workflow\n\nUser: \"download http://example.com/file.zip\"\n\nYou execute:\n\n# 1. Check configuration\npython3 scripts/config_loader.py test\n\n\nIf test passes:\n\n# 2. Execute download command\npython3 scripts/rpc_client.py aria2.addUri '[\"http://example.com/file.zip\"]'\n\n\nYou respond: \"✓ Download started! GID: 2089b05ecca3d829\"\n\nIf test fails:\n\nConfiguration not ready. Please initialize:\n1. Run: python3 scripts/config_loader.py init --user\n2. Edit ~/.config/aria2-skill/config.json with your aria2 server details\n3. Run: python3 scripts/config_loader.py test (to verify)\n\nDocumentation Structure\n\nFor detailed execution instructions, see:\n\nreferences/execution-guide.md - Complete guide for AI agents with:\nCommand mapping table (user intent → script call)\nParameter formatting rules\nStep-by-step examples\nCommon mistakes to avoid\nResponse formatting guidelines\n\nFor aria2 method reference, see:\n\nreferences/aria2-methods.md - Detailed aria2 RPC method documentation\nCommon Commands Quick Reference\nUser Intent\tCommand Example\nDownload a file\tpython3 scripts/rpc_client.py aria2.addUri '[\"http://example.com/file.zip\"]'\nCheck status\tpython3 scripts/rpc_client.py aria2.tellStatus <GID>\nList active downloads\tpython3 scripts/rpc_client.py aria2.tellActive\nList stopped downloads\tpython3 scripts/rpc_client.py aria2.tellStopped 0 100\nPause download\tpython3 scripts/rpc_client.py aria2.pause <GID>\nResume download\tpython3 scripts/rpc_client.py aria2.unpause <GID>\nShow statistics\tpython3 scripts/rpc_client.py aria2.getGlobalStat\nShow version\tpython3 scripts/rpc_client.py aria2.getVersion\nPurge results\tpython3 scripts/rpc_client.py aria2.purgeDownloadResult\n\nFor detailed usage and more commands, see execution-guide.md.\n\nAvailable Scripts\nscripts/rpc_client.py - Main interface for RPC calls\nscripts/examples/list-downloads.py - Formatted download list\nscripts/examples/pause-all.py - Pause all downloads\nscripts/examples/add-torrent.py - Add torrent downloads\nscripts/examples/monitor-downloads.py - Real-time monitoring\nscripts/examples/set-options.py - Modify options\nConfiguration\n\nScripts automatically load configuration from multiple sources with the following priority (highest to lowest):\n\nConfiguration Priority\n\nEnvironment Variables (highest priority - temporary override)\n\nARIA2_RPC_HOST, ARIA2_RPC_PORT, ARIA2_RPC_PATH, etc.\nBest for: CI/CD pipelines, temporary overrides, testing\nNote: For reference only. Agents should use config files instead.\n\nSkill Directory Config (project-specific configuration)\n\nLocation: skills/aria2-json-rpc/config.json\nBest for: Project-specific settings, local testing, development\n⚠️ Warning: Lost when running npx skills add to update the skill\n\nUser Config Directory (global fallback, update-safe) 🆕\n\nLocation: ~/.config/aria2-skill/config.json\nBest for: Personal default settings across all projects\n✅ Safe: Survives skill updates via npx skills add\n\nDefaults (localhost:6800)\n\nZero-configuration fallback for local development\nConfiguration Options\nhost: Hostname or IP address (default: localhost)\nport: Port number (default: 6800)\npath: URL path (default: null). Set to /jsonrpc for standard aria2, or custom path for reverse proxy\nsecret: RPC secret token (default: null)\nsecure: Use HTTPS instead of HTTP (default: false)\ntimeout: Request timeout in milliseconds (default: 30000)\nQuick Setup (For AI Agents)\n\nIMPORTANT: Always use Python scripts to manage configuration. Do NOT use shell commands directly.\n\nStep 1: Check current configuration status\n\npython3 scripts/config_loader.py show\n\n\nStep 2: Initialize configuration if needed\n\nUser config (recommended - survives updates):\n\npython3 scripts/config_loader.py init --user\n\n\nLocal config (project-specific):\n\npython3 scripts/config_loader.py init --local\n\n\nStep 3: Guide user to edit the config file\n\nAfter initialization, the tool will display the config file path. Instruct user to edit it with their aria2 server details (host, port, secret, etc.).\n\nStep 4: Verify configuration\n\npython3 scripts/config_loader.py test\n\n\nExample config file content:\n\n{\n  \"host\": \"localhost\",\n  \"port\": 6800,\n  \"secret\": \"your-secret-token\",\n  \"secure\": false,\n  \"timeout\": 30000\n}\n\nConfiguration Management (For AI Agents)\n\nAvailable Python scripts for configuration management:\n\n# Check current configuration and source\npython3 scripts/config_loader.py show\n\n# Initialize user config (recommended - update-safe)\npython3 scripts/config_loader.py init --user\n\n# Initialize local config (project-specific)\npython3 scripts/config_loader.py init --local\n\n# Test connection to aria2 server\npython3 scripts/config_loader.py test\n\n\nAgent Workflow for Configuration Setup:\n\nCheck if config exists: Run python3 scripts/config_loader.py show\nIf config missing or invalid: Guide user to run python3 scripts/config_loader.py init --user\nUser edits config: Tell user the file path and required fields (host, port, secret)\nVerify setup: Run python3 scripts/config_loader.py test\nProceed with operations: Once test passes, execute user's aria2 commands\nAdvanced Configuration\n\nReverse Proxy Setup:\n\nFor reverse proxy setups like https://example.com:443/jsonrpc, the config file should contain:\n\n{\n  \"host\": \"example.com\",\n  \"port\": 443,\n  \"path\": \"/jsonrpc\",\n  \"secret\": \"your-secret-token\",\n  \"secure\": true\n}\n\n\nEnvironment Variables (for reference only):\n\nConfiguration can also be overridden via environment variables:\n\nARIA2_RPC_HOST: Hostname\nARIA2_RPC_PORT: Port number\nARIA2_RPC_PATH: URL path\nARIA2_RPC_SECRET: Secret token\nARIA2_RPC_SECURE: \"true\" or \"false\"\n\nNote: Use Python scripts for configuration management. Environment variables are documented here for reference only.\n\nKey Principles (For AI Agents)\nNever construct JSON-RPC requests manually\nAlways call Python scripts via Bash tool using python3 (not python)\nAlways check configuration before executing commands:\nRun python3 scripts/config_loader.py test first\nIf test fails, guide user through initialization\nNever run raw shell commands (mkdir, cat, export, etc.) directly\nUse Python scripts: config_loader.py init, config_loader.py show, etc.\nParse script output and format for users\nRefer to execution-guide.md when unsure\nSupported Operations\nDownload Management\nAdd downloads (HTTP/FTP/Magnet/Torrent/Metalink)\nPause/resume (individual or all)\nRemove downloads\nAdd with custom options\nMonitoring\nCheck download status\nList active/waiting/stopped downloads\nGet global statistics\nReal-time monitoring\nConfiguration\nGet/change download options\nGet/change global options\nQuery aria2 version\nList available methods\nMaintenance\nPurge download results\nRemove specific results\nNeed Help?\nExecution details: references/execution-guide.md\nMethod reference: references/aria2-methods.md\nTroubleshooting: references/troubleshooting.md\naria2 official docs: https://aria2.github.io/"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/azzgo/aria2-json-rpc",
    "publisherUrl": "https://clawhub.ai/azzgo/aria2-json-rpc",
    "owner": "azzgo",
    "version": "0.1.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/aria2-json-rpc",
    "downloadUrl": "https://openagent3.xyz/downloads/aria2-json-rpc",
    "agentUrl": "https://openagent3.xyz/skills/aria2-json-rpc/agent",
    "manifestUrl": "https://openagent3.xyz/skills/aria2-json-rpc/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/aria2-json-rpc/agent.md"
  }
}