What makes wb-buddy-checkin notable?

1.3K downloads. Trust evidence available

How should wb-buddy-checkin be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

wb-buddy-checkin

自动完成 WorkBuddy 桌面客户端「Buddy 加油站」每日签到与「派猫猫旅行」积分领取。API 直连方案（推荐）：读本机登录态直调官方接口，兼容 5.6.2+ 加密登录态（AES-256-GCM 信封自动解密）；GUI 坐标点击方案兜底（纯 ctypes 窗口置前 + 坐标点击 + 截图灰度校验，零第三方依赖）。猫猫旅行支持只读状态展示与先领后派全自动闭环（写操作需显式 --auto）。 Skill: wb-buddy-checkin Owner: noaheleven Summary: 自动完成 WorkBuddy 桌面客户端「Buddy 加油站」每日签到与「派猫猫旅行」积分领取。API 直连方案（推荐）：读本机登录态直调官方接口，兼容 5.6.2+ 加密登录态（AES-256-GCM 信封自动解密）；GUI 坐标点击方案兜底（纯 ctypes 窗口置前 + 坐标点击 + 截图灰度校验，零第三方依赖）。猫猫旅行支持只读状态展示与先领后派全自动闭环（写操作需显式 --auto）。 Tags: latest:0.1.8 Version history: v0.1.8 | 2026-09-30T01:47:30.807Z | user 版本号递增至 0.1.8（内容与 0.1.7 一致：派猫猫旅行闭环 + 加密登录态兼容 + GUI 兜底）。 v0.1.7 | 2026-09-30T01:40:48.302Z | u

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.3k

Updated

Oct 10, 2026

Version

0.1.8

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.3K downloads reported by the source. Last updated 10/10/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 10, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 10, 2026
Adoption signal: 1.3K downloadsadoption · observed Oct 10, 2026
Latest release: 0.1.8release · observed Sep 30, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s176ns2k88htgg2h6v9myyxg7x83q8k1:wb-buddy-checkin

Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-noaheleven-wb-buddy-checkin/snapshot"

Documentation

CLAWHUB

146,647 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: wb-buddy-checkin
description: 自动完成 WorkBuddy 桌面客户端「Buddy 加油站」每日签到与「派猫猫旅行」积分领取。API 直连方案（推荐）：读本机登录态直调官方接口，兼容 5.6.2+ 加密登录态（AES-256-GCM 信封自动解密）；GUI 坐标点击方案兜底（纯 ctypes 窗口置前 + 坐标点击 + 截图灰度校验，零第三方依赖）。猫猫旅行支持只读状态展示与先领后派全自动闭环（写操作需显式 --auto）。
agent_created: true
---

# wb-buddy-checkin —— WorkBuddy 每日签到 + 猫猫旅行

在 Windows 上自动完成 WorkBuddy「Buddy 加油站」每日签到（每日 100 积分）与「派猫猫旅行」闭环（每日 5-10 积分额外收益）。

**推荐执行顺序（2026-09-29 定稿）**：API 直连（秒级）→ 旅行 `--auto` 闭环 → 仅当 API 失败（exit 2）才回退 GUI 坐标点击。

## 何时使用

- 用户说「自动签到」「每天领 WorkBuddy 积分」「Buddy 加油站签到」。
- 配置定时任务，让它在每天固定时间（如 9:00）自动跑。
- 注意：这是**通用、可分享**的实现，**不包含任何个人身份、路径或通知目标**；若要把结果推送给某人（微信/钉钉等），由调用方在 skill 之外自行配置。

## 前置条件

- Windows 系统（脚本依赖 `ctypes.windll` / `user32` / `gdi32`）。
- Python 3（标准库即可，无需 `pip install` 任何包）。
- WorkBuddy 桌面客户端正在运行。
- 首次使用**必须校准坐标**（见 `references/calibration.md`），因为不同屏幕/布局下点击点不同。**这步跳过是移植后"只会点头像"的头号原因。**

## ⚠️ 移植给别人 / 第一次用：先做这件事

**先跑一次校准，再 `-run`**。脚本内置的坐标是作者屏幕的校准值，别人的屏幕八成对不上——头像在左下角还能蒙对，但加油站/领取位置一偏，后续点击全打空，看起来就像"只点了头像"。

校准有两种，**推荐用弹窗校准（通用、傻瓜、零依赖）**：

```bash
# 弹窗校准（推荐）：自动弹出一个悬浮窗，按提示把鼠标移到三个目标点，
# 每步倒计时结束自动记录，三步写 calibrate.json。无需终端/微信/任何外部通道。
python scripts/wb_mouse_checkin.py -calibrate-gui
```

无 GUI 环境（如某些精简 Python 没带 tkinter）时，退而用终端文字校准：

```bash
# 终端校准：把鼠标依次移到 头像 / Buddy加油站 / 立即领取 三个点，各按一次回车
python scripts/wb_mouse_checkin.py -calibrate
```

校准后直接：

```bash
python scripts/wb_mouse_checkin.py -run
```

> 没校准就 `-run`，脚本会红字警告"用的是示例默认坐标，大概率打空"，并打印算出的三个屏幕坐标供你对照。

## 使用方法

脚本位于 `scripts/`，**两套方案**：

### 方案 A：API 直连（推荐，2026-08-18 新增 / 2026-09-29 升级）

零 GUI 依赖，无窗口位置/DPI/更新横幅遮挡问题。读本地登录态直调官方接口：

```bash
# 查询状态 + 未签则领取（幂等）；优先 v2 端点（真实积分数据），失败自动回退旧端点
python scripts/wb_api_checkin.py

# 仅查询，不领取
python scripts/wb_api_checkin.py -status
```

退出码：`0`=成功/已签到 / `2`=失败（无登录态/解密不可用/接口异常）。

**原理**（2026-08-18 逆向自 app.asar + 实测验证；2026-09-29 兼容升级）：
- 登录态文件：`%LOCALAPPDATA%\CodeBuddyExtension\Data\Public\auth\workbuddy-desktop.info`（JSON；同一账号体系，WorkBuddy/CodeBuddy 通用）
- **5.6.2+ 加密登录态兼容（2026-09-29）**：新版把 `auth.accessToken` 改为 AES-256-GCM 信封 `{"$wbEncrypted":1,...}`，静态钥运行时驻留 WorkBuddy.exe 进程内存（磁盘无明文）。本脚本复用市场 skill **totorosir-workbuddy-score** 的解密引擎（`buddy_station.load_credentials`，MIT-0，密钥发现：环境变量→密钥文件→DPAPI/进程内存扫描→CDP），import 失败或未安装时明确报错 exit 2，由调用方回退 GUI。
- 端点（双端点，v2 优先）：
  - v2（数据真实）：`POST https://www.codebuddy.cn/v2/billing/meter/checkin-activity-status`（查询）、`POST /v2/billing/meter/daily-checkin`（领取，幂等）
  - legacy 回退：`POST https://copilot.tencent.com/billing/meter/checkin-status`、`POST /billing/meter/daily-checkin`（活动期外会返回 连续0/激活False 假数据，仅兜底）
- 认证：`Authorization: Bearer <accessToken>`；**billing 接口必须带浏览器 User-Agent**，否则服务端裸 400（2026-08-18 实测坑；travel 接口不校验 UA）

### 方案 A+：派猫猫旅行闭环（2026-09-29 新增）

```bash
# 只读状态展示（默认）：空闲/旅行中(倒计时)/已到达(可领积分)
python scripts/wb_travel.py

# 全自动闭环（写操作，先领后派）：arrived 则领取 → 重查 → idle 且未达每日上限则派出
python scripts/wb_travel.py --auto

# 指定派遣地点（1=咖啡馆 2=商场店铺 3=健身房 4=古镇客栈；缺省随机，收益无差异）
python scripts/wb_travel.py --au

README.md

# wb-buddy-checkin

自动完成 **WorkBuddy 桌面客户端**「Buddy 加油站」每日签到、领取 100 积分的 Windows 脚本。

无需 OCR、主题无关（亮色/暗色都能正确判定），纯 `ctypes` 调用 Windows 系统 API，
**零第三方 Python 依赖**，自带悬浮窗/终端两种校准方式。

---

## ✨ 特性

- 🖱️ **纯系统 API**：窗口置前、坐标点击、窗口截图全部用 `user32`/`gdi32`/`kernel32`，不装任何包。
- 🎯 **坐标自适应**：用「相对客户区左下角」定位，窗口任意缩放都命中，校准一次长期复用。
- 🪟 **三种校准**（见下）：弹窗悬浮窗（推荐）、终端交互、改代码常量。
- 🌗 **主题无关校验**：用「近黑像素数」区分黑底「立即领取」与灰底「今日已领」，亮/暗色都正确。
- 🛡️ **窗口精确匹配 + 坐标跟随窗口**：枚举只认标题完全等于 `WorkBuddy` 的主窗口（排除 `WorkBuddy - xxx` 子窗口）；坐标原点用 `GetWindowRect`（不用会被 WorkBuddy 干扰的 `ClientToScreen`），窗口被移去哪坐标就跟随到哪，天然免疫"窗口不在前台/被移动"。
- 🧘 **防"撞用户操作"三件套（2026-08-12）**：定时任务在用户正用电脑时跑也不打架——① 接管前 `wait_mouse_idle()` 检测鼠标空闲（静止 2s 才接管，最多等 60s），用户在用时安静等待；② 点头像前 `announce_move()` 鼠标「飞向目标→移开→飞回」两次可见位移做接管预告；③ 点击前停顿 0.4s 留反应时间。
- 🔒 **零隐私绑定**：脚本不含任何个人身份、绝对路径或通知目标，可直接分享给任何人。

---

## 📦 安装

```bash
# 方式一：从 GitHub 克隆
git clone https://github.com/NoahEleven/wb-buddy-checkin.git
cp -r wb-buddy-checkin ~/.workbuddy/skills/

# 方式二：直接把整个 skill 目录放进 ~/.workbuddy/skills/
```

放进 `~/.workbuddy/skills/` 后，WorkBuddy 会自动识别为可用 skill。

---

## 🚀 快速开始

> ⚠️ **第一次用必须先校准**，否则脚本用的是内置示例坐标，后续点击会打空（看起来像"只点头像"）。

```bash
cd ~/.workbuddy/skills/wb-buddy-checkin

# 1) 校准（推荐弹窗方式）
python scripts/wb_mouse_checkin.py -calibrate-gui

# 2) 签到
python scripts/wb_mouse_checkin.py -run
```

---

## 🎯 校准（移植给别人 / 第一次用的必做项）

脚本内置的坐标是**作者屏幕的占位示例**，别人的屏幕大概率对不上。校准会读取你鼠标的真实位置并保存到 `calibrate.json`，`-run` 自动读取覆盖默认坐标。

### 方法一：弹窗校准（推荐，最省事）

```bash
python scripts/wb_mouse_checkin.py -calibrate-gui
```

脚本弹出一个**右上角半透明悬浮窗**，显示当前步骤、实时鼠标坐标和倒计时，每步倒计时结束**自动采样**鼠标位置，三步写 `calibrate.json`：

1. **头像**：鼠标移到左下角【头像】→ 保持不动，倒计时结束自动记录。
2. **Buddy 加油站**：点开头像菜单，鼠标移到菜单里的【Buddy 加油站】项 → 保持不动，自动记录。
3. **立即领取**：点开加油站打开积分面板，鼠标移到【立即领取】按钮 → 保持不动，自动记录。

> 依赖 Python 标准库 `tkinter`（绝大多数 Windows Python 自带）。没有 tkinter 时脚本会提示改用方法二。

### 方法二：终端校准（无 GUI 时）

```bash
python scripts/wb_mouse_checkin.py -calibrate
```

把鼠标移到三个目标点，各按一次回车，坐标自动记录。

---

## 🔧 其他命令

```bash
python scripts/wb_mouse_checkin.py            # 干跑：打印窗口信息 + 计算坐标 + 校准状态，不点击
python scripts/wb_mouse_checkin.py -run       # 真实签到
python scripts/wb_mouse_checkin.py -calibrate-gui   # 弹窗校准
python scripts/wb_mouse_checkin.py -calibrate      # 终端校准
python scripts/wb_mouse_checkin.py -sample         # 即时采样当前鼠标位置（调试用）
```

**退出码**：`0`=成功（已处于「今日已领」） / `2`=失败（未领取或面板异常，报错会指明该校准哪个点） / `3`=未找到 WorkBuddy 窗口。

结果截图保存在脚本同目录 `checkin_result.png`。

---

## ⏰ 配置定时任务

在 WorkBuddy 自动化里建一个每日任务，prompt 大致为：

> 运行 `python scripts/wb_mouse_checkin.py -run`（脚本内置窗口置前与灰度校验）。
> 读 `checkin_result.png` 确认结果：灰色「今日已领」= 完成；黑底「立即领取」仍在 = 失败。
> 按你的通知偏好（微信/钉钉等）把结果发给本人。

cwd 设为该 skill 的 `scripts/` 所在目录。

---

## 🛠️ 关键实现要点（避免重踩坑）

1. **Win32 调用必须显式声明 `argtypes`**，`HWND` 按 `c_void_p`（64 位指针）传，回调签名用 `WINFUNCTYPE(BOOL, HWND, c_void_p)`。不声明会被 ctypes 默认按 32 位 `c_int` 截断，导致 `SetForegroundWindow` 静默失败——表现为「窗口没置顶、点击打空」。
2. **窗口枚举精确匹配标题**：`if title == TARGET_TITLE`（=`WorkBuddy`）优先，排除「WorkBuddy - 个人中心 - xxx」等子窗口；找不到再兜底子串匹配。子串匹配会命中 z 序最前的子窗口（可能最小化/未显示）→ 点击全打空。
3. **坐标原点用 `GetWindowRect` 的

_meta.json

{
  "ownerId": "kn769gn5we5rgv7bfhb9ztd8j983p8qc",
  "slug": "wb-buddy-checkin",
  "version": "0.1.8",
  "publishedAt": 1790732850807
}

references/calibration.md

# 坐标校准指南（wb-buddy-checkin）

脚本用「相对客户区左下角」的三个常量来定位点击点。这套设计让窗口任意缩放都命中，
但**每个人的屏幕分辨率 / WorkBuddy 窗口布局不同，首次使用必须校准**。

## 三个常量

| 常量 | 含义 | 默认示例值 |
|---|---|---|
| `AVATAR_LEFT` / `AVATAR_BOTTOM` | 左下角头像（账户菜单）距客户区左 / 底边缘 | 94 / 41 |
| `GAS_LEFT` / `GAS_BOTTOM` | 「Buddy 加油站」菜单项距左 / 底边缘 | 140 / 541 |
| `CLAIM_LEFT` / `CLAIM_BOTTOM` | 「立即领取」按钮距左 / 底边缘 | 89 / 113 |

> 客户区 = 窗口去掉标题栏和边框的内部区域。坐标用逻辑像素（脚本会自动乘 DPI 缩放）。
> 默认值是**作者屏幕的校准值**，只是占位示例——别人必须用下面的方法重新校准，否则会"只点头像"。

---

## ✅ 方法一：弹窗校准（首选，通用、零依赖、最傻瓜）

不需要截图、不需要终端交互、不需要任何外部通道——脚本弹出一个**右上角半透明悬浮窗**，
显示当前步骤、实时鼠标坐标和倒计时，每步倒计时结束**自动采样**你鼠标的位置，三步写 `calibrate.json`。

```bash
python scripts/wb_mouse_checkin.py -calibrate-gui
```

弹窗出现后，按提示分三步（窗口在右上角，不会挡住左下角的头像和中间的菜单）：

1. **头像**：把鼠标移到左下角【头像】→ 保持不动，倒计时（6秒）结束自动记录。
2. **Buddy 加油站**：点击头像展开菜单，把鼠标移到菜单里的【Buddy 加油站】项 → 保持不动，自动记录。
3. **立即领取**：点击加油站打开积分面板，把鼠标移到【立即领取】按钮 → 保持不动，自动记录。

脚本自动把三个真实屏幕坐标换算成「相对客户区左下角」并保存到 `calibrate.json`。
**之后每次 `-run` 都会自动读取该文件覆盖默认坐标**，无需再改代码。

> 依赖 Python 标准库 `tkinter`（绝大多数 Windows Python 自带）。若你的环境没有 tkinter，
> 脚本会提示改用下面的「方法二：终端校准」。

---

## ✅ 方法二：终端校准（无 GUI 时备用，零测量误差）

不需要截图和画图量像素，脚本读取你鼠标的真实位置。需开终端、手动按回车：

```bash
python scripts/wb_mouse_checkin.py -calibrate
```

按提示分三步操作（每步把 WorkBuddy 置前，鼠标移到目标点后，切回终端按回车）：

1. **头像**：让账户菜单收起，鼠标移到左下角头像 → 回车。
2. **Buddy 加油站**：点开头像菜单，鼠标移到菜单里的「Buddy 加油站」项 → 回车。
3. **立即领取**：点开「Buddy 加油站」面板，鼠标移到「立即领取」按钮 → 回车。

脚本自动把三个真实屏幕坐标换算成「相对客户区左下角」并保存到 `calibrate.json`。
**之后每次 `-run` 都会自动读取该文件覆盖默认坐标**，无需再改代码。

> 校准中途想放弃按 `Ctrl+C` 即可，没存盘不会破坏原有校准。

---

## 方法三：直接改代码常量（不推荐，仅核对用）

适合无法手动操作鼠标的自动化环境，或想核对坐标时：

1. 手动打开 WorkBuddy，点击左下角头像展开菜单，让「Buddy 加油站」面板可见。
2. 用系统「画图」打开一张窗口截图：
   - 「立即领取」按钮中心：距图片**左边缘**像素 = `CLAIM_LEFT`；距图片**底边缘** = `CLAIM_BOTTOM`。
   - 同理量头像（`AVATAR_*`）和「Buddy 加油站」项（`GAS_*`）。
3. 把值填进 `scripts/wb_mouse_checkin.py` 顶部配置区，保存。

---

## 验证

校准完成后跑真实签到：

```bash
python scripts/wb_mouse_checkin.py -run
```

- `结论: SUCCESS` 且截图按钮变灰「今日已领」= 校准正确。
- 报失败并提示 `请重新校准 GAS_*` → 加油站菜单项没点中（面板没开）。
- 报失败并提示 `请重新校准 CLAIM_*` → 面板开了但领取按钮没点中。
- 报"坐标落在窗口之外" → 某个常量填反了（距左/距底搞混），重测。

## 常见问题

- **只会点头像 / 后续点击打空**：没校准，用的是默认示例坐标。先 `-calibrate` 交互记录三个点。
- **点击打空 / 窗口没被置前**：① 脚本枚举到的是否主窗口？精确标题 `WorkBuddy`（排除 `WorkBuddy - xxx` 子窗口，旧版子串匹配会误选 z 序最前的子窗口导致全打空，已修复）；② 坐标原点是否用 `GetWindowRect`？（`ClientToScreen` 被 WorkBuddy 弹出菜单干扰会返回 2× 错误值，已修复）。若仍无效，确认 WorkBuddy 未被最小化到托盘且未被其他全屏窗口遮挡。
- **暗色主题误判**：校验用「近黑像素数」而非白字数（灰底「今日已领」也含白字），主题无关，亮/暗色都正确。
- **截图失败**：优先用 desktop-control-win 的 `screen-info.ps1`；若未安装该 skill，自动回退到 `PrintWindow` 客户区截图。两者都失败则签到仍会执行但无法自动校验（退出码 2）。

skill-card.md

## Description:

Automates daily WorkBuddy Buddy Station check-ins and cat-travel reward collection, with API access and a calibrated Windows desktop fallback.

This skill is ready for commercial/non-commercial use.

## Publisher:

[noaheleven](https://clawhub.ai/user/noaheleven)

### License/Terms of Use:

MIT-0

## Use Case:

WorkBuddy users on Windows use this skill to check in for daily points, review cat-travel status, and optionally claim travel rewards and send the cat on another trip. It can fall back to calibrated desktop clicks if API check-in fails.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: The skill reads or decrypts the local WorkBuddy login state and sends bearer credentials to official service endpoints.

Mitigation: Use only with an account you authorize, review credential access and endpoint use before installation, and avoid exposing local authentication files or output.

Risk: Optional external helper skills may access encrypted credentials or capture desktop screenshots.

Mitigation: Review the helper skills before enabling them; avoid them if their access is not acceptable.

Risk: Desktop automation can click the wrong control, store screenshots and state, or briefly create a Windows scheduled task during update recovery.

Mitigation: Calibrate and dry-run desktop clicks before execution; review stored screenshots and state, and check that the recovery task is removed.

## Reference(s):

- [ClawHub skill release](https://clawhub.ai/noaheleven/skills/wb-buddy-checkin)
- [Windows desktop calibration guide](references/calibration.md)

## Skill Output:

**Output Type(s):** [Text, JSON, Guidance]

**Output Format:** [Console status and optional JSON travel status]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Check-in and travel actions can change account reward state; desktop fallback can save screenshots and calibration or recovery state locally.]

## Skill Version(s):

0.1.8 (source: server-resolved ClawHub release)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

Github ReposUpdated 1d agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.