@honor-claw/yoyo 2026.7.1-alpha.3 → 2026.7.1-alpha.4

package/dist/capabilities/admin/impl.mjs

@@ -82,6 +82,25 @@ var r = t("capabilities"), i = null, a = class {
 			};
 		}
 	}
+	async restart(t) {
+		let n = this.manager.getClient();
+		if (!n) return {
+			ok: !1,
+			error: "Admin gateway client not ready"
+		};
+		try {
+			return await n.restartGateway(t), r.info("plugin restart command dispatched via admin RPC", { reason: t }), {
+				ok: !0,
+				data: { dispatched: !0 }
+			};
+		} catch (t) {
+			let n = e(t);
+			return r.error("gateway restart RPC failed", t), {
+				ok: !1,
+				error: `gateway restart failed: ${n}`
+			};
+		}
+	}
 };
 function o() {
 	return i === null && (i = new a()), i;

package/dist/capabilities/routing/index.mjs

@@ -1,3 +1,4 @@
 import "./route.mjs";
 import "./list.mjs";
 import "./model-switch.mjs";
+import "./restart.mjs";

package/dist/capabilities/routing/restart.mjs

@@ -0,0 +1,17 @@
+import { clawLogger as e } from "../../utils/claw-logger.mjs";
+import { useAdminCapability as t } from "../admin/impl.mjs";
+import "../admin/index.mjs";
+//#region src/capabilities/routing/restart.ts
+var n = e("routing");
+async function r(e) {
+	let r = await t().restart(e);
+	return n.info("plugin restart command dispatched", {
+		ok: r.ok,
+		reason: e
+	}), r.ok ? { ok: !0 } : {
+		ok: !1,
+		error: r.error
+	};
+}
+//#endregion
+export { r as restartGateway };

package/dist/gateway/client/admin.mjs

@@ -37,6 +37,9 @@ var r = {
 	async devicePairApprove(e) {
 		return this.sendRequest("device.pair.approve", { requestId: e });
 	}
+	async restartGateway(e) {
+		return this.sendRequest("gateway.restart.request", { reason: e });
+	}
 };
 //#endregion
 export { i as default };

package/dist/modules/configs/plugin-init.mjs

@@ -11,7 +11,8 @@ import { detectProvidersToRename as l, updateProviderReferences as u } from "./p
 var d = r("configs"), f = [
 	"nodes_status",
 	"node_invoke",
-	"cloud_invoke"
+	"cloud_invoke",
+	"yoyo_plugin_restart"
 ];
 async function p(e) {
 	try {

package/dist/tools/index.mjs

@@ -4,9 +4,11 @@ import { nodeInvokeTool as t } from "./node-invoke/tool.mjs";
 import "./node-invoke/index.mjs";
 import { nodesStatusTool as n } from "./nodes-status/tool.mjs";
 import "./nodes-status/index.mjs";
+import { pluginRestartTool as r } from "./plugin-restart/tool.mjs";
+import "./plugin-restart/index.mjs";
 //#region src/tools/index.ts
-function r(r) {
-	r.registerTool(n), r.registerTool(t), r.registerTool(e);
+function i(i) {
+	i.registerTool(n), i.registerTool(t), i.registerTool(e), i.registerTool(r);
 }
 //#endregion
-export { r as registerTools };
+export { i as registerTools };

package/dist/tools/plugin-restart/index.mjs

@@ -0,0 +1 @@
+import "./tool.mjs";

package/dist/tools/plugin-restart/tool.mjs

@@ -0,0 +1,44 @@
+import { toErrorMessage as e } from "../../utils/error.mjs";
+import { clawLogger as t } from "../../utils/claw-logger.mjs";
+import { restartGateway as n } from "../../capabilities/routing/restart.mjs";
+import "../../capabilities/routing/index.mjs";
+import { Type as r } from "typebox";
+//#region src/tools/plugin-restart/tool.ts
+var i = t("tool"), a = {
+	name: "yoyo_plugin_restart",
+	label: "YOYO Plugin Restart",
+	description: "重启 openclaw 网关。插件升级场景下使用：调用后网关会断连重启。",
+	parameters: r.Object({ reason: r.Optional(r.String({ description: "重启原因" })) }),
+	async execute(e, t) {
+		let n = await o(e, t);
+		return {
+			content: [{
+				type: "text",
+				text: JSON.stringify(n)
+			}],
+			details: n
+		};
+	}
+};
+async function o(t, r) {
+	try {
+		let e = await n(r.reason);
+		return e.ok ? {
+			ok: !0,
+			result: { message: "restart command dispatched." }
+		} : (i.warn("plugin restart command failed", {
+			toolCallId: t,
+			error: e.error
+		}), {
+			ok: !1,
+			errorMessage: e.error ?? "plugin restart command failed; please manually restart the gateway"
+		});
+	} catch (n) {
+		return i.error("plugin restart command threw unexpectedly", n, { toolCallId: t }), {
+			ok: !1,
+			errorMessage: e(n)
+		};
+	}
+}
+//#endregion
+export { a as pluginRestartTool };

package/openclaw.plugin.json

@@ -7,7 +7,7 @@
     "onStartup": true
   },
   "contracts": {
-    "tools": ["nodes_status", "node_invoke", "cloud_invoke"]
+    "tools": ["nodes_status", "node_invoke", "cloud_invoke", "yoyo_plugin_restart"]
   },
   "configSchema": {
     "type": "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@honor-claw/yoyo",
-  "version": "2026.7.1-alpha.3",
+  "version": "2026.7.1-alpha.4",
   "description": "OpenClaw Honor Yoyo connection plugin",
   "keywords": [
     "ai",

package/skills/yoyo-update/SKILL.md

@@ -55,10 +55,10 @@ metadata: { "openclaw": { "emoji": "🔄", "always": true } }
 
 正在执行升级流程：
 
-1. 正在下载插件
+正在下载插件
 状态：正在下载插件，请耐心等待...
 
-2. 正在更新插件
+正在更新插件
 状态：正在安装并配置新版本插件，请勿中断操作
 
 ## 步骤 4：执行更新
@@ -90,19 +90,44 @@ metadata: { "openclaw": { "emoji": "🔄", "always": true } }
 
 说明：本次实际升级到 v{实际版本}，高于预检查获取的目标版本 v{目标版本}。
 
-## 步骤 6：执行安全重启
+## 步骤 6：根据网关运行模式重启
 
-插件更新完成后，必须主动执行网关安全重启（安装插件不再自动触发网关重启）。
+插件更新完成后，需要重启网关让插件生效（安装插件不再自动触发网关重启）。重启方式取决于当前网关的运行模式，必须先探测再分流。
 
-- 执行命令：`openclaw gateway restart --safe`
-- **`--safe` 参数不可省略**，不得执行裸 `openclaw gateway restart`、`openclaw gateway stop` / `start` 或任何其它重启方式。
-- 重启会断开当前长连接，属于预期行为；执行前无需等待，执行后继续步骤 7。
-- 命令执行失败时，不要改用其它重启方式，输出 `插件已更新完成，但网关安全重启失败，请在 OpenClaw 设备上手动重启网关生效插件`，停止。
+### 6.1 探测网关运行模式
+
+执行 `openclaw gateway status --json`，解析输出判断网关是 daemon 托管还是前台手动运行：
+
+- daemon（计划任务/schtasks 托管）的判定信号，二者需同时满足：
+  1. `port.listeners[].commandLine` 中被加载的脚本是 `dist/index.js`。
+  2. `service.runtime.detail` 不含 "even though schtasks did not report a running task" 或类似的 schtasks 没生效的说明。
+- 前台手动运行的判定信号，满足其一即可：
+  1. `port.listeners[].commandLine` 中被加载的脚本是 `openclaw.mjs`，命令为 `gateway` 或 `gateway run`（无 `--port`）。
+  2. `service.runtime.detail` 含 "even though schtasks did not report a running task" 或类似的 schtasks 没生效的说明。
+- 注意：不要用外层 `node.exe` 的路径区分（daemon 和前台都可能是同一 node 路径），要以被加载脚本（`dist/index.js` vs `openclaw.mjs`）和是否带 `--port` 为准。
+- `openclaw gateway status --json` 命令失败或无法解析运行模式时，按前台运行处理（走 6.3 提示手动重启），不要尝试任何自动重启方式。
+
+### 6.2 daemon 网关：调用 yoyo_plugin_restart 工具重启
+
+- 直接调用 `yoyo_plugin_restart` 工具触发网关重启。
+- **不得向用户输出任何关于网关运行模式（如“当前是 daemon 模式”之类）的内部判断信息**，6.1 的探测结果仅供本步骤分流使用，对用户不可见。直接调用工具并进入步骤 7。
+- 不得执行 `openclaw gateway restart/stop/start` 或任何其它重启命令。
+- 重启是“下发即结束”：工具返回即视为重启已触发，**不要轮询网关状态、不要等待网关重新就绪、不要探测重连结果**。调用后直接进入步骤 7。
+- 工具返回 `ok: true`：直接进入步骤 7。
+- 工具返回 `ok: false`：不要改用其它重启方式，输出 `插件已更新完成，但网关重启失败，请在 OpenClaw 设备上手动重启网关生效新版本插件`，停止。不得向用户输出工具返回的原始 `errorMessage` 或内部判断信息。
+
+### 6.3 前台运行的网关：提示手动重启
+
+前台网关由用户自己起的进程托管，无法通过工具或命令自动重启。输出以下文案并停止（不输出步骤 7 的完成文案）：
+
+插件已更新完成，请手动重启 OpenClaw 网关让新版本插件生效。
+
+（前台运行的网关无法控制自动重启，请在启动网关的终端停止当前网关并重新启动。）
 
 ## 步骤 7：输出完成结果
 
-输出阶段 3 文案：
+输出完成文案：
 
-3. 插件更新完成
+插件更新完成
 Claw 插件更新已完成
-网关已重启，连接即将断开，稍等片刻后恢复...
+网关重启已下发，连接即将断开，断开后稍等片刻后会恢复...