@invago/mixin 1.0.8 → 1.0.9

package/README.md

@@ -65,12 +65,19 @@ Edit your `openclaw.json` file manually and add both the channel configuration a
   "channels": {
     "mixin": {
       "enabled": true,
+      "defaultAccount": "default",
       "appId": "YOUR_APP_ID",
       "sessionId": "YOUR_SESSION_ID",
       "serverPublicKey": "YOUR_SERVER_PUBLIC_KEY_BASE64",
       "sessionPrivateKey": "YOUR_SESSION_PRIVATE_KEY_BASE64",
       "dmPolicy": "pairing",
       "allowFrom": ["AUTHORIZED_USER_UUID"],
+      "requireMentionInGroup": true,
+      "mediaBypassMentionInGroup": true,
+      "mediaMaxMb": 30,
+      "audioSendAsVoiceByDefault": true,
+      "audioAutoDetectDuration": true,
+      "audioRequireFfprobe": false,
       "proxy": {
         "enabled": true,
         "url": "socks5://127.0.0.1:10808",
@@ -141,13 +148,26 @@ Use `per-account-channel-peer` instead if you run multiple Mixin accounts and wa
 | Parameter | Required | Default | Description |
 |-----------|----------|---------|-------------|
 | `enabled` | No | `true` | Enable or disable this channel account |
+| `defaultAccount` | No | `default` | Default account ID used when `accounts` is configured |
 | `appId` | Yes | - | Mixin App UUID |
 | `sessionId` | Yes | - | Session UUID |
 | `serverPublicKey` | Yes | - | Server Public Key (Base64) |
 | `sessionPrivateKey` | Yes | - | Session Private Key (Ed25519 Base64) |
 | `dmPolicy` | No | `pairing` | Direct-message policy: `pairing`, `allowlist`, `open`, or `disabled` |
 | `allowFrom` | No | `[]` | Authorized user UUID whitelist |
+| `groupPolicy` | No | OpenClaw default | Group-message policy: `open`, `allowlist`, or `disabled` |
+| `groupAllowFrom` | No | `[]` | Authorized sender UUID whitelist for group messages when `groupPolicy` uses allowlisting |
 | `requireMentionInGroup` | No | `true` | Require trigger words in group chats |
+| `mediaBypassMentionInGroup` | No | `true` | Allow inbound group file/audio messages through even without trigger text |
+| `mediaMaxMb` | No | `30` | Max inbound and outbound media size in MB |
+| `audioSendAsVoiceByDefault` | No | `true` | Send OpenClaw native outbound audio as Mixin voice when possible |
+| `audioAutoDetectDuration` | No | `true` | Detect native outbound audio duration with `ffprobe` before sending voice |
+| `audioRequireFfprobe` | No | `false` | Fail native outbound audio instead of falling back to file when duration detection is unavailable |
+| `conversations.<conversationId>.enabled` | No | `true` | Enable or disable a specific group conversation |
+| `conversations.<conversationId>.requireMention` | No | Inherit account | Override group trigger-word requirement for a specific conversation |
+| `conversations.<conversationId>.allowFrom` | No | Inherit account | Override group sender allowlist for a specific conversation |
+| `conversations.<conversationId>.mediaBypassMention` | No | Inherit account | Override whether file/audio messages bypass mention filtering |
+| `conversations.<conversationId>.groupPolicy` | No | Inherit account | Override group policy for a specific conversation |
 | `debug` | No | `false` | Debug mode |
 | `proxy.enabled` | No | `false` | Enable per-plugin proxy |
 | `proxy.url` | Required when enabled | - | Proxy URL such as `http://127.0.0.1:7890` or `socks5://127.0.0.1:10808` |
@@ -160,6 +180,38 @@ Use `per-account-channel-peer` instead if you run multiple Mixin accounts and wa
 - Supported proxy URL styles depend on the underlying proxy agent stack; typical values are `http://...`, `https://...`, and `socks5://...`.
 - You must provide your own proxy software or proxy server. The plugin only consumes a proxy, it does not create one.
 
+## Group Access Control
+
+Mixin now supports formal group access controls in addition to direct-message `dmPolicy`.
+
+- `groupPolicy: "open"` allows any sender in a group conversation.
+- `groupPolicy: "allowlist"` requires the sender UUID to appear in `groupAllowFrom`.
+- `groupPolicy: "disabled"` blocks the entire conversation.
+- `conversations.<conversationId>` overrides account-level group settings for that single conversation.
+
+Example:
+
+```json
+{
+  "channels": {
+    "mixin": {
+      "groupPolicy": "allowlist",
+      "groupAllowFrom": ["USER_A_UUID"],
+      "conversations": {
+        "70000000-0000-0000-0000-000000000001": {
+          "requireMention": false,
+          "allowFrom": ["USER_B_UUID"],
+          "mediaBypassMention": false
+        },
+        "70000000-0000-0000-0000-000000000002": {
+          "enabled": false
+        }
+      }
+    }
+  }
+}
+```
+
 ## Usage
 
 - Direct message: `/status` or `Hello`
@@ -181,6 +233,18 @@ Plugin-specific command:
 - Send `/mixin-outbox` to inspect the current pending queue size, next retry time, and latest error.
 - Send `/mixin-outbox purge-invalid` to remove old `APP_CARD` / `APP_BUTTON_GROUP` entries that are stuck on permanent invalid-field errors.
 
+Companion onboarding CLI:
+
+- This repository also includes a companion CLI at [tools/mixin-plugin-onboard/README.md](/E:/AI/mixin-claw/tools/mixin-plugin-onboard/README.md).
+- It is bundled into the same npm package, `@invago/mixin`.
+- It currently provides `info`, `doctor`, `install`, and `update` commands for local OpenClaw + Mixin plugin maintenance.
+- Local examples:
+  - `node --import jiti/register.js tools/mixin-plugin-onboard/src/index.ts info`
+  - `node --import jiti/register.js tools/mixin-plugin-onboard/src/index.ts doctor`
+- Installed package examples:
+  - `npx -y @invago/mixin info`
+  - `npx -y @invago/mixin doctor`
+
 ## Delivery and Retry Behavior
 
 - Outbound messages are persisted to a local outbox before send attempts.
@@ -193,13 +257,14 @@ Plugin-specific command:
 Current media behavior is split into outbound and inbound support:
 
 - OpenClaw native outbound media is enabled through the channel `sendMedia` path.
+- OpenClaw native `sendPayload` now uses the same Mixin outbound planner as buffered agent replies, so text/post/buttons/card/file/audio selection is consistent.
 - The plugin sends outbound audio as `PLAIN_AUDIO` when it can resolve the media as audio and detect duration.
 - If audio duration cannot be detected, the plugin falls back to regular file attachment sending.
 - Non-audio outbound media is sent as Mixin file attachments.
 - If OpenClaw sends both caption text and media, the plugin sends the text first and then the file.
 - Voice-bubble style outbound audio is currently intended for the explicit `mixin-audio` template path.
 - Inbound `PLAIN_DATA` and `PLAIN_AUDIO` messages are downloaded, saved locally, and attached to the OpenClaw inbound context through `MediaPath` / `MediaType`.
-- Group attachment messages are allowed through even when `requireMentionInGroup` is enabled.
+- Group attachment messages are allowed through even when `requireMentionInGroup` is enabled, unless `mediaBypassMentionInGroup` is set to `false`.
 
 Current limits:
 
@@ -297,6 +362,7 @@ Rules:
 - `mixin-file` and `mixin-audio` also accept JSON only.
 - `mixin-audio` requires `duration` in seconds. `waveForm` is optional.
 - `mixin-file` and `mixin-audio` require absolute local file paths on the machine where OpenClaw runs.
+- Invalid explicit `mixin-*` templates are no longer dropped silently; the plugin now sends a visible `Mixin template error: ...` message instead.
 - Button and card links must use `http://` or `https://`.
 - Mixin clients may require your target domains to be present in the bot app's `Resource Patterns` allowlist.
 

package/README.zh-CN.md

@@ -66,12 +66,19 @@ openclaw plugins install .
   "channels": {
     "mixin": {
       "enabled": true,
+      "defaultAccount": "default",
       "appId": "你的 App ID",
       "sessionId": "你的 Session ID",
       "serverPublicKey": "服务端公钥 Base64",
       "sessionPrivateKey": "会话私钥 Base64",
       "dmPolicy": "pairing",
       "allowFrom": ["授权用户 UUID"],
+      "requireMentionInGroup": true,
+      "mediaBypassMentionInGroup": true,
+      "mediaMaxMb": 30,
+      "audioSendAsVoiceByDefault": true,
+      "audioAutoDetectDuration": true,
+      "audioRequireFfprobe": false,
       "proxy": {
         "enabled": true,
         "url": "socks5://127.0.0.1:10808",
@@ -142,13 +149,26 @@ Mixin 群聊本身会按频道隔离，但私聊会话是否独立，取决于 O
 | 参数 | 必填 | 默认值 | 说明 |
 |------|------|--------|------|
 | `enabled` | 否 | `true` | 是否启用该频道账号 |
+| `defaultAccount` | 否 | `default` | 配置了 `accounts` 时默认使用的账号 ID |
 | `appId` | 是 | - | Mixin 应用 UUID |
 | `sessionId` | 是 | - | 会话 UUID |
 | `serverPublicKey` | 是 | - | 服务端公钥 Base64 |
 | `sessionPrivateKey` | 是 | - | 会话私钥 Ed25519 Base64 |
 | `dmPolicy` | 否 | `pairing` | 私聊策略：`pairing`、`allowlist`、`open`、`disabled` |
 | `allowFrom` | 否 | `[]` | 授权用户 UUID 白名单 |
+| `groupPolicy` | 否 | 跟随 OpenClaw 默认值 | 群消息策略：`open`、`allowlist`、`disabled` |
+| `groupAllowFrom` | 否 | `[]` | 当 `groupPolicy` 走 allowlist 时，允许触发群消息的发送者 UUID 白名单 |
 | `requireMentionInGroup` | 否 | `true` | 群聊是否要求触发词 |
+| `mediaBypassMentionInGroup` | 否 | `true` | 群里的文件/语音消息是否可绕过文本触发词过滤 |
+| `mediaMaxMb` | 否 | `30` | 入站和出站媒体大小上限，单位 MB |
+| `audioSendAsVoiceByDefault` | 否 | `true` | OpenClaw 原生音频出站时尽量按 Mixin 语音发送 |
+| `audioAutoDetectDuration` | 否 | `true` | 发送原生音频前是否用 `ffprobe` 自动探测时长 |
+| `audioRequireFfprobe` | 否 | `false` | 时长探测不可用时是否直接失败，而不是降级为文件发送 |
+| `conversations.<conversationId>.enabled` | 否 | `true` | 是否启用某个指定群会话 |
+| `conversations.<conversationId>.requireMention` | 否 | 继承账号级配置 | 覆盖该群会话的触发词要求 |
+| `conversations.<conversationId>.allowFrom` | 否 | 继承账号级配置 | 覆盖该群会话的发送者白名单 |
+| `conversations.<conversationId>.mediaBypassMention` | 否 | 继承账号级配置 | 覆盖该群会话中文件/语音是否绕过触发词过滤 |
+| `conversations.<conversationId>.groupPolicy` | 否 | 继承账号级配置 | 覆盖该群会话的群消息策略 |
 | `debug` | 否 | `false` | 调试模式 |
 | `proxy.enabled` | 否 | `false` | 是否启用插件级代理 |
 | `proxy.url` | 启用时必填 | - | 代理地址，例如 `http://127.0.0.1:7890` 或 `socks5://127.0.0.1:10808` |
@@ -161,6 +181,38 @@ Mixin 群聊本身会按频道隔离，但私聊会话是否独立，取决于 O
 - 常见代理地址格式包括 `http://...`、`https://...`、`socks5://...`。
 - 代理软件或代理服务器需要你自己提供，插件只负责使用代理。
 
+## 群聊访问控制
+
+现在除了私聊 `dmPolicy`，Mixin 也支持正式的群聊访问控制：
+
+- `groupPolicy: "open"` 表示群里任何发送者都可以触发。
+- `groupPolicy: "allowlist"` 表示只有 `groupAllowFrom` 里的发送者 UUID 可以触发。
+- `groupPolicy: "disabled"` 表示整个群会话被禁用。
+- `conversations.<conversationId>` 可以对某一个群会话覆盖账号级配置。
+
+示例：
+
+```json
+{
+  "channels": {
+    "mixin": {
+      "groupPolicy": "allowlist",
+      "groupAllowFrom": ["USER_A_UUID"],
+      "conversations": {
+        "70000000-0000-0000-0000-000000000001": {
+          "requireMention": false,
+          "allowFrom": ["USER_B_UUID"],
+          "mediaBypassMention": false
+        },
+        "70000000-0000-0000-0000-000000000002": {
+          "enabled": false
+        }
+      }
+    }
+  }
+}
+```
+
 ## 使用方式
 
 - 私聊：`/status` 或 `你好`
@@ -182,6 +234,18 @@ openclaw status
 - 发送 `/mixin-outbox` 可查看当前待发队列数量、下次重试时间和最近错误。
 - 发送 `/mixin-outbox purge-invalid` 可删除历史遗留的 `APP_CARD` / `APP_BUTTON_GROUP` 永久无效重试项。
 
+配套运维 CLI：
+
+- 仓库里已经附带了一套配套工具，见 [tools/mixin-plugin-onboard/README.md](/E:/AI/mixin-claw/tools/mixin-plugin-onboard/README.md)。
+- 这套工具会和主包 `@invago/mixin` 一起发布，不再是单独第二个 npm 包。
+- 当前提供 `info`、`doctor`、`install`、`update` 四个命令，用于本地 OpenClaw + Mixin 插件的安装和诊断。
+- 本地运行示例：
+  - `node --import jiti/register.js tools/mixin-plugin-onboard/src/index.ts info`
+  - `node --import jiti/register.js tools/mixin-plugin-onboard/src/index.ts doctor`
+- 安装后使用示例：
+  - `npx -y @invago/mixin info`
+  - `npx -y @invago/mixin doctor`
+
 ## 投递与重试行为
 
 - 回复消息会先写入本地 outbox，再由后台 worker 发送。
@@ -194,13 +258,14 @@ openclaw status
 当前媒体能力分为发送侧和接收侧：
 
 - OpenClaw 原生媒体发送已经接入频道 `sendMedia`。
+- OpenClaw 原生 `sendPayload` 现在也会复用同一套 Mixin 出站 planner，所以文本、长文、按钮、卡片、文件、语音的选择逻辑和 agent 缓冲回复保持一致。
 - 当插件能把媒体识别为音频并成功拿到时长时，会优先按 `PLAIN_AUDIO` 发送。
 - 如果拿不到音频时长，会平稳降级为普通文件附件发送。
 - 非音频媒体会按 Mixin 文件附件发送。
 - 如果 OpenClaw 同时给出文本和媒体，插件会先发文本，再发文件。
 - 语音气泡式发送目前仍更适合走显式 `mixin-audio` 模板。
 - 入站 `PLAIN_DATA` 和 `PLAIN_AUDIO` 会被下载到本地，并通过 `MediaPath` / `MediaType` 挂到 OpenClaw 入站上下文。
-- 即使启用了 `requireMentionInGroup`，群里的附件消息也不会再因为缺少文本触发词被直接过滤。
+- 即使启用了 `requireMentionInGroup`，群里的附件消息也不会再因为缺少文本触发词被直接过滤；如果你把 `mediaBypassMentionInGroup` 设为 `false`，则会恢复和普通文本相同的群聊触发规则。
 
 当前边界：
 
@@ -298,6 +363,7 @@ openclaw status
 - `mixin-file` 和 `mixin-audio` 也只接受 JSON。
 - `mixin-file` 和 `mixin-audio` 里的 `filePath` 必须是 OpenClaw 所在机器上的绝对路径。
 - `mixin-audio` 里的 `duration` 必填，单位为秒，`waveForm` 可选。
+- 如果显式 `mixin-*` 模板写错，插件不再静默跳过，而会直接发出可见的 `Mixin template error: ...` 文本提示。
 - 按钮和卡片链接必须使用 `http://` 或 `https://`。
 - Mixin 客户端可能要求目标域名已加入机器人应用的 `Resource Patterns` 白名单。
 

package/package.json

@@ -1 +1 @@
-{"name":"@invago/mixin","version":"1.0.8","description":"Mixin Messenger channel plugin for OpenClaw","type":"module","main":"index.ts","scripts":{"dev":"nodemon --exec \"node --import jiti/register index.ts\" --ext ts","lint":"eslint src/**/*.ts index.ts","typecheck":"tsc --noEmit"},"peerDependencies":{"openclaw":">=2026.2.0"},"dependencies":{"@mixin.dev/mixin-node-sdk":"^7.4.1","@noble/curves":"^2.0.1","@noble/hashes":"^2.0.1","axios":"^1.6.0","express":"^5.2.1","proxy-agent":"^6.5.0","ws":"^8.18.3","zod":"^4.3.6"},"devDependencies":{"@eslint/js":"^10.0.1","@types/node":"^20.0.0","eslint":"^10.0.3","globals":"^17.4.0","jiti":"^1.21.0","nodemon":"^3.0.0","typescript":"^5.3.0","typescript-eslint":"^8.56.1"},"keywords":["openclaw","mixin","messenger","plugin","channel"],"author":"invagao","license":"MIT","repository":{"type":"git","url":"git+https://github.com/invago/mixinclaw.git"},"openclaw":{"extensions":["./index.ts"],"channel":{"id":"mixin","label":"Mixin Messenger","selectionLabel":"Mixin Messenger (Blaze WebSocket)","docsPath":"/channels/mixin","order":70,"aliases":["mixin-messenger","mixin"],"quickstartAllowFrom":true},"install":{"npmSpec":"@invago/mixin","localPath":"extensions/mixin"}}}
+{"name":"@invago/mixin","version":"1.0.9","description":"Mixin Messenger channel plugin for OpenClaw","type":"module","main":"index.ts","bin":{"mixin-plugin-onboard":"tools/mixin-plugin-onboard/bin/mixin-plugin-onboard.mjs"},"scripts":{"dev":"nodemon --exec \"node --import jiti/register index.ts\" --ext ts","lint":"eslint src/**/*.ts index.ts","typecheck":"tsc --noEmit","tool:info":"node --import jiti/register.js tools/mixin-plugin-onboard/src/index.ts info","tool:doctor":"node --import jiti/register.js tools/mixin-plugin-onboard/src/index.ts doctor"},"peerDependencies":{"openclaw":">=2026.2.0"},"dependencies":{"@mixin.dev/mixin-node-sdk":"^7.4.1","@noble/curves":"^2.0.1","@noble/hashes":"^2.0.1","axios":"^1.6.0","express":"^5.2.1","jiti":"^1.21.0","proxy-agent":"^6.5.0","ws":"^8.18.3","zod":"^4.3.6"},"devDependencies":{"@eslint/js":"^10.0.1","@types/node":"^20.0.0","eslint":"^10.0.3","globals":"^17.4.0","nodemon":"^3.0.0","typescript":"^5.3.0","typescript-eslint":"^8.56.1"},"keywords":["openclaw","mixin","messenger","plugin","channel"],"author":"invagao","license":"MIT","repository":{"type":"git","url":"git+https://github.com/invago/mixinclaw.git"},"openclaw":{"extensions":["./index.ts"],"channel":{"id":"mixin","label":"Mixin Messenger","selectionLabel":"Mixin Messenger (Blaze WebSocket)","docsPath":"/channels/mixin","order":70,"aliases":["mixin-messenger","mixin"],"quickstartAllowFrom":true},"install":{"npmSpec":"@invago/mixin","localPath":"extensions/mixin"}}}

package/src/channel.ts

@@ -1,13 +1,20 @@
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
-import { buildChannelConfigSchema, formatPairingApproveHint } from "openclaw/plugin-sdk";
+import {
+  buildChannelConfigSchema,
+  createDefaultChannelRuntimeState,
+  formatPairingApproveHint,
+  resolveChannelMediaMaxBytes,
+} from "openclaw/plugin-sdk";
 import type { ChannelGatewayContext, OpenClawConfig, ReplyPayload } from "openclaw/plugin-sdk";
 import { runBlazeLoop } from "./blaze-service.js";
 import { MixinConfigSchema } from "./config-schema.js";
-import { describeAccount, isConfigured, listAccountIds, resolveAccount } from "./config.js";
+import { describeAccount, isConfigured, listAccountIds, resolveAccount, resolveDefaultAccountId, resolveMediaMaxMb } from "./config.js";
 import { handleMixinMessage, type MixinInboundMessage } from "./inbound-handler.js";
+import { buildMixinOutboundPlanFromReplyPayload, executeMixinOutboundPlan } from "./outbound-plan.js";
 import { getMixinRuntime } from "./runtime.js";
-import { sendAudioMessage, sendFileMessage, sendTextMessage, startSendWorker } from "./send-service.js";
+import { getOutboxStatus, sendAudioMessage, sendFileMessage, sendTextMessage, startSendWorker } from "./send-service.js";
+import { buildMixinAccountSnapshot, buildMixinChannelSummary, resolveMixinStatusSnapshot } from "./status.js";
 
 type ResolvedMixinAccount = ReturnType<typeof resolveAccount>;
 
@@ -53,11 +60,12 @@ async function resolveAudioDurationSeconds(filePath: string): Promise<number | n
   }
 }
 
-function resolvePayloadMediaUrls(payload: ReplyPayload): string[] {
-  if (payload.mediaUrls && payload.mediaUrls.length > 0) {
-    return payload.mediaUrls;
-  }
-  return payload.mediaUrl ? [payload.mediaUrl] : [];
+function resolveMixinMediaMaxBytes(cfg: OpenClawConfig, accountId?: string | null): number {
+  return resolveChannelMediaMaxBytes({
+    cfg,
+    resolveChannelLimitMb: ({ cfg, accountId }) => resolveMediaMaxMb(cfg, accountId),
+    accountId,
+  }) ?? MEDIA_MAX_BYTES;
 }
 
 async function deliverOutboundMixinPayload(params: {
@@ -68,33 +76,28 @@ async function deliverOutboundMixinPayload(params: {
   mediaLocalRoots?: readonly string[];
   accountId?: string | null;
 }): Promise<{ channel: "mixin"; messageId: string }> {
-  const accountId = params.accountId ?? "default";
-  let lastMessageId = params.to;
-
-  if (params.text?.trim()) {
-    const textResult = await sendTextMessage(params.cfg, accountId, params.to, undefined, params.text);
-    if (!textResult.ok) {
-      throw new Error(textResult.error ?? "mixin outbound text send failed");
-    }
-    lastMessageId = textResult.messageId ?? lastMessageId;
-  }
-
+  const accountId = params.accountId ?? resolveDefaultAccountId(params.cfg);
+  const account = resolveAccount(params.cfg, accountId);
+  const mediaMaxBytes = resolveMixinMediaMaxBytes(params.cfg, accountId);
   const runtime = getMixinRuntime();
-  for (const mediaUrl of params.mediaUrls ?? []) {
+
+  const sendMediaUrl = async (mediaUrl: string): Promise<string | undefined> => {
     const loaded = await runtime.media.loadWebMedia(mediaUrl, {
-      maxBytes: MEDIA_MAX_BYTES,
+      maxBytes: mediaMaxBytes,
       localRoots: params.mediaLocalRoots,
     });
     const saved = await runtime.channel.media.saveMediaBuffer(
       loaded.buffer,
       loaded.contentType,
       "mixin",
-      MEDIA_MAX_BYTES,
+      mediaMaxBytes,
       loaded.fileName,
     );
 
-    if (loaded.kind === "audio") {
-      const duration = await resolveAudioDurationSeconds(saved.path);
+    if (loaded.kind === "audio" && account.config.audioSendAsVoiceByDefault !== false) {
+      const duration = account.config.audioAutoDetectDuration === false
+        ? null
+        : await resolveAudioDurationSeconds(saved.path);
       if (duration !== null) {
         const audioResult = await sendAudioMessage(
           params.cfg,
@@ -110,8 +113,10 @@ async function deliverOutboundMixinPayload(params: {
         if (!audioResult.ok) {
           throw new Error(audioResult.error ?? "mixin outbound audio send failed");
         }
-        lastMessageId = audioResult.messageId ?? lastMessageId;
-        continue;
+        return audioResult.messageId;
+      }
+      if (account.config.audioRequireFfprobe) {
+        throw new Error("ffprobe is required to send mediaUrl audio as Mixin voice");
       }
     }
 
@@ -129,10 +134,27 @@ async function deliverOutboundMixinPayload(params: {
     if (!fileResult.ok) {
       throw new Error(fileResult.error ?? "mixin outbound file send failed");
     }
-    lastMessageId = fileResult.messageId ?? lastMessageId;
+    return fileResult.messageId;
+  };
+
+  const payloadPlan = buildMixinOutboundPlanFromReplyPayload({
+    text: params.text,
+    mediaUrl: params.mediaUrls?.[0],
+    mediaUrls: params.mediaUrls,
+  } as ReplyPayload);
+  for (const warning of payloadPlan.warnings) {
+    console.warn(`[mixin] outbound plan warning: ${warning}`);
   }
 
-  return { channel: "mixin", messageId: lastMessageId };
+  const lastMessageId = await executeMixinOutboundPlan({
+    cfg: params.cfg,
+    accountId,
+    conversationId: params.to,
+    steps: payloadPlan.steps,
+    sendMediaUrl,
+  });
+
+  return { channel: "mixin", messageId: lastMessageId ?? params.to };
 }
 
 export const mixinPlugin = {
@@ -162,7 +184,7 @@ export const mixinPlugin = {
     listAccountIds,
     resolveAccount: (cfg: OpenClawConfig, accountId?: string | null) =>
       resolveAccount(cfg, accountId ?? undefined),
-    defaultAccountId: () => "default",
+    defaultAccountId: (cfg: OpenClawConfig) => resolveDefaultAccountId(cfg),
   },
 
   pairing: {
@@ -192,6 +214,7 @@ export const mixinPlugin = {
 
   outbound: {
     deliveryMode: "direct" as const,
+    textChunkLimit: 4000,
     sendPayload: async (ctx: {
       cfg: OpenClawConfig;
       to: string;
@@ -203,7 +226,11 @@ export const mixinPlugin = {
         cfg: ctx.cfg,
         to: ctx.to,
         text: ctx.payload.text,
-        mediaUrls: resolvePayloadMediaUrls(ctx.payload),
+        mediaUrls: ctx.payload.mediaUrls && ctx.payload.mediaUrls.length > 0
+          ? ctx.payload.mediaUrls
+          : ctx.payload.mediaUrl
+            ? [ctx.payload.mediaUrl]
+            : [],
         mediaLocalRoots: ctx.mediaLocalRoots,
         accountId: ctx.accountId,
       }),
@@ -214,7 +241,7 @@ export const mixinPlugin = {
       text: string;
       accountId?: string | null;
     }) => {
-      const id = ctx.accountId ?? "default";
+      const id = ctx.accountId ?? resolveDefaultAccountId(ctx.cfg);
       const result = await sendTextMessage(ctx.cfg, id, ctx.to, undefined, ctx.text);
       if (result.ok) {
         return { channel: "mixin", messageId: result.messageId ?? ctx.to };
@@ -251,6 +278,12 @@ export const mixinPlugin = {
       const config = account.config;
 
       await startSendWorker(cfg, log);
+      const outboxStatus = await getOutboxStatus().catch(() => null);
+      const statusSnapshot = resolveMixinStatusSnapshot(cfg, accountId, outboxStatus);
+      ctx.setStatus({
+        accountId,
+        ...statusSnapshot,
+      });
 
       let stopped = false;
       const stop = () => {
@@ -340,10 +373,43 @@ export const mixinPlugin = {
   },
 
   status: {
-    defaultRuntime: {
-      accountId: "default",
-      running: false,
-      status: "stopped" as const,
+    defaultRuntime: createDefaultChannelRuntimeState("default"),
+    buildChannelSummary: (params: {
+      snapshot: {
+        configured?: boolean | null;
+        running?: boolean | null;
+        lastStartAt?: number | null;
+        lastStopAt?: number | null;
+        lastError?: string | null;
+        defaultAccountId?: string | null;
+        outboxDir?: string | null;
+        outboxFile?: string | null;
+        outboxPending?: number | null;
+        mediaMaxMb?: number | null;
+      };
+    }) => buildMixinChannelSummary({ snapshot: params.snapshot }),
+    buildAccountSnapshot: (params: {
+      account: ResolvedMixinAccount;
+      runtime?: {
+        running?: boolean | null;
+        lastStartAt?: number | null;
+        lastStopAt?: number | null;
+        lastError?: string | null;
+        lastInboundAt?: number | null;
+        lastOutboundAt?: number | null;
+      } | null;
+      probe?: unknown;
+      cfg: OpenClawConfig;
+    }) => {
+      const { account, runtime, probe, cfg } = params;
+      const statusSnapshot = resolveMixinStatusSnapshot(cfg, account.accountId);
+      return buildMixinAccountSnapshot({
+        account,
+        runtime,
+        probe,
+        defaultAccountId: statusSnapshot.defaultAccountId,
+        outboxPending: statusSnapshot.outboxPending,
+      });
     },
   },
 };

package/src/config-schema.ts

@@ -1,4 +1,4 @@
-import { DmPolicySchema } from "openclaw/plugin-sdk";
+import { DmPolicySchema, GroupPolicySchema } from "openclaw/plugin-sdk";
 import { z } from "zod";
 
 export const MixinProxyConfigSchema = z.object({
@@ -22,6 +22,16 @@ export const MixinProxyConfigSchema = z.object({
 
 export type MixinProxyConfig = z.infer<typeof MixinProxyConfigSchema>;
 
+export const MixinConversationConfigSchema = z.object({
+  enabled: z.boolean().optional(),
+  requireMention: z.boolean().optional(),
+  allowFrom: z.array(z.string()).optional(),
+  mediaBypassMention: z.boolean().optional(),
+  groupPolicy: GroupPolicySchema.optional(),
+});
+
+export type MixinConversationConfig = z.infer<typeof MixinConversationConfigSchema>;
+
 export const MixinAccountConfigSchema = z.object({
   name: z.string().optional(),
   enabled: z.boolean().optional().default(true),
@@ -31,7 +41,15 @@ export const MixinAccountConfigSchema = z.object({
   sessionPrivateKey: z.string().optional(),
   dmPolicy: DmPolicySchema.optional().default("pairing"),
   allowFrom: z.array(z.string()).optional().default([]),
+  groupPolicy: GroupPolicySchema.optional(),
+  groupAllowFrom: z.array(z.string()).optional(),
   requireMentionInGroup: z.boolean().optional().default(true),
+  mediaBypassMentionInGroup: z.boolean().optional().default(true),
+  mediaMaxMb: z.number().positive().optional(),
+  audioAutoDetectDuration: z.boolean().optional().default(true),
+  audioSendAsVoiceByDefault: z.boolean().optional().default(true),
+  audioRequireFfprobe: z.boolean().optional().default(false),
+  conversations: z.record(z.string(), MixinConversationConfigSchema.optional()).optional(),
   debug: z.boolean().optional().default(false),
   proxy: MixinProxyConfigSchema.optional(),
 });
@@ -39,6 +57,7 @@ export const MixinAccountConfigSchema = z.object({
 export type MixinAccountConfig = z.infer<typeof MixinAccountConfigSchema>;
 
 export const MixinConfigSchema: z.ZodTypeAny = MixinAccountConfigSchema.extend({
+  defaultAccount: z.string().optional(),
   accounts: z.record(z.string(), MixinAccountConfigSchema.optional()).optional(),
 });