{"id":118,"date":"2026-03-21T22:47:18","date_gmt":"2026-03-21T14:47:18","guid":{"rendered":"https:\/\/pa.yingzhi8.cn\/index.php\/2026\/03\/21\/gateway-bridge-protocol\/"},"modified":"2026-03-21T23:29:01","modified_gmt":"2026-03-21T15:29:01","slug":"gateway-bridge-protocol","status":"publish","type":"post","link":"https:\/\/pa.yingzhi8.cn\/index.php\/2026\/03\/21\/gateway-bridge-protocol\/","title":{"rendered":"Bridge \u534f\u8bae"},"content":{"rendered":"

Bridge \u534f\u8bae<\/h1>\n

Bridge \u534f\u8bae\uff08\u65e7\u7248\u8282\u70b9\u4f20\u8f93\uff09<\/h1>\n

Bridge \u534f\u8bae\u662f\u4e00\u4e2a\u65e7\u7248<\/strong>\u8282\u70b9\u4f20\u8f93\uff08TCP JSONL\uff09\u3002\u65b0\u7684\u8282\u70b9\u5ba2\u6237\u7aef\u5e94\u8be5\u4f7f\u7528\u7edf\u4e00\u7684 Gateway \u7f51\u5173 \u7f51\u5173 WebSocket \u534f\u8bae\u3002<\/p>\n

\u5982\u679c\u4f60\u6b63\u5728\u6784\u5efa\u64cd\u4f5c\u8005\u6216\u8282\u70b9\u5ba2\u6237\u7aef\uff0c\u8bf7\u4f7f\u7528 Gateway \u7f51\u5173 \u7f51\u5173\u534f\u8bae<\/a>\u3002<\/p>\n

\u6ce8\u610f\uff1a<\/strong> \u5f53\u524d\u7684 OpenClaw \u6784\u5efa\u4e0d\u518d\u5305\u542b TCP bridge \u76d1\u542c\u5668\uff1b\u672c\u6587\u6863\u4ec5\u4f5c\u5386\u53f2\u53c2\u8003\u4fdd\u7559\u3002
\n\u65e7\u7248 bridge.*<\/code> \u914d\u7f6e\u952e\u4e0d\u518d\u662f\u914d\u7f6e\u6a21\u5f0f\u7684\u4e00\u90e8\u5206\u3002<\/p>\n

\u4e3a\u4ec0\u4e48\u6211\u4eec\u6709\u4e24\u79cd\u534f\u8bae<\/h2>\n
    \n
  • \u5b89\u5168\u8fb9\u754c<\/strong>\uff1abridge \u66b4\u9732\u4e00\u4e2a\u5c0f\u7684\u5141\u8bb8\u5217\u8868\uff0c\u800c\u4e0d\u662f\u5b8c\u6574\u7684 Gateway \u7f51\u5173 \u7f51\u5173 API \u63a5\u53e3\u3002<\/li>\n
  • \u914d\u5bf9 + \u8282\u70b9\u8eab\u4efd<\/strong>\uff1a\u8282\u70b9\u51c6\u5165\u7531 Gateway \u7f51\u5173 \u7f51\u5173\u7ba1\u7406\uff0c\u5e76\u4e0e\u6bcf\u8282\u70b9\u4ee4\u724c\u7ed1\u5b9a\u3002<\/li>\n
  • \u8bbe\u5907\u53d1\u73b0\u7528\u6237\u4f53\u9a8c<\/strong>\uff1a\u8282\u70b9\u53ef\u4ee5\u901a\u8fc7\u5c40\u57df\u7f51\u4e0a\u7684 Bonjour \u53d1\u73b0 Gateway \u7f51\u5173 \u7f51\u5173\uff0c\u6216\u901a\u8fc7 tailnet \u76f4\u63a5\u8fde\u63a5\u3002<\/li>\n
  • Loopback WS<\/strong>\uff1a\u5b8c\u6574\u7684 WS \u63a7\u5236\u5e73\u9762\u4fdd\u6301\u672c\u5730\uff0c\u9664\u975e\u901a\u8fc7 SSH \u96a7\u9053\u3002<\/li>\n<\/ul>\n

    \u4f20\u8f93<\/h2>\n
      \n
    • TCP\uff0c\u6bcf\u884c\u4e00\u4e2a JSON \u5bf9\u8c61\uff08JSONL\uff09\u3002<\/li>\n
    • \u53ef\u9009 TLS\uff08\u5f53 bridge.tls.enabled<\/code> \u4e3a true \u65f6\uff09\u3002<\/li>\n
    • \u65e7\u7248\u9ed8\u8ba4\u76d1\u542c\u7aef\u53e3\u4e3a 18790<\/code>\uff08\u5f53\u524d\u6784\u5efa\u4e0d\u542f\u52a8 TCP bridge\uff09\u3002<\/li>\n<\/ul>\n

      \u5f53 TLS \u542f\u7528\u65f6\uff0c\u8bbe\u5907\u53d1\u73b0 TXT \u8bb0\u5f55\u5305\u542b bridgeTls=1<\/code> \u52a0\u4e0a bridgeTlsSha256<\/code>\uff0c\u4ee5\u4fbf\u8282\u70b9\u53ef\u4ee5\u56fa\u5b9a\u8bc1\u4e66\u3002<\/p>\n

      \u63e1\u624b + \u914d\u5bf9<\/h2>\n
        \n
      1. \u5ba2\u6237\u7aef\u53d1\u9001\u5e26\u6709\u8282\u70b9\u5143\u6570\u636e + \u4ee4\u724c\uff08\u5982\u679c\u5df2\u914d\u5bf9\uff09\u7684 hello<\/code>\u3002<\/li>\n
      2. \u5982\u679c\u672a\u914d\u5bf9\uff0cGateway \u7f51\u5173 \u7f51\u5173\u56de\u590d error<\/code>\uff08NOT_PAIRED<\/code>\/UNAUTHORIZED<\/code>\uff09\u3002<\/li>\n
      3. \u5ba2\u6237\u7aef\u53d1\u9001 pair-request<\/code>\u3002<\/li>\n
      4. Gateway \u7f51\u5173 \u7f51\u5173\u7b49\u5f85\u6279\u51c6\uff0c\u7136\u540e\u53d1\u9001 pair-ok<\/code> \u548c hello-ok<\/code>\u3002<\/li>\n<\/ol>\n

        hello-ok<\/code> \u8fd4\u56de serverName<\/code>\uff0c\u53ef\u80fd\u5305\u542b canvasHostUrl<\/code>\u3002<\/p>\n

        \u5e27<\/h2>\n

        \u5ba2\u6237\u7aef \u2192 Gateway \u7f51\u5173 \u7f51\u5173\uff1a<\/p>\n

          \n
        • req<\/code> \/ res<\/code>\uff1a\u4f5c\u7528\u57df Gateway \u7f51\u5173 \u7f51\u5173 RPC\uff08chat\u3001sessions\u3001config\u3001health\u3001voicewake\u3001skills.bins\uff09<\/li>\n
        • event<\/code>\uff1a\u8282\u70b9\u4fe1\u53f7\uff08\u8bed\u97f3\u8f6c\u5f55\u3001\u667a\u80fd\u4f53\u8bf7\u6c42\u3001\u804a\u5929\u8ba2\u9605\u3001exec \u751f\u547d\u5468\u671f\uff09<\/li>\n<\/ul>\n

          Gateway \u7f51\u5173 \u7f51\u5173 \u2192 \u5ba2\u6237\u7aef\uff1a<\/p>\n

            \n
          • invoke<\/code> \/ invoke-res<\/code>\uff1a\u8282\u70b9\u547d\u4ee4\uff08canvas.*<\/code>\u3001camera.*<\/code>\u3001screen.record<\/code>\u3001location.get<\/code>\u3001sms.send<\/code>\uff09<\/li>\n
          • event<\/code>\uff1a\u5df2\u8ba2\u9605\u4f1a\u8bdd\u7684\u804a\u5929\u66f4\u65b0<\/li>\n
          • ping<\/code> \/ pong<\/code>\uff1a\u4fdd\u6d3b<\/li>\n<\/ul>\n

            \u65e7\u7248\u5141\u8bb8\u5217\u8868\u5f3a\u5236\u6267\u884c\u4f4d\u4e8e src\/gateway\/server-bridge.ts<\/code>\uff08\u5df2\u79fb\u9664\uff09\u3002<\/p>\n

            Exec \u751f\u547d\u5468\u671f\u4e8b\u4ef6<\/h2>\n

            \u8282\u70b9\u53ef\u4ee5\u53d1\u51fa exec.finished<\/code> \u6216 exec.denied<\/code> \u4e8b\u4ef6\u6765\u8868\u9762\u5316 system.run \u6d3b\u52a8\u3002
            \n\u8fd9\u4e9b\u88ab\u6620\u5c04\u5230 Gateway \u7f51\u5173 \u7f51\u5173\u4e2d\u7684\u7cfb\u7edf\u4e8b\u4ef6\u3002\uff08\u65e7\u7248\u8282\u70b9\u53ef\u80fd\u4ecd\u4f1a\u53d1\u51fa exec.started<\/code>\u3002\uff09<\/p>\n

            Payload \u5b57\u6bb5\uff08\u9664\u975e\u6ce8\u660e\uff0c\u5426\u5219\u90fd\u662f\u53ef\u9009\u7684\uff09\uff1a<\/p>\n

              \n
            • sessionKey<\/code>\uff08\u5fc5\u9700\uff09\uff1a\u63a5\u6536\u7cfb\u7edf\u4e8b\u4ef6\u7684\u667a\u80fd\u4f53\u4f1a\u8bdd\u3002<\/li>\n
            • runId<\/code>\uff1a\u7528\u4e8e\u5206\u7ec4\u7684\u552f\u4e00 exec id\u3002<\/li>\n
            • command<\/code>\uff1a\u539f\u59cb\u6216\u683c\u5f0f\u5316\u7684\u547d\u4ee4\u5b57\u7b26\u4e32\u3002<\/li>\n
            • exitCode<\/code>\u3001timedOut<\/code>\u3001success<\/code>\u3001output<\/code>\uff1a\u5b8c\u6210\u8be6\u60c5\uff08\u4ec5\u9650 finished\uff09\u3002<\/li>\n
            • reason<\/code>\uff1a\u62d2\u7edd\u539f\u56e0\uff08\u4ec5\u9650 denied\uff09\u3002<\/li>\n<\/ul>\n

              Tailnet \u4f7f\u7528<\/h2>\n
                \n
              • \u5c06 bridge \u7ed1\u5b9a\u5230 tailnet IP\uff1a\u5728 ~\/.openclaw\/openclaw.json<\/code> \u4e2d\u8bbe\u7f6e bridge.bind: \"tailnet\"<\/code>\u3002<\/li>\n
              • \u5ba2\u6237\u7aef\u901a\u8fc7 MagicDNS \u540d\u79f0\u6216 tailnet IP \u8fde\u63a5\u3002<\/li>\n
              • Bonjour \u4e0d<\/strong>\u8de8\u7f51\u7edc\uff1b\u9700\u8981\u65f6\u4f7f\u7528\u624b\u52a8\u4e3b\u673a\/\u7aef\u53e3\u6216\u5e7f\u57df DNS\u2011SD\u3002<\/li>\n<\/ul>\n

                \u7248\u672c\u63a7\u5236<\/h2>\n

                Bridge \u76ee\u524d\u662f\u9690\u5f0f v1<\/strong>\uff08\u65e0\u6700\u5c0f\/\u6700\u5927\u534f\u5546\uff09\u3002\u9884\u671f\u5411\u540e\u517c\u5bb9\uff1b\u5728\u4efb\u4f55\u7834\u574f\u6027\u53d8\u66f4\u4e4b\u524d\u6dfb\u52a0 bridge \u534f\u8bae\u7248\u672c\u5b57\u6bb5\u3002<\/p>\n","protected":false},"excerpt":{"rendered":"

                Bridge \u534f\u8bae Bridge \u534f\u8bae\uff08\u65e7\u7248\u8282\u70b9\u4f20\u8f93\uff09 Bridge \u534f\u8bae\u662f\u4e00\u4e2a\u65e7\u7248\u8282\u70b9\u4f20\u8f93\uff08TCP JSON […]<\/p>\n","protected":false},"author":0,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[],"class_list":["post-118","post","type-post","status-publish","format-standard","hentry","category-docs"],"_links":{"self":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/118","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/types\/post"}],"replies":[{"embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/comments?post=118"}],"version-history":[{"count":2,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/118\/revisions"}],"predecessor-version":[{"id":831,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/118\/revisions\/831"}],"wp:attachment":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/media?parent=118"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/categories?post=118"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/tags?post=118"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}