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

推荐订阅源

博客园 - 三生石上(FineUI控件)
WordPress大学
WordPress大学
S
SegmentFault 最新的问题
小众软件
小众软件
T
Tailwind CSS Blog
博客园 - 聂微东
OSCHINA 社区最新新闻
OSCHINA 社区最新新闻
人人都是产品经理
人人都是产品经理
V
Visual Studio Blog
罗磊的独立博客
有赞技术团队
有赞技术团队
奇客Solidot–传递最新科技情报
奇客Solidot–传递最新科技情报
让小产品的独立变现更简单 - ezindie.com
让小产品的独立变现更简单 - ezindie.com
Jina AI
Jina AI
量子位
云风的 BLOG
云风的 BLOG
Recent Announcements
Recent Announcements
Hugging Face - Blog
Hugging Face - Blog
P
Proofpoint News Feed
N
Netflix TechBlog - Medium
GbyAI
GbyAI
钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
腾讯CDC
美团技术团队

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): localized command menu descriptions · ope...
jzakirov · 2026-05-13 · via Recent Commits to openclaw:main

@@ -1,4 +1,5 @@

11

import { createHash } from "node:crypto";

2+

import type { LanguageCode } from "@grammyjs/types";

23

import type { Bot } from "grammy";

34

import { logVerbose } from "openclaw/plugin-sdk/runtime-env";

45

import type { RuntimeEnv } from "openclaw/plugin-sdk/runtime-env";

@@ -15,9 +16,10 @@ const TELEGRAM_COMMAND_RETRY_RATIO = 0.8;

1516

const TELEGRAM_MIN_COMMAND_DESCRIPTION_LENGTH = 1;

1617

const TELEGRAM_MENU_RESULT_CACHE_MAX = 128;

171818-

type TelegramMenuCommand = {

19+

export type TelegramMenuCommand = {

1920

command: string;

2021

description: string;

22+

descriptionLocalizations?: Record<string, string>;

2123

};

22242325

type TelegramCommandMenuScope =

@@ -27,6 +29,7 @@ type TelegramCommandMenuScope =

2729

type TelegramPluginCommandSpec = {

2830

name: unknown;

2931

description: unknown;

32+

descriptionLocalizations?: Record<string, string>;

3033

};

31343235

const TELEGRAM_COMMAND_MENU_SCOPES: readonly TelegramCommandMenuScope[] = [

@@ -196,7 +199,11 @@ export function buildPluginTelegramMenuCommands(params: {

196199

}

197200

pluginCommandNames.add(normalized);

198201

existingCommands.add(normalized);

199-

commands.push({ command: normalized, description });

202+

const menuCommand: TelegramMenuCommand = { command: normalized, description };

203+

if (spec.descriptionLocalizations) {

204+

menuCommand.descriptionLocalizations = spec.descriptionLocalizations;

205+

}

206+

commands.push(menuCommand);

200207

}

201208202209

return { commands, issues };

@@ -324,11 +331,33 @@ function writeCachedCommandHash(

324331

syncedCommandHashes.set(key, hash);

325332

}

326333334+

function buildLocalizedCommandVariants(

335+

commands: TelegramMenuCommand[],

336+

): Array<{ languageCode: string; commands: TelegramMenuCommand[] }> {

337+

const locales = new Set<string>();

338+

for (const cmd of commands) {

339+

if (cmd.descriptionLocalizations) {

340+

for (const lang of Object.keys(cmd.descriptionLocalizations)) {

341+

locales.add(lang);

342+

}

343+

}

344+

}

345+

return [...locales].toSorted().map((languageCode) => ({

346+

languageCode,

347+

commands: commands.map((cmd) => ({

348+

command: cmd.command,

349+

description: cmd.descriptionLocalizations?.[languageCode] ?? cmd.description,

350+

})),

351+

}));

352+

}

353+327354

function formatTelegramCommandScopeOperation(

328355

operation: "deleteMyCommands" | "setMyCommands",

329356

scope: TelegramCommandMenuScope,

357+

languageCode?: string,

330358

): string {

331-

return scope.label === "default" ? operation : `${operation}(${scope.label})`;

359+

const base = scope.label === "default" ? operation : `${operation}(${scope.label})`;

360+

return languageCode ? `${base}(${languageCode})` : base;

332361

}

333362334363

async function deleteTelegramMenuCommandsForScopes(params: {

@@ -359,18 +388,24 @@ async function setTelegramMenuCommandsForScopes(params: {

359388

bot: Bot;

360389

runtime: RuntimeEnv;

361390

commands: TelegramMenuCommand[];

391+

languageCode?: string;

362392

shouldLog?: (err: unknown) => boolean;

363393

}): Promise<void> {

364-

const { bot, runtime, commands, shouldLog } = params;

394+

const { bot, runtime, commands, languageCode, shouldLog } = params;

365395

for (const scope of TELEGRAM_COMMAND_MENU_SCOPES) {

366396

await withTelegramApiErrorLogging({

367-

operation: formatTelegramCommandScopeOperation("setMyCommands", scope),

397+

operation: formatTelegramCommandScopeOperation("setMyCommands", scope, languageCode),

368398

runtime,

369399

shouldLog,

370-

fn: () =>

371-

scope.options

372-

? bot.api.setMyCommands(commands, scope.options)

373-

: bot.api.setMyCommands(commands),

400+

fn: () => {

401+

const opts = {

402+

...scope.options,

403+

...(languageCode ? { language_code: languageCode as LanguageCode } : undefined),

404+

};

405+

return Object.keys(opts).length > 0

406+

? bot.api.setMyCommands(commands, opts)

407+

: bot.api.setMyCommands(commands);

408+

},

374409

});

375410

}

376411

}

@@ -428,8 +463,7 @@ export function syncTelegramMenuCommands(params: {

428463

}),

429464

);

430465

}

431-

writeCachedCommandHash(accountId, botIdentity, currentHash);

432-

return;

466+

break;

433467

} catch (err) {

434468

if (!isBotCommandsTooMuchError(err)) {

435469

throw err;

@@ -449,6 +483,16 @@ export function syncTelegramMenuCommands(params: {

449483

retryCommands = retryCommands.slice(0, reducedCount);

450484

}

451485

}

486+487+

for (const variant of buildLocalizedCommandVariants(commandsToRegister)) {

488+

await setTelegramMenuCommandsForScopes({

489+

bot,

490+

runtime,

491+

commands: variant.commands,

492+

languageCode: variant.languageCode,

493+

});

494+

}

495+

writeCachedCommandHash(accountId, botIdentity, currentHash);

452496

};

453497454498

void sync().catch((err) => {