{
  "schemaVersion": "1.0",
  "item": {
    "slug": "samsung-smartthings",
    "name": "Samsung Smartthings",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/regenrek/samsung-smartthings",
    "canonicalUrl": "https://clawhub.ai/regenrek/samsung-smartthings",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/samsung-smartthings",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=samsung-smartthings",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "scripts/setup_smartthings.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-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/samsung-smartthings"
    },
    "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/samsung-smartthings",
    "agentPageUrl": "https://openagent3.xyz/skills/samsung-smartthings/agent",
    "manifestUrl": "https://openagent3.xyz/skills/samsung-smartthings/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/samsung-smartthings/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": "Samsung Smart TV (SmartThings)",
        "body": "This skill provisions a SmartThings OAuth app and stores the credentials for Clawdbot.\n\nSetup (one-time)\n\nCreate the SmartThings OAuth app headlessly (requires a PAT) and print a phone login URL, using plain text instructions only.\nOpen the URL on your phone, log in, then copy the code query parameter from the redirect page and re-run to exchange it.\nIf PAT app creation fails (403), create the app on a normal machine using the SmartThings CLI login flow and then set the client id/secret in the .env before running the code-exchange step.\nRe-run to refresh credentials: describe the action in plain text (no code snippets).\n\nWhat it does\n\nCreates an OAuth-In SmartApp with display name smartthings-clawdbot.\nUses scopes r:devices:* and x:devices:* (read + execute commands).\nRedirect URI defaults to https://httpbin.org/get (can be overridden via redirect-uri option).\nWrites SMARTTHINGS_APP_ID, SMARTTHINGS_CLIENT_ID, SMARTTHINGS_CLIENT_SECRET plus OAuth tokens to ~/.clawdbot/.env (or CLAWDBOT_STATE_DIR/.env).\nUses the SmartThings CLI to create the OAuth app when a PAT is provided.\nExchanges the OAuth code for tokens via direct HTTPS to SmartThings (not via the CLI).\n\nDevice setup\n\nUse the SmartThings CLI to list devices in JSON and locate the TV device id.\nStore it as SMARTTHINGS_DEVICE_ID in the same .env file.\n\nCommon actions (plain text only)\n\nList devices and capabilities via the SmartThings CLI.\nCheck device status.\nSend switch/volume/mute commands to the TV device.\n\nApp launch (Netflix/Prime Video)\n\nApp launch is device-specific; look for applicationLauncher or samsungtv in capabilities.\nDiscover app IDs in device status under supportedApps or installedApps.\nLaunch apps using the SmartThings CLI and the appId from your TV.\nExample IDs are not universal; use the IDs listed for your TV.\n\nApp discovery (when a user asks to open a specific app)\n\nFirst, open the target app manually on the TV.\nThen query device status and look for fields like tvChannelName, installedApps, or supportedApps to extract the current appId.\nSave the appId for future use; some IDs are device-specific.\nKnown app id patterns (examples):\n\nStandard/global apps (often stable):\n\nNetflix: org.tizen.netflix-app\nAmazon Prime: org.tizen.primevideo\nPattern: org.tizen.[app-name]\n\n\nDevice-specific apps (vary per TV):\n\nYouTube: {random}.TizenYouTube\nJoyn: {random}.ZAPPNVOLLTVFREIGESTREAMT\nPattern: {random}.{PackageName}\n\n\n\n\nAvoid guessing; always confirm the appId from the TV’s status payload.\n\nNotes\n\nThe script defaults to headless mode and will not open a browser.\nProvide a PAT via SMARTTHINGS_TOKEN (or SMARTTHINGS_PAT) to authenticate.\nCreate a PAT here: https://account.smartthings.com/tokens\nOAuth flow: open the printed URL on your phone, then copy the code query parameter from the redirect page and re-run with auth-code.\nThe default redirect uses https://httpbin.org/get to show the code in the URL; you can switch to your own redirect URI if you don’t want to use httpbin.\nRe-running the setup is safe; it updates the env entries in place.\nResponse style: do not include code blocks or inline command snippets; use plain text steps only."
      }
    ],
    "body": "Samsung Smart TV (SmartThings)\n\nThis skill provisions a SmartThings OAuth app and stores the credentials for Clawdbot.\n\nSetup (one-time)\n\nCreate the SmartThings OAuth app headlessly (requires a PAT) and print a phone login URL, using plain text instructions only.\nOpen the URL on your phone, log in, then copy the code query parameter from the redirect page and re-run to exchange it.\nIf PAT app creation fails (403), create the app on a normal machine using the SmartThings CLI login flow and then set the client id/secret in the .env before running the code-exchange step.\nRe-run to refresh credentials: describe the action in plain text (no code snippets).\n\nWhat it does\n\nCreates an OAuth-In SmartApp with display name smartthings-clawdbot.\nUses scopes r:devices:* and x:devices:* (read + execute commands).\nRedirect URI defaults to https://httpbin.org/get (can be overridden via redirect-uri option).\nWrites SMARTTHINGS_APP_ID, SMARTTHINGS_CLIENT_ID, SMARTTHINGS_CLIENT_SECRET plus OAuth tokens to ~/.clawdbot/.env (or CLAWDBOT_STATE_DIR/.env).\nUses the SmartThings CLI to create the OAuth app when a PAT is provided.\nExchanges the OAuth code for tokens via direct HTTPS to SmartThings (not via the CLI).\n\nDevice setup\n\nUse the SmartThings CLI to list devices in JSON and locate the TV device id.\nStore it as SMARTTHINGS_DEVICE_ID in the same .env file.\n\nCommon actions (plain text only)\n\nList devices and capabilities via the SmartThings CLI.\nCheck device status.\nSend switch/volume/mute commands to the TV device.\n\nApp launch (Netflix/Prime Video)\n\nApp launch is device-specific; look for applicationLauncher or samsungtv in capabilities.\nDiscover app IDs in device status under supportedApps or installedApps.\nLaunch apps using the SmartThings CLI and the appId from your TV.\nExample IDs are not universal; use the IDs listed for your TV.\n\nApp discovery (when a user asks to open a specific app)\n\nFirst, open the target app manually on the TV.\nThen query device status and look for fields like tvChannelName, installedApps, or supportedApps to extract the current appId.\nSave the appId for future use; some IDs are device-specific.\nKnown app id patterns (examples):\nStandard/global apps (often stable):\nNetflix: org.tizen.netflix-app\nAmazon Prime: org.tizen.primevideo\nPattern: org.tizen.[app-name]\nDevice-specific apps (vary per TV):\nYouTube: {random}.TizenYouTube\nJoyn: {random}.ZAPPNVOLLTVFREIGESTREAMT\nPattern: {random}.{PackageName}\nAvoid guessing; always confirm the appId from the TV’s status payload.\n\nNotes\n\nThe script defaults to headless mode and will not open a browser.\nProvide a PAT via SMARTTHINGS_TOKEN (or SMARTTHINGS_PAT) to authenticate.\nCreate a PAT here: https://account.smartthings.com/tokens\nOAuth flow: open the printed URL on your phone, then copy the code query parameter from the redirect page and re-run with auth-code.\nThe default redirect uses https://httpbin.org/get to show the code in the URL; you can switch to your own redirect URI if you don’t want to use httpbin.\nRe-running the setup is safe; it updates the env entries in place.\nResponse style: do not include code blocks or inline command snippets; use plain text steps only."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/regenrek/samsung-smartthings",
    "publisherUrl": "https://clawhub.ai/regenrek/samsung-smartthings",
    "owner": "regenrek",
    "version": "0.0.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/samsung-smartthings",
    "downloadUrl": "https://openagent3.xyz/downloads/samsung-smartthings",
    "agentUrl": "https://openagent3.xyz/skills/samsung-smartthings/agent",
    "manifestUrl": "https://openagent3.xyz/skills/samsung-smartthings/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/samsung-smartthings/agent.md"
  }
}