ClawPilot

简体中文

English

简体中文

English

Appearance

ClawPilot Link 连接教程 ​

如果你希望手机上的 ClawPilot 直接连到自己电脑里的 OpenClaw，最省心的方式就是使用 ClawPilot Link。 公网直连请看：启用公网直连

在运行 OpenClaw 的那台电脑上打开终端，执行：

bash
npm install -g @clawpilot-app/link

这一步做完后，你的电脑里会多出一个 clawlink 命令。

要注意：

  • 这一步只是安装工具。
  • 它还不会自动帮你完成配对。

如果安装时因为权限报错，可以先检查自己当前使用的 Node.js / npm 安装方式，再重新执行。大多数情况下，先把 Node.js 正确安装好就能解决。

第二步：生成配对二维码 ​

安装完成后，在同一台电脑的终端里执行：

bash
clawlink pair

正常情况下，终端会出现一个二维码。

这个二维码就是给手机上的 ClawPilot App 扫描用的。

如果这一步成功了，先不要关闭终端窗口，直接继续下一步。

第三步：在手机里扫码连接 ​

打开 ClawPilot App，然后进入：

  1. OpenClaw 服务器列表
  2. 点击添加
  3. 选择 扫描 ClawPilot Link
  4. 点击 扫码连接

然后把手机摄像头对准电脑终端里的二维码。

识别成功后，App 会自动完成这些事：

  • 把这台电脑添加成一个可用的 OpenClaw 服务器
  • 保存连接凭据
  • 开始尝试连接

大多数情况下，你不需要再手动填写服务器地址或 Token。

第四步：看到连接成功后就可以正常使用 ​

第一次配对成功后，后面日常使用通常会简单很多：

  • 电脑上的 Link 已经在后台运行时，直接打开 ClawPilot App 就行。
  • 如果你重启了电脑，或者之前手动停止过 Link，再执行一次 clawlink start。

常用命令如下：

bash
clawlink pair
clawlink start
clawlink status
clawlink doctor
clawlink restart
clawlink stop

你可以把它理解成三层兜底，App 会尽量走更直接的路径：

  1. 先试局域网直连
  2. 局域网不通时，再试公网直连
  3. 前两种都不通时，自动回退到 Relay 中继

日常使用里，最常见的是这两种情况：

  • 你在家里，手机和运行 Link 的电脑连着同一个局域网。 这种情况下，通常会优先走局域网，速度更直接，也不需要绕远路。
  • 你出门在外，手机已经不在家里的网络里了。 这时 App 会先看看这台电脑有没有可用的公网入口；如果有，就尽量直连；如果没有，或者连不上，就自动改走 Relay。

你不需要手动切换。

比如你原本在外面用 Relay，回到家后手机重新连上家里的 Wi-Fi，App 下次重连时还是会优先看看局域网能不能直接连上；如果能，就自动改走局域网。

启用公网直连 ​

如果你想要尽可能提升连接速度，就需要做公网直连配置。

先说结论 ​

最关键的一步只有一件事：

  • 把外部访问的 52378 端口，转发到运行 ClawPilot Link 的那台电脑的 52378 端口

如果你家里的网络本身有可用的 IPv6，情况会有一点不一样：

  • IPv4 场景里，最常见的问题是没有真正可从外网访问的公网地址，所以通常要做端口转发
  • IPv6 场景里，很多时候不会卡在运营商 NAT 或 CGNAT 这一层，因为设备本身就可能拿到可从外部访问的地址
  • 但这不代表只要有 IPv6 就一定能连上，因为路由器、防火墙、宽带环境、手机当前网络，仍然都可能把连接拦住

你可以把它简单理解成：

  • IPv4 更像是“先想办法把外部请求带进家里”
  • IPv6 更像是“地址本身可能已经能被外部找到，但还要看整条链路是否真的放行”

你需要做的事 ​

一般来说，至少要确认下面 4 件事：

  1. ClawPilot Link 运行在你准备映射出去的那台电脑上
  2. 路由器已经把 52378 转发到那台电脑
  3. 这台电脑在家里网络中的地址尽量固定，不要经常变化
  4. 路由器和系统防火墙没有把这条连接拦住

如果你想同时理解 IPv4 和 IPv6，可以这样看：

  • 对 IPv4 来说，上面的端口转发通常是重点
  • 对 IPv6 来说，更关键的是确认家里宽带、路由器、运行 Link 的电脑，以及你手机当前所在网络，都真的支持可用的 IPv6
  • 有些路由器默认会把入站 IPv6 挡掉，这种情况下，就算看起来已经有 IPv6，公网直连也还是不会成功

如果你要配 IPv4 ​

大多数家庭网络里，IPv4 公网直连通常按这个顺序处理：

  1. 先让运行 ClawPilot Link 的那台电脑，尽量固定在同一个局域网地址
  2. 打开路由器后台，找到端口转发、虚拟服务器、NAT 转发之类的页面
  3. 新建一条规则：
    • 协议：TCP
    • 外部端口：52378
    • 内部端口：52378
    • 内部地址：运行 ClawPilot Link 的那台电脑的局域网 IPv4
  4. 检查这台电脑自己的系统防火墙，确认没有拦住 52378

如果你不知道那台电脑当前的局域网 IPv4 是多少，最简单的方法通常是去路由器的设备列表里看，或者直接在电脑上查看当前网络信息。

如果你要配 IPv6 ​

IPv6 往往不需要像 IPv4 那样再做一条传统的端口转发，但通常要确认下面几件事：

  1. 家里的宽带和路由器已经真的启用了 IPv6
  2. 运行 ClawPilot Link 的那台电脑，拿到了可用的 IPv6 地址
  3. 路由器没有把这台电脑的入站 IPv6 连接拦掉
  4. 电脑自己的系统防火墙，也没有把 52378 挡住

很多路由器里，IPv6 相关设置不叫端口转发，而是：

  • IPv6 防火墙
  • 入站规则
  • 允许外部访问
  • 允许某个端口进入局域网设备

如果你的路由器有类似选项，通常需要放行到运行 ClawPilot Link 的那台电脑的 52378/TCP。

你可以把它理解成：

  • IPv4 常见做法是“把端口转发进去”
  • IPv6 常见做法是“把原本会被挡住的入站连接放行”

为什么配好了还是可能不通 ​

就算你已经做了端口转发，也不代表公网一定能连进来。

常见原因有这些：

  • 家庭宽带本身没有真正可从外网访问的 IPv4
  • 网络被运营商 NAT、CGNAT、上级路由或防火墙拦住
  • 看起来有 IPv6，但手机当前网络、宽带环境或路由器设置并没有真正打通
  • 路由器已经放行了 IPv4，但没有放行对应的 IPv6 入站规则
  • 你的手机当前网络只支持 IPv4，或者 IPv6 质量不稳定，导致直连还是会失败

你应该怎么理解这一步 ​

  • 端口转发是公网直连的前提，不是成功保证
  • 如果最终还是直连不上，很多时候问题出在网络环境本身，不一定是你前面的步骤做错了

日常最常用的几个命令 ​

已经配对过，但后台服务现在没运行时，用这个命令重新启动。

典型场景：

  • 电脑刚刚重启
  • 你之前手动停过 Link
  • 你想重新拉起后台服务

这是最推荐先看的状态命令。

它会告诉你：

  • 当前安装的 Link 版本
  • 后台有没有在运行
  • OpenClaw 有没有被找到
  • 现在 App 大概会通过什么方式连接

如果你只想先判断“到底有没有连上”，优先运行它。

当你感觉“不知道哪里没配对”“就是连不上”时，用这个命令最合适。

它会做更完整的检查，并给出更直接的修复建议。

如果你想升级到最新版，可以执行：

bash
npm install -g @clawpilot-app/link@latest
clawlink restart

第一条命令负责更新安装包，第二条命令负责让后台服务用上新版本。

连不上时先按这个顺序排查 ​

如果手机还是连不上，不要一上来就重装。先按下面顺序排查，通常更快：

  1. 在电脑终端里运行 clawlink status
  2. 如果还是看不懂，再运行 clawlink doctor
  3. 确认 OpenClaw 本身在这台电脑上是可用的
  4. 如果你刚升级过 Link，补执行一次 clawlink restart
  5. 如果二维码已经过期，就重新执行 clawlink pair 再扫一次

一句话总结 ​

第一次接入时，你只需要记住这两条命令：

bash
npm install -g @clawpilot-app/link
clawlink pair

安装，出码，扫码，基本就够了。

核对日期：2026-04-12

Last updated:

ClawPilot

Copyright © 2026 ClawPilot