# Send Samsung Smartthings to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- 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.
## Suggested prompts
### New install

```text
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.
```
### Upgrade existing

```text
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.
```
## Machine-readable fields
```json
{
  "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": {
    "downloadUrl": "/downloads/samsung-smartthings",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=samsung-smartthings",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/setup_smartthings.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "samsung-smartthings",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-01T05:41:37.806Z",
      "expiresAt": "2026-05-08T05:41:37.806Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=samsung-smartthings",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=samsung-smartthings",
        "contentDisposition": "attachment; filename=\"samsung-smartthings-0.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "samsung-smartthings"
      },
      "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/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."
      ]
    }
  },
  "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"
  }
}
```
## Documentation

### Samsung Smart TV (SmartThings)

This skill provisions a SmartThings OAuth app and stores the credentials for Clawdbot.

Setup (one-time)

Create the SmartThings OAuth app headlessly (requires a PAT) and print a phone login URL, using plain text instructions only.
Open the URL on your phone, log in, then copy the code query parameter from the redirect page and re-run to exchange it.
If 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.
Re-run to refresh credentials: describe the action in plain text (no code snippets).

What it does

Creates an OAuth-In SmartApp with display name smartthings-clawdbot.
Uses scopes r:devices:* and x:devices:* (read + execute commands).
Redirect URI defaults to https://httpbin.org/get (can be overridden via redirect-uri option).
Writes SMARTTHINGS_APP_ID, SMARTTHINGS_CLIENT_ID, SMARTTHINGS_CLIENT_SECRET plus OAuth tokens to ~/.clawdbot/.env (or CLAWDBOT_STATE_DIR/.env).
Uses the SmartThings CLI to create the OAuth app when a PAT is provided.
Exchanges the OAuth code for tokens via direct HTTPS to SmartThings (not via the CLI).

Device setup

Use the SmartThings CLI to list devices in JSON and locate the TV device id.
Store it as SMARTTHINGS_DEVICE_ID in the same .env file.

Common actions (plain text only)

List devices and capabilities via the SmartThings CLI.
Check device status.
Send switch/volume/mute commands to the TV device.

App launch (Netflix/Prime Video)

App launch is device-specific; look for applicationLauncher or samsungtv in capabilities.
Discover app IDs in device status under supportedApps or installedApps.
Launch apps using the SmartThings CLI and the appId from your TV.
Example IDs are not universal; use the IDs listed for your TV.

App discovery (when a user asks to open a specific app)

First, open the target app manually on the TV.
Then query device status and look for fields like tvChannelName, installedApps, or supportedApps to extract the current appId.
Save the appId for future use; some IDs are device-specific.
Known app id patterns (examples):

Standard/global apps (often stable):

Netflix: org.tizen.netflix-app
Amazon Prime: org.tizen.primevideo
Pattern: org.tizen.[app-name]


Device-specific apps (vary per TV):

YouTube: {random}.TizenYouTube
Joyn: {random}.ZAPPNVOLLTVFREIGESTREAMT
Pattern: {random}.{PackageName}




Avoid guessing; always confirm the appId from the TV’s status payload.

Notes

The script defaults to headless mode and will not open a browser.
Provide a PAT via SMARTTHINGS_TOKEN (or SMARTTHINGS_PAT) to authenticate.
Create a PAT here: https://account.smartthings.com/tokens
OAuth flow: open the printed URL on your phone, then copy the code query parameter from the redirect page and re-run with auth-code.
The 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.
Re-running the setup is safe; it updates the env entries in place.
Response style: do not include code blocks or inline command snippets; use plain text steps only.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: regenrek
- Version: 0.0.1
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-01T05:41:37.806Z
- Expires at: 2026-05-08T05:41:37.806Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/samsung-smartthings)
- [Send to Agent page](https://openagent3.xyz/skills/samsung-smartthings/agent)
- [JSON manifest](https://openagent3.xyz/skills/samsung-smartthings/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/samsung-smartthings/agent.md)
- [Download page](https://openagent3.xyz/downloads/samsung-smartthings)