yoooclaw-tunnel-debug SKILL.md skillA

yoooclaw-tunnel-debug from yoooclaw/cli is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add yoooclaw/cli/yoooclaw-tunnel-debug@git:20260722.a0678bd

Pins git:20260722.a0678bd in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
yoooclaw/cli
Path
skills/yoooclaw-tunnel-debug/SKILL.md
Versions recorded
3
Latest version
git:20260722.a0678bd, committed Jul 22, 2026
First version recorded
Jun 1, 2026
Size
5,288 bytes
Repository stars
98
License
MIT

用 yoooclaw CLI 排查手机端推送链路是否通。当用户说“手机推送收不到”“通知没同步过来”“检查一下隧道/连接”“daemon 还活着吗”“手机连不上”时激活。组合使用 doctor / auth status / daemon status / tunnel status / tunnel +test / gateway test / daemon logs 定位本地环境、daemon、本地 ingest 鉴权与 Relay WebSocket 状态。多数命令需要 daemon 在运行(🟡)。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# yoooclaw Relay / 接收链路排查

独立 daemon 默认用 account api-key 连接托管 Relay WebSocket,手机 App 绑定同一账号后经 Relay 收发。也可以在 Relay 未启用或不可用时,将 `POST /notifications` 通过用户自建 `cloudflared` / `tailscale serve` 暴露为直连 HTTP fallback。

## 排查顺序

```bash
# 0) 本地环境一把梭:运行时/目录/keychain/config/daemon
yoooclaw doctor --format json
# 每项 status 为 ok|warn|fail|skip;--fix 可自动修可修的(目录权限等)。
# doctor 不做网络探测,网络问题继续往下走。

# 1) 本地凭据是否存在;不调 daemon
yoooclaw auth status --format json

# 2) daemon 是否在跑、监听哪个地址端口
yoooclaw daemon status --format json
# 未运行 → yoooclaw daemon start --format json

# 3) Relay 模式、连接状态、URL、多隧道状态
yoooclaw tunnel status --format json

# 4) daemon 本地回环:验证本地 ingest + 鉴权
yoooclaw tunnel +test --format json

# 5) 模拟手机端直接调本地 /notifications
yoooclaw gateway test --format json

# 6) 看 Relay 连接与重连日志
yoooclaw daemon logs --lines 200 --format json
yoooclaw log +errors --format json
```

`tunnel +test` 会让 daemon 给本地 `/notifications` 发一条 echo 通知。它可以确认本地 ingest + 鉴权链路,但不会让流量真正绕行远端 Relay。`gateway test --via-relay` 当前也是复用这条本地回环路径,不应单独作为远端 Relay 可达性的证据。

## 判读

- `auth status` 中 api-key 不存在:先用 `yoooclaw auth set-api-key -` 从 stdin 设置,再 `yoooclaw daemon reload`(daemon 已在跑时优先 reload:重读凭据并增量刷新隧道,不中断已有连接;没在跑才 `daemon start`)。
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add yoooclaw/cli/yoooclaw-tunnel-debug@sha256:8a0b161e945594af

The line at the top of this page pins the label git:20260722.a0678bd, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_46slju67thux45pd.svg)](https://markdownregistry.com/a/art_46slju67thux45pd)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 3 versions of this file, between Jun 1, 2026 and Jul 22, 2026, about one every 25 days.

versioncommittedcommitsizeaudit
git:20260722.a0678bd latest2026-07-22 a0678bd 5,288 BA view · diff
git:20260602.fbc46682026-06-02 fbc4668 3,282 BA view · diff
git:20260601.0b6be9e2026-06-01 0b6be9e 2,663 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (5288 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

yoooclaw/cli · 98 stars · license MIT · pushed 2026-11-08 · branch master

API

GET https://markdownregistry.com/api/v1/artifacts/art_46slju67thux45pd
GET https://markdownregistry.com/api/v1/resolve?ref=yoooclaw/cli/yoooclaw-tunnel-debug
GET https://markdownregistry.com/api/v1/blob/8a0b161e945594af5dd7174b81bb35afaf202d9a2f8de52b373296509ba5be86

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from yoooclaw/cli

yoooclaw-context-query SKILL.md skill
yoooclaw/cli · skills/yoooclaw-context-query/SKILL.md · Query synchronized local context and YoooClaw App todos: things/plans/tasks (“今天有什么事情/安排/待办”) from system calendars…
git:20261105.2ffa9bd · audit A · 98 stars
yoooclaw-context-to-memory SKILL.md skill
yoooclaw/cli · skills/yoooclaw-context-to-memory/SKILL.md · Memory from synchronized notifications, calendars, location history, health statistics and…
git:20261105.2ffa9bd · audit A · 98 stars
yoooclaw-data-transfer SKILL.md skill
yoooclaw/cli · skills/yoooclaw-data-transfer/SKILL.md · Export or import yoooclaw data by OSS migration task ID or local package between environments (`yoooclaw transfer`)…
git:20261026.b948d89 · audit A · 98 stars
yoooclaw-data SKILL.md skill
yoooclaw/cli · skills/yoooclaw-data/SKILL.md · Save or retrieve arbitrary user files, text, and binary data with yc data. Use for explicitly saving content or finding…
git:20261102.b551052 · audit A · 98 stars
yoooclaw-light SKILL.md skill
yoooclaw/cli · skills/yoooclaw-light/SKILL.md · 设备显示与灯效:使用 yoooclaw CLI 把内容显示到硬件屏幕、立即播放一次灯效,或管理“通知→灯效”持久规则。用户要求在硬件屏幕显示文字或结果、现在或任务完成后亮灯、或让通知触发灯效时使用。
git:20260905.86bf25c · audit A · 98 stars
yoooclaw-media-generate SKILL.md skill
yoooclaw/cli · skills/yoooclaw-media-generate/SKILL.md · AI 图片生成与视频生成:根据用户的文字描述、创意或提示词,直接生成可查看和下载的图片或视频。 当用户想画图、生图、生成图片、创作插画、制作海报配图、头像、壁纸、封面或产品概念图时使用,…
git:20261009.b7e1c64 · audit A · 98 stars
yoooclaw-recordings-process SKILL.md skill
yoooclaw/cli · skills/yoooclaw-recordings-process/SKILL.md · Process yoooclaw recordings/transcripts or supported provided text/files into structured artifacts. Use for meeting…
git:20260729.819f4af · audit A · 98 stars
yoooclaw-todo SKILL.md skill
yoooclaw/cli · skills/yoooclaw-todo/SKILL.md · 使用 yoooclaw CLI 创建、修改、完成、恢复和删除 YoooClaw App 个人待办,也可查询明确指定的 App 待办或接续已选定的 App 待办操作。泛指“今天有什么事情/日程/安排/待办”等只读查询使用…
git:20261023.da6003d · audit A · 98 stars

Every file in yoooclaw/cli

Browse by kind, by grade A, or by owner.