惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

T
Tailwind CSS Blog
人人都是产品经理
人人都是产品经理
博客园 - 叶小钗
大猫的无限游戏
大猫的无限游戏
钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
博客园 - 【当耐特】
The Cloudflare Blog
博客园 - 聂微东
博客园 - 司徒正美
量子位
博客园 - 三生石上(FineUI控件)
OSCHINA 社区最新新闻
OSCHINA 社区最新新闻
G
Google Developers Blog
Apple Machine Learning Research
Apple Machine Learning Research
罗磊的独立博客
酷 壳 – CoolShell
酷 壳 – CoolShell
Y
Y Combinator Blog
S
SegmentFault 最新的问题
T
The Blog of Author Tim Ferriss
P
Proofpoint News Feed
Google DeepMind News
Google DeepMind News
Blog — PlanetScale
Blog — PlanetScale
有赞技术团队
有赞技术团队
A
About on SuperTechFans

Recent Commits to openclaw:main

test: merge chat side-result checks · openclaw/openclaw@ddd2c2a test: merge cron history checks · openclaw/openclaw@f7eb746 test: merge responsive navigation shell checks · openclaw/openclaw@c2e4b47 docs(changelog): add codex oauth fixes · openclaw/openclaw@628e6cd test: merge navigation routing cases · openclaw/openclaw@5d8cecb Tests: mock channel registry bundled fallback · openclaw/openclaw@2b08233 Secrets: avoid broad web search discovery for single plugin config · openclaw/openclaw@a464f59 test: merge config view browser checks · openclaw/openclaw@20cf511 fix(status): align oauth health with runtime · openclaw/openclaw@eed7116 feat: add macOS screen snapshots for monitor preview (#67954) thanks … · openclaw/openclaw@f377db1 fix: report shared auth scopes in hello-ok (#67810) thanks @BunsDev · openclaw/openclaw@0b6c39b Auto-reply: avoid eager bundled route fallback · openclaw/openclaw@3ea1bf4 Tests: narrow session binding contract setup · openclaw/openclaw@54e4e16 fix(macOS): enable undo/redo in webchat composer text input (#34962) · openclaw/openclaw@00951dc Tests: speed up channel setup promotion · openclaw/openclaw@82b529a Docs: refresh agent instructions · openclaw/openclaw@5775fe2 fix(auth): serialize OAuth refresh across agents to fix #26322 (#67876) · openclaw/openclaw@8e79080 test: allow ollama public surface boundary test · openclaw/openclaw@7d4f1a6 Docs: add test performance guardrails · openclaw/openclaw@89706d3 Tests: restore context-engine usage proof · openclaw/openclaw@e4c4f95 Tests: slim context engine runtime coverage · openclaw/openclaw@74c198f ci: retry failed custom checkouts · openclaw/openclaw@0ee5baf test: trim duplicate provider auth onboarding cases · openclaw/openclaw@1ffc02e matrix: fix sessions_spawn --thread subagent session spawning (#67643) · openclaw/openclaw@1ce2596 test: reduce auth choice fixture churn · openclaw/openclaw@857b9cd test: mock health status config boundaries · openclaw/openclaw@9d5ab4a test: mock onboard config io boundary · openclaw/openclaw@299694d test: mock legacy state plugin boundaries · openclaw/openclaw@2713089 test: mock channel install boundaries · openclaw/openclaw@b945248 test: mock doctor preview channel boundaries · openclaw/openclaw@b1a3ad4
feat(telegram): support web app presentation buttons · op...
steipete · 2026-05-13 · via Recent Commits to openclaw:main
Original file line numberDiff line numberDiff line change

@@ -71,6 +71,7 @@ Docs: https://docs.openclaw.ai

7171

### Changes

7272
7373

- Maintainers: add a Clawdtributor skill for Discrawl-backed contributor PR triage, live status checks, and compact review formatting.

74+

- Telegram: support Mini App `web_app` buttons in generic message presentation payloads, allowing `openclaw message send --presentation` to render Telegram Web App inline buttons for private chats. (#81356) Thanks @jzakirov.

7475

- Scripts: add `OPENCLAW_HEAVY_CHECK_LOCK_SCOPE=worktree` so high-capacity local worktrees can use independent heavy-check locks while shared locks remain the default. Fixes #80729. (#80734) Thanks @samzong.

7576

- Agents/subagents: deliver native `sessions_spawn` tasks in the child session's first visible `[Subagent Task]` message instead of hiding the task in the sub-agent system prompt, keeping delegation auditable without duplicating tokens. Fixes #78592. Thanks @bradestes and @stainlu.

7677

- Voice Call/Telnyx: add realtime media-streaming call support for conversational voice calls. (#81024) Thanks @dynamite-bud.

Original file line numberDiff line numberDiff line change

@@ -526,6 +526,28 @@ curl "https://api.telegram.org/bot<bot_token>/getUpdates"

526526

}

527527

```

528528
529+

Mini App button example:

530+
531+

```json5

532+

{

533+

action: "send",

534+

channel: "telegram",

535+

to: "123456789",

536+

message: "Open app:",

537+

presentation: {

538+

blocks: [

539+

{

540+

type: "buttons",

541+

buttons: [{ label: "Launch", web_app: { url: "https://example.com/app" } }],

542+

},

543+

],

544+

},

545+

}

546+

```

547+
548+

Telegram `web_app` buttons work only in private chats between a user and the

549+

bot.

550+
529551

Callback clicks are passed to the agent as text:

530552

`callback_data: <value>`

531553
Original file line numberDiff line numberDiff line change

@@ -284,6 +284,16 @@ openclaw message send --channel telegram --target @mychat --message "Choose:" \

284284

--presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"Yes","value":"cmd:yes"},{"label":"No","value":"cmd:no"}]}]}'

285285

```

286286
287+

Send a Telegram Mini App button through generic presentation:

288+
289+

```

290+

openclaw message send --channel telegram --target 123456789 --message "Open app:" \

291+

--presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"Launch","web_app":{"url":"https://example.com/app"}}]}]}'

292+

```

293+
294+

Telegram `web_app` buttons are supported only in private chats between a user

295+

and the bot.

296+
287297

Send a Teams card through generic presentation:

288298
289299

```bash

Original file line numberDiff line numberDiff line change

@@ -56,6 +56,8 @@ type MessagePresentationButton = {

5656

label: string;

5757

value?: string;

5858

url?: string;

59+

webApp?: { url: string };

60+

web_app?: { url: string };

5961

style?: "primary" | "secondary" | "success" | "danger";

6062

};

6163

@@ -80,6 +82,8 @@ Button semantics:

8082

- `value` is an application action value routed back through the channel's

8183

existing interaction path when the channel supports clickable controls.

8284

- `url` is a link button. It can exist without `value`.

85+

- `webApp` and `web_app` describe a channel-native web app button. Telegram

86+

renders this as `web_app` and only supports it in private chats.

8387

- `label` is required and is also used in text fallback.

8488

- `style` is advisory. Renderers should map unsupported styles to a safe

8589

default, not fail the send.

@@ -127,6 +131,19 @@ URL-only link button:

127131

}

128132

```

129133
134+

Telegram Mini App button:

135+
136+

```json

137+

{

138+

"blocks": [

139+

{

140+

"type": "buttons",

141+

"buttons": [{ "label": "Launch", "web_app": { "url": "https://example.com/app" } }]

142+

}

143+

]

144+

}

145+

```

146+
130147

Select menu:

131148
132149

```json

Original file line numberDiff line numberDiff line change

@@ -1030,6 +1030,43 @@ describe("handleTelegramAction", () => {

10301030

],

10311031

]);

10321032

});

1033+
1034+

it("forwards web app buttons from generic presentation", async () => {

1035+

await handleTelegramAction(

1036+

{

1037+

action: "sendMessage",

1038+

to: "5232990709",

1039+

content: "Choose",

1040+

presentation: {

1041+

blocks: [

1042+

{

1043+

type: "buttons",

1044+

buttons: [

1045+

{

1046+

label: "Launch",

1047+

web_app: { url: "https://example.com/app" },

1048+

style: "primary",

1049+

},

1050+

],

1051+

},

1052+

],

1053+

},

1054+

},

1055+

telegramConfig({ capabilities: { inlineButtons: "dm" } }),

1056+

);

1057+

const call = mockCall(sendMessageTelegram, 0, "inline keyboard web app");

1058+

expect(call[0]).toBe("5232990709");

1059+

expect(call[1]).toBe("Choose");

1060+

expect(requireRecord(call[2], "inline keyboard web app options").buttons).toEqual([

1061+

[

1062+

{

1063+

text: "Launch",

1064+

web_app: { url: "https://example.com/app" },

1065+

style: "primary",

1066+

},

1067+

],

1068+

]);

1069+

});

10331070

});

10341071
10351072

describe("handleTelegramAction per-account gating", () => {

Original file line numberDiff line numberDiff line change

@@ -13,6 +13,7 @@ export function describeTelegramInteractiveButtonBehavior(): void {

1313

{ label: "Approve", value: "approve", style: "success" },

1414

{ label: "Docs", url: "https://example.com/docs", style: "primary" },

1515

{ label: "Reject", value: "reject", style: "danger" },

16+

{ label: "Launch", webApp: { url: "https://example.com/app" } },

1617

{ label: "Later", value: "later" },

1718

{ label: "Archive", value: "archive" },

1819

],

@@ -30,6 +31,7 @@ export function describeTelegramInteractiveButtonBehavior(): void {

3031

{ text: "Reject", callback_data: "reject", style: "danger" },

3132

],

3233

[

34+

{ text: "Launch", web_app: { url: "https://example.com/app" }, style: undefined },

3335

{ text: "Later", callback_data: "later", style: undefined },

3436

{ text: "Archive", callback_data: "archive", style: undefined },

3537

],

Original file line numberDiff line numberDiff line change

@@ -12,6 +12,7 @@ type TelegramInlineButton = {

1212

text: string;

1313

callback_data?: string;

1414

url?: string;

15+

web_app?: { url: string };

1516

style?: TelegramButtonStyle;

1617

};

1718

@@ -35,13 +36,21 @@ function toTelegramInlineButton(button: InteractiveReplyButton): TelegramInlineB

3536

};

3637

}

3738

const callbackData = button.value ? sanitizeTelegramCallbackData(button.value) : undefined;

38-

return callbackData

39-

? {

40-

text: button.label,

41-

callback_data: callbackData,

42-

style,

43-

}

44-

: undefined;

39+

if (callbackData) {

40+

return {

41+

text: button.label,

42+

callback_data: callbackData,

43+

style,

44+

};

45+

}

46+

if (button.webApp?.url) {

47+

return {

48+

text: button.label,

49+

web_app: { url: button.webApp.url },

50+

style,

51+

};

52+

}

53+

return undefined;

4554

}

4655
4756

function chunkInteractiveButtons(

Original file line numberDiff line numberDiff line change

@@ -17,6 +17,11 @@ function toInlineKeyboardButton(

1717

? { text: button.text, callback_data: button.callback_data, style: button.style }

1818

: { text: button.text, callback_data: button.callback_data };

1919

}

20+

if (button.web_app?.url) {

21+

return button.style

22+

? { text: button.text, web_app: { url: button.web_app.url }, style: button.style }

23+

: { text: button.text, web_app: { url: button.web_app.url } };

24+

}

2025

return undefined;

2126

}

2227
Original file line numberDiff line numberDiff line change

@@ -150,6 +150,44 @@ describe("telegramOutbound", () => {

150150

expect(result).toEqual({ channel: "telegram", messageId: "tg-buttons", chatId: "12345" });

151151

});

152152
153+

it("renders presentation web app buttons for payload sends", async () => {

154+

sendMessageTelegramMock.mockResolvedValueOnce({ messageId: "tg-web-app", chatId: "12345" });

155+

const presentation = {

156+

blocks: [

157+

{

158+

type: "buttons" as const,

159+

buttons: [{ label: "Launch", webApp: { url: "https://example.com/app" } }],

160+

},

161+

],

162+

};

163+

const rendered = await telegramOutbound.renderPresentation?.({

164+

payload: { text: "Open app:" },

165+

presentation,

166+

ctx: {} as never,

167+

});

168+

if (!rendered) {

169+

throw new Error("expected rendered Telegram presentation");

170+

}

171+
172+

await telegramOutbound.sendPayload!({

173+

cfg: {} as never,

174+

to: "12345",

175+

text: "",

176+

payload: rendered,

177+

deps: { sendTelegram: sendMessageTelegramMock },

178+

});

179+
180+

const options = callOptionsAt(

181+

sendMessageTelegramMock,

182+

0,

183+

"12345",

184+

"Open app:\n\n- Launch: https://example.com/app",

185+

);

186+

expect(options.buttons).toEqual([

187+

[{ text: "Launch", web_app: { url: "https://example.com/app" } }],

188+

]);

189+

});

190+
153191

it("forwards silent delivery options to Telegram sends", async () => {

154192

sendMessageTelegramMock.mockResolvedValueOnce({ messageId: "tg-silent", chatId: "12345" });

155193
Original file line numberDiff line numberDiff line change

@@ -345,6 +345,13 @@ describe("buildInlineKeyboard", () => {

345345

inline_keyboard: [[{ text: "Open", url: "https://example.com" }]],

346346

},

347347

},

348+

{

349+

name: "keeps web app buttons",

350+

input: [[{ text: "Launch", web_app: { url: "https://example.com/app" } }]],

351+

expected: {

352+

inline_keyboard: [[{ text: "Launch", web_app: { url: "https://example.com/app" } }]],

353+

},

354+

},

348355

{

349356

name: "prefers url over callback data when both are present",

350357

input: [[{ text: "Open", callback_data: "cmd:open", url: "https://example.com" }]],