@coclaw/openclaw-coclaw 0.26.0 → 0.26.2

package/index.js

@@ -208,10 +208,10 @@ const plugin = {
 		// 防"写配置触发重启"时的反复重启）。升级补了新模型靠这条让老用户重启后自动同步。
 		// config-mutation 字面量 specifier 必须出现在本入口源码里（loader 只扫入口识别 jiti alias）。
 		const portalSyncP = import('openclaw/plugin-sdk/config-mutation')
-			.then(({ mutateConfigFile }) => reconcilePortalModels({ getConfig: getClawConfig, mutateConfigFile }))
-			.then((r) => { if (r.changed) logger.info?.('[coclaw] minimax-portal model list synced from plugin catalog'); })
+			.then(({ mutateConfigFile }) => reconcilePortalModels({ getConfig: getClawConfig, mutateConfigFile, logger, remoteLog }))
 			.catch((err) => {
 				logger.warn?.(`[coclaw] minimax-portal model reconcile failed: ${String(err?.message ?? err)}`);
+				remoteLog(`providerAuth.portalReconcile.failed reason=${String(err?.message ?? err)}`);
 			});
 		__pluginInitDone = Promise.all([topicLoadP, chatHistoryLoadP, portalSyncP]);
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coclaw/openclaw-coclaw",
-  "version": "0.26.0",
+  "version": "0.26.2",
   "type": "module",
   "license": "Apache-2.0",
   "description": "OpenClaw plugin for remote chat over WebRTC. Run `openclaw coclaw enroll` after install.",
@@ -71,6 +71,14 @@
     "werift": "^0.19.0",
     "ws": "^8.19.0"
   },
+  "peerDependencies": {
+    "openclaw": ">=2026.3.22"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "c8": "^10.1.3",
     "eslint": "^9.39.2"

package/src/provider-auth/portal-model-catalog.js

@@ -15,15 +15,18 @@
  *   返回的 proper-case，name 用展示名。
  * - 只维护**最必须的运行元数据**：`reasoning`（是否推理模型——缺省会被当成 false，导致推理
  *   模型被按普通模型处理、思考模式出错）、`contextWindow`、`maxTokens`。**不写 `cost`**：
- *   portal 走 token plan、不按量计费，价格无意义；`input` 也不写（系统默认即 `['text']`）。
+ *   portal 走 token plan、不按量计费，价格无意义；`input` 默认不写（系统默认即 `['text']`），
+ *   除非该型号多模态（如 M3 支持 `['text', 'image']`）才显式写出。
  *   这几个值与上游 `model-definitions.ts`（DEFAULT_MINIMAX_CONTEXT_WINDOW=204800 /
- *   DEFAULT_MINIMAX_MAX_TOKENS=131072）+ `provider-models.ts`（reasoning 标记）对齐。
+ *   MINIMAX_M3_CONTEXT_WINDOW=1_000_000 / DEFAULT_MINIMAX_MAX_TOKENS=131072）+
+ *   `provider-models.ts`（reasoning / input 标记）对齐。
  */
 
 export const PORTAL_MODEL_CATALOG = {
-	// 与 openclaw-repo/extensions/minimax/ 的 provider-models.ts(reasoning) +
-	// model-definitions.ts(contextWindow/maxTokens) 对齐
+	// 与 openclaw-repo/extensions/minimax/ 的 provider-models.ts(reasoning/input) +
+	// model-definitions.ts(contextWindow/maxTokens) 对齐；M3 起为上游默认型号、放首位
 	'minimax-portal': [
+		{ id: 'MiniMax-M3', name: 'MiniMax M3', reasoning: true, input: ['text', 'image'], contextWindow: 1000000, maxTokens: 131072 },
 		{ id: 'MiniMax-M2.7', name: 'MiniMax M2.7', reasoning: true, contextWindow: 204800, maxTokens: 131072 },
 		{ id: 'MiniMax-M2.7-highspeed', name: 'MiniMax M2.7 Highspeed', reasoning: true, contextWindow: 204800, maxTokens: 131072 },
 	],
@@ -31,15 +34,16 @@ export const PORTAL_MODEL_CATALOG = {
 
 /**
  * 取某 provider 的静态清单。返回**深拷贝**，避免调用方改到共享常量。
- * 未知 provider → 空数组。条目字段为扁平基本类型，`{ ...m }` 即为完整深拷贝。
+ * 未知 provider → 空数组。用 `structuredClone` 而非 `{ ...m }`：条目含嵌套字段（如 M3 的
+ * `input` 数组），浅拷贝会让返回值与共享常量复用同一个数组引用，调用方 push/splice 即污染原表。
  *
  * @param {string} providerId
- * @returns {{id:string, name:string, reasoning?:boolean, contextWindow?:number, maxTokens?:number}[]}
+ * @returns {{id:string, name:string, reasoning?:boolean, input?:string[], contextWindow?:number, maxTokens?:number}[]}
  */
 export function getPortalModels(providerId) {
 	const list = PORTAL_MODEL_CATALOG[providerId];
 	if (!Array.isArray(list)) return [];
-	return list.map((m) => ({ ...m }));
+	return list.map((m) => structuredClone(m));
 }
 
 /**

package/src/provider-auth/reconcile.js

@@ -21,25 +21,35 @@ import { getPortalModels, portalModelsCoveredById } from './portal-model-catalog
  * @param {Function} opts.getConfig - () → 当前 cfg 快照（getClawConfig）；null/缺时跳过
  * @param {Function} opts.mutateConfigFile - openclaw/plugin-sdk/config-mutation 的写盘入口
  * @param {string} [opts.providerId] - 默认 minimax-portal
+ * @param {object} [opts.logger] - gateway 注入的 pino 风格 logger（本地诊断）
+ * @param {Function} [opts.remoteLog] - remoteLog(text)（远程诊断；启动一次、低频）
  * @returns {Promise<{changed:boolean, reason:string}>} reason: no-config|not-bound|no-catalog|in-sync|updated
  */
-export async function reconcilePortalModels({ getConfig, mutateConfigFile, providerId = PORTAL_PROVIDER_ID }) {
+export async function reconcilePortalModels({ getConfig, mutateConfigFile, providerId = PORTAL_PROVIDER_ID, logger, remoteLog }) {
 	const cfg = getConfig?.();
-	// runtime 未注入 / config 不可读：跳过，下次启动再对
+	// runtime 未注入 / config 不可读：跳过，下次启动再对（非事件，不记诊断）
 	if (!cfg || typeof cfg !== 'object') return { changed: false, reason: 'no-config' };
 	const node = cfg.models?.providers?.[providerId];
-	// 未绑定（无 provider 节点）→ 不碰。登录成功时已写过节点 + 清单，绑定后才谈得上对账
+	// 未绑定（无 provider 节点）→ 不碰。登录成功时已写过节点 + 清单，绑定后才谈得上对账。
+	// 同属非事件（未用该 provider 的网关每次启动都会到这）→ 不记诊断，避免刷屏
 	if (!node || typeof node !== 'object' || Array.isArray(node)) return { changed: false, reason: 'not-bound' };
+	// 到这里 provider 已绑定，"模型清单是否需要注入"才成立——后续每个结果都记诊断（本地 log + remoteLog）。
+	// remoteLog 一次启动一条、低频，符合约定。
 	const target = getPortalModels(providerId);
+	const finish = (changed, reason, count) => {
+		logger?.info?.(`[coclaw] ${providerId} model reconcile: ${changed ? 'synced' : 'no write'} (reason=${reason}, models=${count})`);
+		remoteLog?.(`providerAuth.portalReconcile reason=${reason} changed=${changed} provider=${providerId} models=${count}`);
+		return { changed, reason };
+	};
 	// 表里没这个 provider（理论不该发生）→ 不动用户已有清单
-	if (target.length === 0) return { changed: false, reason: 'no-catalog' };
+	if (target.length === 0) return finish(false, 'no-catalog', 0);
 	// 只按 id 判"已覆盖"：目标里每个 model id 都已在配置现有清单出现 → 视为已同步、零写入。
 	// 比"全等"宽容——配置是我们的超集（别的来源，如官方 MiniMax 插件，多写了几个模型）时也判已覆盖、
 	// 不去动它，避免和它来回覆盖、反复重启。仅当配置缺了我们某个 id（升级新增模型 / 老配置不全）才写。
 	// 顺带说清读/写不对称：getConfig 读「解析后」配置（config.current()），mutateConfigFile 默认写
 	// 「源」配置。即便上游将来在解析期给第三方 portal 注入额外模型，那也只是让配置成超集、我们的 id 仍在
 	// → 判已覆盖 → 不写，不会触发"永远判不一致、每次启动都写"的循环。
-	if (portalModelsCoveredById(node.models, target)) return { changed: false, reason: 'in-sync' };
+	if (portalModelsCoveredById(node.models, target)) return finish(false, 'in-sync', target.length);
 
 	await mutateConfigFile({
 		afterWrite: { mode: 'auto' },
@@ -50,5 +60,5 @@ export async function reconcilePortalModels({ getConfig, mutateConfigFile, provi
 			p.models = getPortalModels(providerId);
 		},
 	});
-	return { changed: true, reason: 'updated' };
+	return finish(true, 'updated', target.length);
 }