‹ 首页

node-connect

@qianleigood · 收录于 昨天 · 上游提交 1 个月前

Use when CrawClaw Android, iOS, or macOS companion apps cannot pair or connect through QR codes, setup codes, LAN, tailnet, public URL, bootstrap token, or auth routes.

场景连接异常配对失败

适合你，如果 CrawClaw 配套应用无法通过常规方式连接

/ 下载安装
https://github.com/qianleigood/crawclaw/tree/main/skills/node-connect ↗
/ 通过 npx 安装 校验哈希
npx oh-my-skill add qianleigood/crawclaw/node-connect
/ 通过 bash 安装
curl -fsSL https://oh-my-skill.com/install.sh | bash -s -- qianleigood/crawclaw/node-connect
/ 已经装过?验证本机副本,不用重装
npx oh-my-skill verify qianleigood/crawclaw/node-connect
安装目标可用 --agent / --scope 或 --to 明确指定;省略时只会在唯一已存在的 agent 目录上自动选择,零命中或多命中会停止并提示。content_hash 缺失或不一致均拒装。
30GitHub stars
~414上下文体积 · 单文件
索引托管

怎么用

商店整理自技能原文 · 版本 f27e175 · 表述以原文为准
它做什么

当 CrawClaw 客户端无法配对或连接时，Claude 会分析配置和网络拓扑，找出问题根因并给出具体修复步骤。

什么时候触发

当 CrawClaw 安卓、iOS 或 macOS 客户端无法通过二维码、设置码、局域网等方式配对或连接时触发。

装好后可以这样说
Claude 会查看配置并诊断路由问题。
Claude 会检查令牌和认证模式。
Claude 会建议修改绑定配置。
技能原文 SKILL.md作者撰写 · MIT · f27e175

Node Connect

Find the one real route from node to gateway, verify CrawClaw is advertising that route, then fix pairing or auth.

Topology first

Decide which case applies before proposing fixes:

  • same machine or emulator
  • same LAN
  • same Tailscale tailnet
  • public URL or reverse proxy

Do not mix routes.

Canonical checks
crawclaw config get gateway.mode
crawclaw config get gateway.bind
crawclaw config get gateway.tailscale.mode
crawclaw config get gateway.remote.url
crawclaw config get gateway.auth.mode
crawclaw config get gateway.auth.allowTailscale
crawclaw config get plugins.entries.device-pair.config.publicUrl
crawclaw qr --json
crawclaw devices list
crawclaw nodes status

If remote mode is involved:

crawclaw qr --remote --json

If Tailscale is involved:

tailscale status --json
Read the result, not guesses

crawclaw qr --json tells you:

  • gatewayUrl: the endpoint the app should use
  • urlSource: which config path produced that URL
Root-cause map
  • Gateway is only bound to loopback: remote nodes cannot connect yet.
  • gateway.bind=tailnet set, but no tailnet IP was found: the gateway host is not actually on Tailscale.
  • qr --remote requires gateway.remote.url: remote-mode config is incomplete.
  • pairing required: network route worked; approve the pending device.
  • bootstrap token invalid or expired: generate a fresh setup code and retry.
  • unauthorized: wrong token/password or wrong Tailscale auth expectation.
Fix style

Reply with one concrete diagnosis and one route. If the setup is still unclear, ask for the intended route and the exact app error text instead of guessing.

按 MIT 许可原样转载,未经改动 · 在 GitHub 查看 →

评论

登录即可评论;带「已验证安装」的,是发布者名下有本店的安装或持有记录。
…