{
  "schemaVersion": "1.0",
  "item": {
    "slug": "gotify",
    "name": "Gotify",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/jmagar/gotify",
    "canonicalUrl": "https://clawhub.ai/jmagar/gotify",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/gotify",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=gotify",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "scripts/send.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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "slug": "gotify",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T04:41:02.087Z",
      "expiresAt": "2026-05-07T04:41:02.087Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=gotify",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=gotify",
        "contentDisposition": "attachment; filename=\"gotify-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "gotify"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/gotify"
    },
    "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/gotify",
    "agentPageUrl": "https://openagent3.xyz/skills/gotify/agent",
    "manifestUrl": "https://openagent3.xyz/skills/gotify/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/gotify/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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Gotify Notification Skill",
        "body": "Send push notifications to your Gotify server when long-running tasks complete or important events occur."
      },
      {
        "title": "Purpose",
        "body": "This skill enables Clawdbot to send push notifications via Gotify, useful for:\n\nAlerting when long-running tasks complete\nSending status updates for background operations\nNotifying of important events or errors\nIntegration with task completion hooks"
      },
      {
        "title": "Setup",
        "body": "Create the credentials file: ~/.clawdbot/credentials/gotify/config.json\n\n{\n  \"url\": \"https://gotify.example.com\",\n  \"token\": \"YOUR_APP_TOKEN\"\n}\n\nurl: Your Gotify server URL (no trailing slash)\ntoken: Application token from Gotify (Settings → Apps → Create Application)"
      },
      {
        "title": "Basic Notification",
        "body": "bash scripts/send.sh \"Task completed successfully\""
      },
      {
        "title": "With Title",
        "body": "bash scripts/send.sh --title \"Build Complete\" --message \"skill-sync tests passed\""
      },
      {
        "title": "With Priority (0-10)",
        "body": "bash scripts/send.sh -t \"Critical Alert\" -m \"Service down\" -p 10"
      },
      {
        "title": "Markdown Support",
        "body": "bash scripts/send.sh --title \"Deploy Summary\" --markdown --message \"\n## Deployment Complete\n\n- **Status**: ✅ Success\n- **Duration**: 2m 34s\n- **Commits**: 5 new\n\""
      },
      {
        "title": "Option 1: Direct Call After Task",
        "body": "# Run long task\n./deploy.sh && bash ~/clawd/skills/gotify/scripts/send.sh \"Deploy finished\""
      },
      {
        "title": "Option 2: Hook Integration (Future)",
        "body": "When Clawdbot supports task completion hooks, this skill can be triggered automatically:\n\n# Example hook configuration (conceptual)\n{\n  \"on\": \"task_complete\",\n  \"run\": \"bash ~/clawd/skills/gotify/scripts/send.sh 'Task: {{task_name}} completed in {{duration}}'\"\n}"
      },
      {
        "title": "Parameters",
        "body": "-m, --message <text>: Notification message (required)\n-t, --title <text>: Notification title (optional)\n-p, --priority <0-10>: Priority level (default: 5)\n\n0-3: Low priority\n4-7: Normal priority\n8-10: High priority (may trigger sound/vibration)\n\n\n--markdown: Enable markdown formatting in message"
      },
      {
        "title": "Notify when subagent finishes",
        "body": "# After spawning subagent\nsessions_spawn --task \"Research topic\" --label my-research\n# ... wait for completion ...\nbash scripts/send.sh -t \"Research Complete\" -m \"Check session: my-research\""
      },
      {
        "title": "Notify on error with high priority",
        "body": "if ! ./critical-task.sh; then\n  bash scripts/send.sh -t \"⚠️ Critical Failure\" -m \"Task failed, check logs\" -p 10\nfi"
      },
      {
        "title": "Rich markdown notification",
        "body": "bash scripts/send.sh --markdown -t \"Daily Summary\" -m \"\n# System Status\n\n## ✅ Healthy\n- UniFi: 34 clients\n- Sonarr: 1,175 shows\n- Radarr: 2,551 movies\n\n## 📊 Stats\n- Uptime: 621h\n- Network: All OK\n\""
      },
      {
        "title": "Workflow",
        "body": "When the user says:\n\n\"Notify me when this finishes\" → Add && bash scripts/send.sh \"Task complete\" to their command\n\"Send a Gotify alert\" → Run bash scripts/send.sh with their message\n\"Push notification for task completion\" → Integrate into their workflow with appropriate title/priority\n\nAlways confirm the notification was sent successfully (check for JSON response with message ID)."
      },
      {
        "title": "Notes",
        "body": "Requires network access to your Gotify server\nApp token must have \"create message\" permission\nPriority levels affect notification behavior on client devices\nMarkdown support depends on Gotify client version (most modern clients support it)"
      },
      {
        "title": "Reference",
        "body": "Gotify API docs: https://gotify.net/docs/\nGotify Android/iOS apps for receiving notifications"
      }
    ],
    "body": "Gotify Notification Skill\n\nSend push notifications to your Gotify server when long-running tasks complete or important events occur.\n\nPurpose\n\nThis skill enables Clawdbot to send push notifications via Gotify, useful for:\n\nAlerting when long-running tasks complete\nSending status updates for background operations\nNotifying of important events or errors\nIntegration with task completion hooks\nSetup\n\nCreate the credentials file: ~/.clawdbot/credentials/gotify/config.json\n\n{\n  \"url\": \"https://gotify.example.com\",\n  \"token\": \"YOUR_APP_TOKEN\"\n}\n\nurl: Your Gotify server URL (no trailing slash)\ntoken: Application token from Gotify (Settings → Apps → Create Application)\nUsage\nBasic Notification\nbash scripts/send.sh \"Task completed successfully\"\n\nWith Title\nbash scripts/send.sh --title \"Build Complete\" --message \"skill-sync tests passed\"\n\nWith Priority (0-10)\nbash scripts/send.sh -t \"Critical Alert\" -m \"Service down\" -p 10\n\nMarkdown Support\nbash scripts/send.sh --title \"Deploy Summary\" --markdown --message \"\n## Deployment Complete\n\n- **Status**: ✅ Success\n- **Duration**: 2m 34s\n- **Commits**: 5 new\n\"\n\nIntegration with Task Completion\nOption 1: Direct Call After Task\n# Run long task\n./deploy.sh && bash ~/clawd/skills/gotify/scripts/send.sh \"Deploy finished\"\n\nOption 2: Hook Integration (Future)\n\nWhen Clawdbot supports task completion hooks, this skill can be triggered automatically:\n\n# Example hook configuration (conceptual)\n{\n  \"on\": \"task_complete\",\n  \"run\": \"bash ~/clawd/skills/gotify/scripts/send.sh 'Task: {{task_name}} completed in {{duration}}'\"\n}\n\nParameters\n-m, --message <text>: Notification message (required)\n-t, --title <text>: Notification title (optional)\n-p, --priority <0-10>: Priority level (default: 5)\n0-3: Low priority\n4-7: Normal priority\n8-10: High priority (may trigger sound/vibration)\n--markdown: Enable markdown formatting in message\nExamples\nNotify when subagent finishes\n# After spawning subagent\nsessions_spawn --task \"Research topic\" --label my-research\n# ... wait for completion ...\nbash scripts/send.sh -t \"Research Complete\" -m \"Check session: my-research\"\n\nNotify on error with high priority\nif ! ./critical-task.sh; then\n  bash scripts/send.sh -t \"⚠️ Critical Failure\" -m \"Task failed, check logs\" -p 10\nfi\n\nRich markdown notification\nbash scripts/send.sh --markdown -t \"Daily Summary\" -m \"\n# System Status\n\n## ✅ Healthy\n- UniFi: 34 clients\n- Sonarr: 1,175 shows\n- Radarr: 2,551 movies\n\n## 📊 Stats\n- Uptime: 621h\n- Network: All OK\n\"\n\nWorkflow\n\nWhen the user says:\n\n\"Notify me when this finishes\" → Add && bash scripts/send.sh \"Task complete\" to their command\n\"Send a Gotify alert\" → Run bash scripts/send.sh with their message\n\"Push notification for task completion\" → Integrate into their workflow with appropriate title/priority\n\nAlways confirm the notification was sent successfully (check for JSON response with message ID).\n\nNotes\nRequires network access to your Gotify server\nApp token must have \"create message\" permission\nPriority levels affect notification behavior on client devices\nMarkdown support depends on Gotify client version (most modern clients support it)\nReference\nGotify API docs: https://gotify.net/docs/\nGotify Android/iOS apps for receiving notifications"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/jmagar/gotify",
    "publisherUrl": "https://clawhub.ai/jmagar/gotify",
    "owner": "jmagar",
    "version": "1.0.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/gotify",
    "downloadUrl": "https://openagent3.xyz/downloads/gotify",
    "agentUrl": "https://openagent3.xyz/skills/gotify/agent",
    "manifestUrl": "https://openagent3.xyz/skills/gotify/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/gotify/agent.md"
  }
}