{
  "schemaVersion": "1.0",
  "item": {
    "slug": "portainer",
    "name": "Portainer",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/asteinberger/portainer",
    "canonicalUrl": "https://clawhub.ai/asteinberger/portainer",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/portainer",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=portainer",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "portainer.sh"
    ],
    "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-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.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/portainer"
    },
    "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/portainer",
    "agentPageUrl": "https://openagent3.xyz/skills/portainer/agent",
    "manifestUrl": "https://openagent3.xyz/skills/portainer/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/portainer/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": "🐳 Portainer Skill",
        "body": "╔═══════════════════════════════════════════════════════════╗\n    ║                                                           ║\n    ║   🐳  P O R T A I N E R   C O N T R O L   C L I  🐳      ║\n    ║                                                           ║\n    ║       Manage Docker containers via Portainer API          ║\n    ║            Start, stop, deploy, redeploy                  ║\n    ║                                                           ║\n    ╚═══════════════════════════════════════════════════════════╝\n\n\"Docker containers? I'll handle them from my lily pad.\" 🐸"
      },
      {
        "title": "📖 What Does This Skill Do?",
        "body": "The Portainer Skill gives you control over your Docker infrastructure through Portainer's REST API. Manage containers, stacks, and deployments without touching the web UI.\n\nFeatures:\n\n📊 Status — Check Portainer server status\n🖥️ Endpoints — List all Docker environments\n📦 Containers — List, start, stop, restart containers\n📚 Stacks — List and manage Docker Compose stacks\n🔄 Redeploy — Pull from git and redeploy stacks\n📜 Logs — View container logs"
      },
      {
        "title": "⚙️ Requirements",
        "body": "WhatDetailsPortainerVersion 2.x with API accessToolscurl, jqAuthAPI Access Token"
      },
      {
        "title": "Setup",
        "body": "Get API Token from Portainer:\n\nLog into Portainer web UI\nClick username → My Account\nScroll to \"Access tokens\" → Add access token\nCopy the token (you won't see it again!)\n\n\n\nConfigure credentials:\n# Add to ~/.clawdbot/.env\nPORTAINER_URL=https://your-portainer-server:9443\nPORTAINER_API_KEY=ptr_your_token_here\n\n\n\nReady! 🚀"
      },
      {
        "title": "status — Check Portainer Server",
        "body": "./portainer.sh status\n\nOutput:\n\nPortainer v2.27.3"
      },
      {
        "title": "endpoints — List Environments",
        "body": "./portainer.sh endpoints\n\nOutput:\n\n3: portainer (local) - ✓ online\n4: production (remote) - ✓ online"
      },
      {
        "title": "containers — List Containers",
        "body": "# List containers on default endpoint (4)\n./portainer.sh containers\n\n# List containers on specific endpoint\n./portainer.sh containers 3\n\nOutput:\n\nsteinbergerraum-web-1    running    Up 2 days\ncora-web-1               running    Up 6 weeks\nminecraft                running    Up 6 weeks (healthy)"
      },
      {
        "title": "stacks — List All Stacks",
        "body": "./portainer.sh stacks\n\nOutput:\n\n25: steinbergerraum - ✓ active\n33: cora - ✓ active\n35: minecraft - ✓ active\n4: pulse-website - ✗ inactive"
      },
      {
        "title": "stack-info — Stack Details",
        "body": "./portainer.sh stack-info 25\n\nOutput:\n\n{\n  \"Id\": 25,\n  \"Name\": \"steinbergerraum\",\n  \"Status\": 1,\n  \"EndpointId\": 4,\n  \"GitConfig\": \"https://github.com/user/repo\",\n  \"UpdateDate\": \"2026-01-25T08:44:56Z\"\n}"
      },
      {
        "title": "redeploy — Pull & Redeploy Stack 🔄",
        "body": "./portainer.sh redeploy 25\n\nOutput:\n\n✓ Stack 'steinbergerraum' redeployed successfully\n\nThis will:\n\nPull latest code from git\nRebuild containers if needed\nRestart the stack"
      },
      {
        "title": "start / stop / restart — Container Control",
        "body": "# Start a container\n./portainer.sh start steinbergerraum-web-1\n\n# Stop a container\n./portainer.sh stop steinbergerraum-web-1\n\n# Restart a container\n./portainer.sh restart steinbergerraum-web-1\n\n# Specify endpoint (default: 4)\n./portainer.sh restart steinbergerraum-web-1 4\n\nOutput:\n\n✓ Container 'steinbergerraum-web-1' restarted"
      },
      {
        "title": "logs — View Container Logs",
        "body": "# Last 100 lines (default)\n./portainer.sh logs steinbergerraum-web-1\n\n# Last 50 lines\n./portainer.sh logs steinbergerraum-web-1 4 50"
      },
      {
        "title": "🚀 \"Deploy Website Update\"",
        "body": "# After merging PR\n./portainer.sh redeploy 25\n./portainer.sh logs steinbergerraum-web-1 4 20"
      },
      {
        "title": "🔧 \"Debug Container\"",
        "body": "./portainer.sh containers\n./portainer.sh logs cora-web-1\n./portainer.sh restart cora-web-1"
      },
      {
        "title": "📊 \"System Overview\"",
        "body": "./portainer.sh status\n./portainer.sh endpoints\n./portainer.sh containers\n./portainer.sh stacks"
      },
      {
        "title": "❌ \"Authentication required / Repository not found\"",
        "body": "Problem: Stack redeploy fails with git auth error\n\nSolution: The stack needs repositoryGitCredentialID parameter. The script handles this automatically by reading from the existing stack config."
      },
      {
        "title": "❌ \"Container not found\"",
        "body": "Problem: Container name doesn't match\n\nSolution: Use exact name from ./portainer.sh containers:\n\nInclude the full name: steinbergerraum-web-1 not steinbergerraum\nNames are case-sensitive"
      },
      {
        "title": "❌ \"PORTAINER_URL and PORTAINER_API_KEY must be set\"",
        "body": "Problem: Credentials not configured\n\nSolution:\n\n# Add to ~/.clawdbot/.env\necho \"PORTAINER_URL=https://your-server:9443\" >> ~/.clawdbot/.env\necho \"PORTAINER_API_KEY=ptr_your_token\" >> ~/.clawdbot/.env"
      },
      {
        "title": "🔗 Integration with Clawd",
        "body": "\"Redeploy the website\"\n→ ./portainer.sh redeploy 25\n\n\"Show me running containers\"\n→ ./portainer.sh containers\n\n\"Restart the Minecraft server\"\n→ ./portainer.sh restart minecraft\n\n\"What stacks do we have?\"\n→ ./portainer.sh stacks"
      },
      {
        "title": "📜 Changelog",
        "body": "VersionDateChanges1.0.02026-01-25Initial release"
      },
      {
        "title": "🐸 Credits",
        "body": "@..@\n (----)\n( >__< )   \"Containers are just fancy lily pads\n ^^  ^^     for your code to hop around!\"\n\nAuthor: Andy Steinberger (with help from his Clawdbot Owen the Frog 🐸)\nPowered by: Portainer API\nPart of: Clawdbot Skills Collection\n\nMade with 💚 for the Clawdbot Community\n\nRibbit! 🐸"
      }
    ],
    "body": "🐳 Portainer Skill\n    ╔═══════════════════════════════════════════════════════════╗\n    ║                                                           ║\n    ║   🐳  P O R T A I N E R   C O N T R O L   C L I  🐳      ║\n    ║                                                           ║\n    ║       Manage Docker containers via Portainer API          ║\n    ║            Start, stop, deploy, redeploy                  ║\n    ║                                                           ║\n    ╚═══════════════════════════════════════════════════════════╝\n\n\n\"Docker containers? I'll handle them from my lily pad.\" 🐸\n\n📖 What Does This Skill Do?\n\nThe Portainer Skill gives you control over your Docker infrastructure through Portainer's REST API. Manage containers, stacks, and deployments without touching the web UI.\n\nFeatures:\n\n📊 Status — Check Portainer server status\n🖥️ Endpoints — List all Docker environments\n📦 Containers — List, start, stop, restart containers\n📚 Stacks — List and manage Docker Compose stacks\n🔄 Redeploy — Pull from git and redeploy stacks\n📜 Logs — View container logs\n⚙️ Requirements\nWhat\tDetails\nPortainer\tVersion 2.x with API access\nTools\tcurl, jq\nAuth\tAPI Access Token\nSetup\n\nGet API Token from Portainer:\n\nLog into Portainer web UI\nClick username → My Account\nScroll to \"Access tokens\" → Add access token\nCopy the token (you won't see it again!)\n\nConfigure credentials:\n\n# Add to ~/.clawdbot/.env\nPORTAINER_URL=https://your-portainer-server:9443\nPORTAINER_API_KEY=ptr_your_token_here\n\n\nReady! 🚀\n\n🛠️ Commands\nstatus — Check Portainer Server\n./portainer.sh status\n\n\nOutput:\n\nPortainer v2.27.3\n\nendpoints — List Environments\n./portainer.sh endpoints\n\n\nOutput:\n\n3: portainer (local) - ✓ online\n4: production (remote) - ✓ online\n\ncontainers — List Containers\n# List containers on default endpoint (4)\n./portainer.sh containers\n\n# List containers on specific endpoint\n./portainer.sh containers 3\n\n\nOutput:\n\nsteinbergerraum-web-1    running    Up 2 days\ncora-web-1               running    Up 6 weeks\nminecraft                running    Up 6 weeks (healthy)\n\nstacks — List All Stacks\n./portainer.sh stacks\n\n\nOutput:\n\n25: steinbergerraum - ✓ active\n33: cora - ✓ active\n35: minecraft - ✓ active\n4: pulse-website - ✗ inactive\n\nstack-info — Stack Details\n./portainer.sh stack-info 25\n\n\nOutput:\n\n{\n  \"Id\": 25,\n  \"Name\": \"steinbergerraum\",\n  \"Status\": 1,\n  \"EndpointId\": 4,\n  \"GitConfig\": \"https://github.com/user/repo\",\n  \"UpdateDate\": \"2026-01-25T08:44:56Z\"\n}\n\nredeploy — Pull & Redeploy Stack 🔄\n./portainer.sh redeploy 25\n\n\nOutput:\n\n✓ Stack 'steinbergerraum' redeployed successfully\n\n\nThis will:\n\nPull latest code from git\nRebuild containers if needed\nRestart the stack\nstart / stop / restart — Container Control\n# Start a container\n./portainer.sh start steinbergerraum-web-1\n\n# Stop a container\n./portainer.sh stop steinbergerraum-web-1\n\n# Restart a container\n./portainer.sh restart steinbergerraum-web-1\n\n# Specify endpoint (default: 4)\n./portainer.sh restart steinbergerraum-web-1 4\n\n\nOutput:\n\n✓ Container 'steinbergerraum-web-1' restarted\n\nlogs — View Container Logs\n# Last 100 lines (default)\n./portainer.sh logs steinbergerraum-web-1\n\n# Last 50 lines\n./portainer.sh logs steinbergerraum-web-1 4 50\n\n🎯 Example Workflows\n🚀 \"Deploy Website Update\"\n# After merging PR\n./portainer.sh redeploy 25\n./portainer.sh logs steinbergerraum-web-1 4 20\n\n🔧 \"Debug Container\"\n./portainer.sh containers\n./portainer.sh logs cora-web-1\n./portainer.sh restart cora-web-1\n\n📊 \"System Overview\"\n./portainer.sh status\n./portainer.sh endpoints\n./portainer.sh containers\n./portainer.sh stacks\n\n🔧 Troubleshooting\n❌ \"Authentication required / Repository not found\"\n\nProblem: Stack redeploy fails with git auth error\n\nSolution: The stack needs repositoryGitCredentialID parameter. The script handles this automatically by reading from the existing stack config.\n\n❌ \"Container not found\"\n\nProblem: Container name doesn't match\n\nSolution: Use exact name from ./portainer.sh containers:\n\nInclude the full name: steinbergerraum-web-1 not steinbergerraum\nNames are case-sensitive\n❌ \"PORTAINER_URL and PORTAINER_API_KEY must be set\"\n\nProblem: Credentials not configured\n\nSolution:\n\n# Add to ~/.clawdbot/.env\necho \"PORTAINER_URL=https://your-server:9443\" >> ~/.clawdbot/.env\necho \"PORTAINER_API_KEY=ptr_your_token\" >> ~/.clawdbot/.env\n\n🔗 Integration with Clawd\n\"Redeploy the website\"\n→ ./portainer.sh redeploy 25\n\n\"Show me running containers\"\n→ ./portainer.sh containers\n\n\"Restart the Minecraft server\"\n→ ./portainer.sh restart minecraft\n\n\"What stacks do we have?\"\n→ ./portainer.sh stacks\n\n📜 Changelog\nVersion\tDate\tChanges\n1.0.0\t2026-01-25\tInitial release\n🐸 Credits\n  @..@\n (----)\n( >__< )   \"Containers are just fancy lily pads\n ^^  ^^     for your code to hop around!\"\n\n\nAuthor: Andy Steinberger (with help from his Clawdbot Owen the Frog 🐸)\nPowered by: Portainer API\nPart of: Clawdbot Skills Collection\n\n<div align=\"center\">\n\nMade with 💚 for the Clawdbot Community\n\nRibbit! 🐸\n\n</div>"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/asteinberger/portainer",
    "publisherUrl": "https://clawhub.ai/asteinberger/portainer",
    "owner": "asteinberger",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/portainer",
    "downloadUrl": "https://openagent3.xyz/downloads/portainer",
    "agentUrl": "https://openagent3.xyz/skills/portainer/agent",
    "manifestUrl": "https://openagent3.xyz/skills/portainer/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/portainer/agent.md"
  }
}