{"id":100,"date":"2026-03-21T22:47:17","date_gmt":"2026-03-21T14:47:17","guid":{"rendered":"https:\/\/pa.yingzhi8.cn\/index.php\/2026\/03\/21\/concepts-presence\/"},"modified":"2026-03-21T23:08:56","modified_gmt":"2026-03-21T15:08:56","slug":"concepts-presence","status":"publish","type":"post","link":"https:\/\/pa.yingzhi8.cn\/index.php\/2026\/03\/21\/concepts-presence\/","title":{"rendered":"\u5728\u7ebf\u72b6\u6001"},"content":{"rendered":"<h1>\u5728\u7ebf\u72b6\u6001<\/h1>\n<p>OpenClaw&#8221;\u5728\u7ebf\u72b6\u6001&#8221;\u662f\u4ee5\u4e0b\u5185\u5bb9\u7684\u8f7b\u91cf\u7ea7\u3001\u5c3d\u529b\u800c\u4e3a\u7684\u89c6\u56fe\uff1a<\/p>\n<ul>\n<li><strong>Gateway \u7f51\u5173<\/strong>\u672c\u8eab\uff0c\u4ee5\u53ca<\/li>\n<li><strong>\u8fde\u63a5\u5230 Gateway \u7f51\u5173\u7684\u5ba2\u6237\u7aef<\/strong>\uff08mac \u5e94\u7528\u3001WebChat\u3001CLI \u7b49\uff09<\/li>\n<\/ul>\n<p>\u5728\u7ebf\u72b6\u6001\u4e3b\u8981\u7528\u4e8e\u6e32\u67d3 macOS \u5e94\u7528\u7684<strong>\u5b9e\u4f8b<\/strong>\u6807\u7b7e\u9875\uff0c\u5e76\u4e3a\u8fd0\u7ef4\u4eba\u5458\u63d0\u4f9b\u5feb\u901f\u53ef\u89c1\u6027\u3002<\/p>\n<h2>\u5728\u7ebf\u72b6\u6001\u5b57\u6bb5\uff08\u663e\u793a\u7684\u5185\u5bb9\uff09<\/h2>\n<p>\u5728\u7ebf\u72b6\u6001\u6761\u76ee\u662f\u5177\u6709\u4ee5\u4e0b\u5b57\u6bb5\u7684\u7ed3\u6784\u5316\u5bf9\u8c61\uff1a<\/p>\n<ul>\n<li><code>instanceId<\/code>\uff08\u53ef\u9009\u4f46\u5f3a\u70c8\u63a8\u8350\uff09\uff1a\u7a33\u5b9a\u7684\u5ba2\u6237\u7aef\u8eab\u4efd\uff08\u901a\u5e38\u662f <code>connect.client.instanceId<\/code>\uff09<\/li>\n<li><code>host<\/code>\uff1a\u4eba\u7c7b\u53cb\u597d\u7684\u4e3b\u673a\u540d<\/li>\n<li><code>ip<\/code>\uff1a\u5c3d\u529b\u800c\u4e3a\u7684 IP \u5730\u5740<\/li>\n<li><code>version<\/code>\uff1a\u5ba2\u6237\u7aef\u7248\u672c\u5b57\u7b26\u4e32<\/li>\n<li><code>deviceFamily<\/code> \/ <code>modelIdentifier<\/code>\uff1a\u786c\u4ef6\u63d0\u793a<\/li>\n<li><code>mode<\/code>\uff1a<code>ui<\/code>\u3001<code>webchat<\/code>\u3001<code>cli<\/code>\u3001<code>backend<\/code>\u3001<code>probe<\/code>\u3001<code>test<\/code>\u3001<code>node<\/code>\uff0c&#8230;<\/li>\n<li><code>lastInputSeconds<\/code>\uff1a&#8221;\u81ea\u4e0a\u6b21\u7528\u6237\u8f93\u5165\u4ee5\u6765\u7684\u79d2\u6570&#8221;\uff08\u5982\u679c\u5df2\u77e5\uff09<\/li>\n<li><code>reason<\/code>\uff1a<code>self<\/code>\u3001<code>connect<\/code>\u3001<code>node-connected<\/code>\u3001<code>periodic<\/code>\uff0c&#8230;<\/li>\n<li><code>ts<\/code>\uff1a\u6700\u540e\u66f4\u65b0\u65f6\u95f4\u6233\uff08\u81ea\u7eaa\u5143\u4ee5\u6765\u7684\u6beb\u79d2\u6570\uff09<\/li>\n<\/ul>\n<h2>\u751f\u4ea7\u8005\uff08\u5728\u7ebf\u72b6\u6001\u6765\u6e90\uff09<\/h2>\n<p>\u5728\u7ebf\u72b6\u6001\u6761\u76ee\u7531\u591a\u4e2a\u6765\u6e90\u751f\u6210\u5e76<strong>\u5408\u5e76<\/strong>\u3002<\/p>\n<h3>1\uff09Gateway \u7f51\u5173\u81ea\u8eab\u6761\u76ee<\/h3>\n<p>Gateway \u7f51\u5173\u59cb\u7ec8\u5728\u542f\u52a8\u65f6\u690d\u5165\u4e00\u4e2a&#8221;self&#8221;\u6761\u76ee\uff0c\u8fd9\u6837\u5373\u4f7f\u5728\u4efb\u4f55\u5ba2\u6237\u7aef\u8fde\u63a5\u4e4b\u524d\uff0cUI \u4e5f\u80fd\u663e\u793a Gateway \u7f51\u5173\u4e3b\u673a\u3002<\/p>\n<h3>2\uff09WebSocket \u8fde\u63a5<\/h3>\n<p>\u6bcf\u4e2a WS \u5ba2\u6237\u7aef\u90fd\u4ee5 <code>connect<\/code> \u8bf7\u6c42\u5f00\u59cb\u3002\u5728\u6210\u529f\u63e1\u624b\u540e\uff0cGateway \u7f51\u5173\u4e3a\u8be5\u8fde\u63a5\u66f4\u65b0\u63d2\u5165\u4e00\u4e2a\u5728\u7ebf\u72b6\u6001\u6761\u76ee\u3002<\/p>\n<h4>\u4e3a\u4ec0\u4e48\u4e00\u6b21\u6027 CLI \u547d\u4ee4\u4e0d\u4f1a\u663e\u793a<\/h4>\n<p>CLI \u7ecf\u5e38\u4e3a\u77ed\u6682\u7684\u4e00\u6b21\u6027\u547d\u4ee4\u8fdb\u884c\u8fde\u63a5\u3002\u4e3a\u907f\u514d\u5b9e\u4f8b\u5217\u8868\u88ab\u5237\u5c4f\uff0c<code>client.mode === \"cli\"<\/code> <strong>\u4e0d\u4f1a<\/strong>\u88ab\u8f6c\u6362\u4e3a\u5728\u7ebf\u72b6\u6001\u6761\u76ee\u3002<\/p>\n<h3>3\uff09<code>system-event<\/code> \u4fe1\u6807<\/h3>\n<p>\u5ba2\u6237\u7aef\u53ef\u4ee5\u901a\u8fc7 <code>system-event<\/code> \u65b9\u6cd5\u53d1\u9001\u66f4\u4e30\u5bcc\u7684\u5468\u671f\u6027\u4fe1\u6807\u3002mac \u5e94\u7528\u4f7f\u7528\u6b64\u65b9\u6cd5\u62a5\u544a\u4e3b\u673a\u540d\u3001IP \u548c <code>lastInputSeconds<\/code>\u3002<\/p>\n<h3>4\uff09\u8282\u70b9\u8fde\u63a5\uff08role: node\uff09<\/h3>\n<p>\u5f53\u8282\u70b9\u901a\u8fc7 Gateway \u7f51\u5173 WebSocket \u4ee5 <code>role: node<\/code> \u8fde\u63a5\u65f6\uff0cGateway \u7f51\u5173\u4e3a\u8be5\u8282\u70b9\u66f4\u65b0\u63d2\u5165\u4e00\u4e2a\u5728\u7ebf\u72b6\u6001\u6761\u76ee\uff08\u4e0e\u5176\u4ed6 WS \u5ba2\u6237\u7aef\u6d41\u7a0b\u76f8\u540c\uff09\u3002<\/p>\n<h2>\u5408\u5e76 + \u53bb\u91cd\u89c4\u5219\uff08\u4e3a\u4ec0\u4e48 <code>instanceId<\/code> \u5f88\u91cd\u8981\uff09<\/h2>\n<p>\u5728\u7ebf\u72b6\u6001\u6761\u76ee\u5b58\u50a8\u5728\u5355\u4e2a\u5185\u5b58\u6620\u5c04\u4e2d\uff1a<\/p>\n<ul>\n<li>\u6761\u76ee\u4ee5<strong>\u5728\u7ebf\u72b6\u6001\u952e<\/strong>\u4e3a\u7d22\u5f15\u3002<\/li>\n<li>\u6700\u4f73\u952e\u662f\u7a33\u5b9a\u7684 <code>instanceId<\/code>\uff08\u6765\u81ea <code>connect.client.instanceId<\/code>\uff09\uff0c\u5b83\u5728\u91cd\u542f\u540e\u4ecd\u7136\u6709\u6548\u3002<\/li>\n<li>\u952e\u4e0d\u533a\u5206\u5927\u5c0f\u5199\u3002<\/li>\n<\/ul>\n<p>\u5982\u679c\u5ba2\u6237\u7aef\u5728\u6ca1\u6709\u7a33\u5b9a <code>instanceId<\/code> \u7684\u60c5\u51b5\u4e0b\u91cd\u65b0\u8fde\u63a5\uff0c\u5b83\u53ef\u80fd\u4f1a\u663e\u793a\u4e3a<strong>\u91cd\u590d<\/strong>\u884c\u3002<\/p>\n<h2>TTL \u548c\u6709\u754c\u5927\u5c0f<\/h2>\n<p>\u5728\u7ebf\u72b6\u6001\u662f\u6709\u610f\u8bbe\u8ba1\u4e3a\u77ed\u6682\u7684\uff1a<\/p>\n<ul>\n<li><strong>TTL\uff1a<\/strong> \u8d85\u8fc7 5 \u5206\u949f\u7684\u6761\u76ee\u4f1a\u88ab\u4fee\u526a<\/li>\n<li><strong>\u6700\u5927\u6761\u76ee\u6570\uff1a<\/strong> 200\uff08\u6700\u65e7\u7684\u4f18\u5148\u5220\u9664\uff09<\/li>\n<\/ul>\n<p>\u8fd9\u4f7f\u5217\u8868\u4fdd\u6301\u65b0\u9c9c\u5e76\u907f\u514d\u65e0\u9650\u5236\u7684\u5185\u5b58\u589e\u957f\u3002<\/p>\n<h2>\u8fdc\u7a0b\/\u96a7\u9053\u6ce8\u610f\u4e8b\u9879\uff08\u56de\u73af IP\uff09<\/h2>\n<p>\u5f53\u5ba2\u6237\u7aef\u901a\u8fc7 SSH \u96a7\u9053\/\u672c\u5730\u7aef\u53e3\u8f6c\u53d1\u8fde\u63a5\u65f6\uff0cGateway \u7f51\u5173\u53ef\u80fd\u4f1a\u770b\u5230\u8fdc\u7a0b\u5730\u5740\u4e3a <code>127.0.0.1<\/code>\u3002\u4e3a\u907f\u514d\u8986\u76d6\u5ba2\u6237\u7aef\u62a5\u544a\u7684\u6709\u6548 IP\uff0c\u56de\u73af\u8fdc\u7a0b\u5730\u5740\u4f1a\u88ab\u5ffd\u7565\u3002<\/p>\n<h2>\u6d88\u8d39\u8005<\/h2>\n<h3>macOS \u5b9e\u4f8b\u6807\u7b7e\u9875<\/h3>\n<p>macOS \u5e94\u7528\u6e32\u67d3 <code>system-presence<\/code> \u7684\u8f93\u51fa\uff0c\u5e76\u6839\u636e\u6700\u540e\u66f4\u65b0\u7684\u65f6\u95f4\u5e94\u7528\u4e00\u4e2a\u5c0f\u7684\u72b6\u6001\u6307\u793a\u5668\uff08\u6d3b\u8dc3\/\u7a7a\u95f2\/\u8fc7\u671f\uff09\u3002<\/p>\n<h2>\u8c03\u8bd5\u6280\u5de7<\/h2>\n<ul>\n<li>\u8981\u67e5\u770b\u539f\u59cb\u5217\u8868\uff0c\u5bf9 Gateway \u7f51\u5173\u8c03\u7528 <code>system-presence<\/code>\u3002<\/li>\n<li>\u5982\u679c\u4f60\u770b\u5230\u91cd\u590d\u9879\uff1a<\/li>\n<li>\u786e\u8ba4\u5ba2\u6237\u7aef\u5728\u63e1\u624b\u4e2d\u53d1\u9001\u7a33\u5b9a\u7684 <code>client.instanceId<\/code><\/li>\n<li>\u786e\u8ba4\u5468\u671f\u6027\u4fe1\u6807\u4f7f\u7528\u76f8\u540c\u7684 <code>instanceId<\/code><\/li>\n<li>\u68c0\u67e5\u8fde\u63a5\u6d3e\u751f\u7684\u6761\u76ee\u662f\u5426\u7f3a\u5c11 <code>instanceId<\/code>\uff08\u8fd9\u79cd\u60c5\u51b5\u4e0b\u91cd\u590d\u662f\u9884\u671f\u7684\uff09<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>\u5728\u7ebf\u72b6\u6001 OpenClaw&#8221;\u5728\u7ebf\u72b6\u6001&#8221;\u662f\u4ee5\u4e0b\u5185\u5bb9\u7684\u8f7b\u91cf\u7ea7\u3001\u5c3d\u529b\u800c\u4e3a\u7684\u89c6\u56fe\uff1a Gatew [&hellip;]<\/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-100","post","type-post","status-publish","format-standard","hentry","category-docs"],"_links":{"self":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/100","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=100"}],"version-history":[{"count":1,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/100\/revisions"}],"predecessor-version":[{"id":395,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/100\/revisions\/395"}],"wp:attachment":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/media?parent=100"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/categories?post=100"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/tags?post=100"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}