before agent dispatch and keep raw Feishu `file_key` payloads out of message

text. Fixes #67120 and #61876.

- Tasks: terminalize async Gateway agent task records from the Gateway run result while preserving aborted, failed, and cancelled outcomes instead of leaving completed runs stuck as active or lost. (#71905) Thanks @likewen-tech.

- WhatsApp: let authorized group voice-note transcripts satisfy mention gating

before reply dispatch, while keeping unmentioned transcripts in pending group

history. Fixes #44908.

- Media understanding: carry channel voice-note preflight state into attachment

selection so WhatsApp, Feishu, Telegram, and Discord do not transcribe the

same inbound audio twice. Fixes #70580.

- TTS/BlueBubbles: deliver compatible auto-TTS audio as iMessage voice memo

bubbles instead of plain MP3/CAF file attachments. Fixes #16848.

- ACP: send subagent and async-task completion wakes to external ACP harnesses as

plain prompts instead of OpenClaw internal runtime-context envelopes, while

keeping those envelopes out of ACP transcripts.

- OpenClaw talks to it through its REST API (`GET /api/v1/ping`, `POST /message/text`, `POST /chat/:id/*`).

- Incoming messages arrive via webhooks; outgoing replies, typing indicators, read receipts, and tapbacks are REST calls.

- Attachments and stickers are ingested as inbound media (and surfaced to the agent when possible).

- Auto-TTS replies that synthesize MP3 or CAF audio are delivered as iMessage

voice memo bubbles instead of plain file attachments.

- Pairing/allowlist works the same way as other channels (`/channels/pairing` etc) with `channels.bluebubbles.allowFrom` + pairing codes.

- Reactions are surfaced as system events just like Slack/Telegram so agents can "mention" them before replying.

- Advanced features: edit, unsend, reply threading, message effects, group management.

- explicit WhatsApp mentions of the bot identity

- configured mention regex patterns (`agents.list[].groupChat.mentionPatterns`, fallback `messages.groupChat.mentionPatterns`)

- inbound voice-note transcripts for authorized group messages

- implicit reply-to-bot detection (reply sender matches bot identity)

Security note:

- `<media:document>`

- `<media:sticker>`

Authorized group voice notes are transcribed before mention gating when the

body is only `<media:audio>`, so saying the bot mention in the voice note can

trigger the reply. If the transcript still does not mention the bot, the

transcript is kept in pending group history instead of the raw placeholder.

Location bodies use terse coordinate text. Location labels/comments and contact/vCard details are rendered as fenced untrusted metadata, not inline prompt text.

</Accordion>

Deepgram, ElevenLabs, Mistral, OpenAI, SenseAudio, and xAI can all transcribe

inbound audio through the batch `tools.media.audio` path when configured.

Channel plugins that preflight a voice note for mention gating or command

parsing mark the transcribed attachment on the inbound context, so the shared

media-understanding pass reuses that transcript instead of making a second STT

call for the same audio.

Deepgram, ElevenLabs, Mistral, OpenAI, and xAI also register Voice Call

streaming STT providers, so live phone audio can be forwarded to the selected

vendor without waiting for a completed recording.

},

sendMedia: async (ctx) => {

const runtime = await loadBlueBubblesChannelRuntime();

const { cfg, to, text, mediaUrl, accountId, replyToId } = ctx;

const { cfg, to, text, mediaUrl, accountId, replyToId, audioAsVoice } = ctx;

const { mediaPath, mediaBuffer, contentType, filename, caption } = ctx as {

mediaPath?: string;

mediaBuffer?: Uint8Array;

caption: caption ?? text ?? undefined,

replyToId: replyToId ?? null,

accountId: accountId ?? undefined,

asVoice: audioAsVoice === true,

});

},

},

);

expect(sendBlueBubblesAttachmentMock).toHaveBeenCalledTimes(1);

});

it("passes asVoice through to attachment delivery", async () => {

runtimeMocks.fetchRemoteMedia.mockResolvedValueOnce({

buffer: new Uint8Array([1, 2, 3]),

contentType: "audio/mpeg",

fileName: "voice.mp3",

});

await sendBlueBubblesMedia({

cfg: createConfig(),

to: "chat:123",

mediaUrl: "https://example.com/voice.mp3",

asVoice: true,

});

expect(sendBlueBubblesAttachmentMock).toHaveBeenCalledWith(

expect.objectContaining({

asVoice: true,

contentType: "audio/mpeg",

filename: "voice.mp3",

}),

);

});

});

caption: caption ?? undefined,

replyToId: replyToMessageGuid || null,

accountId: account.accountId,

asVoice: payload.audioAsVoice === true,

});

} catch (err) {

forgetPendingOutboundMessageId(pendingId);

);

expect(result).not.toBeNull();

expect(result?.isDirectMessage).toBe(true);

expect(result?.preflightAudioTranscript).toBe("hello openclaw from dm audio");

});

it("falls back to the default discord account for omitted-account dm authorization", async () => {

);

expect(result).not.toBeNull();

expect(result?.wasMentioned).toBe(true);

expect(result?.preflightAudioTranscript).toBe("hey openclaw");

});

it("does not transcribe guild audio from unauthorized members", async () => {

commandAuthorized,

baseText,

messageText,

...(preflightTranscript !== undefined ? { preflightAudioTranscript: preflightTranscript } : {}),

wasMentioned,

route: effectiveRoute,

threadBinding,

commandAuthorized: boolean;

baseText: string;

messageText: string;

preflightAudioTranscript?: string;

wasMentioned: boolean;

route: ReturnType<typeof resolveAgentRoute>;