원클릭으로 Manus에서 모든 스킬 실행

yoooclaw-tunnel-debug

스타16

포크2

업데이트2026년 7월 22일 02:23

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

설치

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

Manus에서 실행

출처

YoooClaw

YoooClaw/cli

GitHub 저장소 열기 Creator 저장소 보기

다운로드

Manus에서 실행

yoooclaw Relay / 接收链路排查

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

排查顺序

# 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）。
daemon status 报 YOOOCLAW_DAEMON_NOT_RUNNING：运行 yoooclaw daemon start。
tunnel status 的 mode=relay 且 connected=true：daemon 当前已连上 Relay WebSocket。
tunnel status 的 mode=relay 但 connected=false：结合 lastDisconnectReason、reconnectAttempt 和 daemon 日志排查 api-key、网络与 Relay 服务。
tunnel status 的 stale=true：隧道实际拨的 currentUrl 与配置解析出的 expectedUrl 不一致，说明正在跟随环境切换重连——等一轮重连即可，不是故障。
tunnel status 的 mode=standalone-http：当前没有 Relay 隧道，先读返回的 note 再下结论，它区分了四种成因：
- Relay 未启用，走直连 HTTP → relay.enabled 为 false。
- Relay 已启用但当前 CredentialSet 没有可用 api-key → 补 api-key 后 daemon reload。
- ingress=proxied：隧道由宿主代理，daemon 仅收 ingest → 预期行为，隧道归宿主管，别在这儿查。
- ingress=direct：隧道关闭，仅接受直接 POST → 预期行为，走直连。只有明确采用直连 fallback 时才检查防火墙、反代和手机端地址。
tunnel +test 或 gateway test 失败：先排查本地 gateway token。运行 yoooclaw auth status，必要时 yoooclaw auth token-rotate；daemon 已运行时随后执行 yoooclaw daemon restart（token 轮换必须 restart，reload 不够）。

环境 / 主机对不上

tunnel status 返回的 env 是当前环境名（development|test|production）。隧道、灯效、ASR 共用同一个云端主机，解析优先级为 环境变量 > cloud.host > relay.url > 内置默认：

yoooclaw config show --format json     # 看 cloud.host / relay.url 实际值（敏感字段已遮罩）
yoooclaw config set cloud.host openclaw-service.yoooclaw.com
yoooclaw config unset cloud.host       # 清掉后跟随 PHONE_NOTIFICATIONS_ENV

环境变量：PHONE_NOTIFICATIONS_ENV（development|test|production）与对应的 OPENCLAW_HOST_DEVELOPMENT / OPENCLAW_HOST_TEST / OPENCLAW_HOST_PRODUCTION 覆盖。

若用户报「隧道连着但灯效 / 转写报 401」，八成是手机端账号与本地 api-key 指向了不同环境：比对 tunnel status 的 env 与手机 App 所在环境，再改 cloud.host 或环境变量对齐，最后 yoooclaw daemon reload。

多 clientLabel

多 api-key 模式下，每个 label 对应一条 Relay 隧道。按 label 缩小排查范围：

yoooclaw auth list-api-keys --format json
yoooclaw tunnel status --client work --format json
yoooclaw tunnel +test --client work --format json
yoooclaw tunnel reconnect --client work --format json

鉴权检查

yoooclaw auth status --format json
yoooclaw auth check --format json

auth status 只读本地凭据与 daemon lock。auth check 会用本地 gateway token 调 daemon /daemon/status，用于确认 CLI 和 daemon 的 token 是否一致。

이 저장소의 다른 Skills

같은 저장소

yoooclaw-lightrule-create

YoooClaw/cli

用 yoooclaw CLI 创建/管理"通知→灯效"规则。当用户表达"收到/当/如果某类通知或消息时，亮灯/闪灯/变成某种灯效"这类**持久规则**诉求时激活。规则保存在云端 Notification Intelligence Service，由云端评估命中并触发灯效。只需把用户的自然语言诉求原样传给 --intent。

2026-07-2216

yoooclaw-notification-query

YoooClaw/cli

查询、汇总、总结手机通知/消息。处理一切"通知 / 消息"的查看、筛选、汇总、总结请求，这是唯一对口的 Skill。最高频触发语（必须命中，不能漏）： - "帮我总结最近的通知，约 {数量} 条。（上次总结时间: {YYYY年M月D日 HH:mm}）" - "帮我总结最近的通知""总结下最近的通知""总结一下我的通知""总结最近收到的消息" 其它触发语："查看我的通知""最近收到什么消息""最近有什么通知""谁找过我""某某给我发过什么""昨天/今天有什么通知""看看我的微信消息"。简单判定规则：用户话里出现"通知"或"消息"，且想看 / 查 / 筛 / 总结 / 汇总 / 概览其中之一，就立即激活本 Skill。通知数据持续更新：每次都必须重新激活并从头完整执行本 Skill 流程，基于最新磁盘数据重新查询，禁止复用上一轮结果、禁止从记忆中检索（即使刚更新过记忆）。

2026-07-2216

yoooclaw-recording-entity-extraction

YoooClaw/cli

从文本文件或录音转写中提取特定实体（人名、联系方式、机构、术语等）。支持自定义提取需求或通用提取，输出 sidecar JSON 文件。当用户要求"提取信息""找联系方式""有哪些人名""关键信息""从文件提取"时激活。基于录音时用 yoooclaw CLI 定位文件；yoooclaw 是 openclaw 手机录音插件的独立 CLI 形态，数据在 ~/.yoooclaw 下。

2026-07-2216

yoooclaw-recording-interview

YoooClaw/cli

用 yoooclaw CLI 定位采访录音转写并整理结构化采访稿。当用户说"整理采访内容""提取核心观点""整理成问答""帮我梳理采访录音""输出采访 Q&A"等表达时激活，一律优先使用本 Skill；必须通过 yoooclaw recording 命令获得转写文件的真实存储位置，严禁假设录音目录。yoooclaw 是 openclaw 手机录音插件的独立 CLI 形态，数据在 ~/.yoooclaw 下。

2026-07-2216

yoooclaw-recording-meeting-minutes

YoooClaw/cli

用 yoooclaw CLI 定位会议录音转写并整理结构化会议纪要。当用户说"整理一下会议纪要""总结这次会议""会议有哪些待办""帮我整理会议纪要"等表达时激活，一律优先使用本 Skill；必须通过 yoooclaw recording 命令获得转写文件的真实存储位置，严禁使用记忆搜索或文档搜索工具，否则会造成严重遗漏。yoooclaw 是 openclaw 手机录音插件的独立 CLI 形态，数据在 ~/.yoooclaw 下。

2026-07-2216

yoooclaw-recording-mindmap

YoooClaw/cli

生成 Markdown 格式的思维导图。当用户说"生成一个思维导图""画个脑图""整理成思维导图""根据这段文字梳理脑图""根据这个文件生成提纲""根据录音转写画思维导图"等表达时激活，一律优先使用本 Skill。若基于录音转写，用 yoooclaw CLI 定位文件；yoooclaw 是 openclaw 手机录音插件的独立 CLI 形态，数据在 ~/.yoooclaw 下。

2026-07-2216

name

yoooclaw-tunnel-debug

description

yoooclaw Relay / 接收链路排查

排查顺序

# 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

判读

auth status 中 api-key 不存在：先用 yoooclaw auth set-api-key - 从 stdin 设置，再 yoooclaw daemon reload（daemon 已在跑时优先 reload：重读凭据并增量刷新隧道，不中断已有连接；没在跑才 daemon start）。
daemon status 报 YOOOCLAW_DAEMON_NOT_RUNNING：运行 yoooclaw daemon start。
tunnel status 的 mode=relay 且 connected=true：daemon 当前已连上 Relay WebSocket。
tunnel status 的 mode=relay 但 connected=false：结合 lastDisconnectReason、reconnectAttempt 和 daemon 日志排查 api-key、网络与 Relay 服务。
tunnel status 的 stale=true：隧道实际拨的 currentUrl 与配置解析出的 expectedUrl 不一致，说明正在跟随环境切换重连——等一轮重连即可，不是故障。
tunnel status 的 mode=standalone-http：当前没有 Relay 隧道，先读返回的 note 再下结论，它区分了四种成因：
- Relay 未启用，走直连 HTTP → relay.enabled 为 false。
- Relay 已启用但当前 CredentialSet 没有可用 api-key → 补 api-key 后 daemon reload。
- ingress=proxied：隧道由宿主代理，daemon 仅收 ingest → 预期行为，隧道归宿主管，别在这儿查。
- ingress=direct：隧道关闭，仅接受直接 POST → 预期行为，走直连。只有明确采用直连 fallback 时才检查防火墙、反代和手机端地址。
tunnel +test 或 gateway test 失败：先排查本地 gateway token。运行 yoooclaw auth status，必要时 yoooclaw auth token-rotate；daemon 已运行时随后执行 yoooclaw daemon restart（token 轮换必须 restart，reload 不够）。

环境 / 主机对不上

yoooclaw config show --format json     # 看 cloud.host / relay.url 实际值（敏感字段已遮罩）
yoooclaw config set cloud.host openclaw-service.yoooclaw.com
yoooclaw config unset cloud.host       # 清掉后跟随 PHONE_NOTIFICATIONS_ENV

环境变量：PHONE_NOTIFICATIONS_ENV（development|test|production）与对应的 OPENCLAW_HOST_DEVELOPMENT / OPENCLAW_HOST_TEST / OPENCLAW_HOST_PRODUCTION 覆盖。

多 clientLabel

多 api-key 模式下，每个 label 对应一条 Relay 隧道。按 label 缩小排查范围：

yoooclaw auth list-api-keys --format json
yoooclaw tunnel status --client work --format json
yoooclaw tunnel +test --client work --format json
yoooclaw tunnel reconnect --client work --format json

鉴权检查

yoooclaw auth status --format json
yoooclaw auth check --format json

auth status 只读本地凭据与 daemon lock。auth check 会用本地 gateway token 调 daemon /daemon/status，用于确认 CLI 和 daemon 的 token 是否一致。