# Send dxh141130 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": "wps-punchclock",
    "name": "dxh141130",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/dxh141130/wps-punchclock",
    "canonicalUrl": "https://clawhub.ai/dxh141130/wps-punchclock",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/wps-punchclock",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=wps-punchclock",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "references/PUNCHCLOCK_RUNBOOK.md",
      "scripts/setup.mjs",
      "scripts/punchclock.mjs",
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "wps-punchclock",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-11T23:49:17.174Z",
      "expiresAt": "2026-05-18T23:49:17.174Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=wps-punchclock",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=wps-punchclock",
        "contentDisposition": "attachment; filename=\"wps-punchclock-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "wps-punchclock"
      },
      "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/wps-punchclock"
    },
    "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/wps-punchclock",
    "downloadUrl": "https://openagent3.xyz/downloads/wps-punchclock",
    "agentUrl": "https://openagent3.xyz/skills/wps-punchclock/agent",
    "manifestUrl": "https://openagent3.xyz/skills/wps-punchclock/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/wps-punchclock/agent.md"
  }
}
```
## Documentation

### WPS Time / NetTime Punchclock

Run the bundled Playwright script to log into WPS Time NetTime using macOS Keychain credentials, perform the requested punch action (or status check), take a screenshot, and report results.

### Inputs → actions

Map user intent to the script --action:

### Setup / credentials

setup punchclock / configure punchclock / set up time clock → run setup flow

### Punch actions

clock in → clock-in
clock out → clock-out
start break → start-break
end break → end-break (implemented as Clock In (end break) in script)
start lunch → start-lunch
end lunch → end-lunch (implemented as Clock In (end lunch) in script)
status / check status → status

### Option A (recommended): local terminal setup (password never enters chat logs)

Run the interactive setup script to store credentials in macOS Keychain:

cd {baseDir}/scripts
node ./setup.mjs

This stores credentials locally under Keychain services:

wpstime-punchclock.company (secret = company/common id)
wpstime-punchclock (account = username, secret = password)

### Option B: chat wizard setup (includes password; higher risk)

Only use if the user explicitly asks for chat-based setup and accepts that the password will appear in chat history/logs.

Workflow:

Warn clearly:

the password will be sent via chat and may be stored by the chat platform + gateway logs.
recommend Option A instead.


If they still confirm, collect 3 fields in separate turns:

companyId
username
password


Store into macOS Keychain on the SAME machine running the gateway using security add-generic-password -U:

security add-generic-password -U -s "wpstime-punchclock.company" -a "company" -w "<companyId>"
security add-generic-password -U -s "wpstime-punchclock" -a "<username>" -w "<password>"

Never echo the password back. After storing, run status to verify login works.

### Workflow

Run the punch script (headless by default):

node {baseDir}/scripts/punchclock.mjs --action <action>

Optional flags:

--headless 0 for debugging
--outDir <path> to control screenshot output

Parse stdout JSON.

On success: read performed, screenshotPath, and (optionally) pull key fields from snippet.
On failure: report error and do not claim the punch succeeded.

Reply to the requesting channel with:

one-line confirmation (what was performed)
effective status/time if present (best-effort)
attach the screenshot at screenshotPath

If the user asks to clock in/out but they may already be in that state, prefer running status first or immediately after to confirm and avoid double-punch confusion.

### Credentials (macOS Keychain)

Do not store secrets in files or prompts. Use Keychain.

Preferred services (used by setup.mjs):

Service wpstime-punchclock.company → secret = company/common id
Service wpstime-punchclock → account = username, secret = password

Backward-compat (older OpenClaw setups):

openclaw.wpstime.company
openclaw.wpstime

If missing, the punch script throws an error. When that happens, guide the user to run:

cd {baseDir}/scripts
node ./setup.mjs

Then retry the requested action.

### Reference

If you need the longer operational runbook, read:

references/PUNCHCLOCK_RUNBOOK.md
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: dxh141130
- Version: 1.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-11T23:49:17.174Z
- Expires at: 2026-05-18T23:49:17.174Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/wps-punchclock)
- [Send to Agent page](https://openagent3.xyz/skills/wps-punchclock/agent)
- [JSON manifest](https://openagent3.xyz/skills/wps-punchclock/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/wps-punchclock/agent.md)
- [Download page](https://openagent3.xyz/downloads/wps-punchclock)