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

推荐订阅源

人人都是产品经理
人人都是产品经理
博客园_首页
IT之家
IT之家
让小产品的独立变现更简单 - ezindie.com
让小产品的独立变现更简单 - ezindie.com
Vercel News
Vercel News
美团技术团队
D
Docker
WordPress大学
WordPress大学
T
Tailwind CSS Blog
酷 壳 – CoolShell
酷 壳 – CoolShell
The Cloudflare Blog
Y
Y Combinator Blog
F
Fortinet All Blogs
freeCodeCamp Programming Tutorials: Python, JavaScript, Git & More
G
Google Developers Blog
爱范儿
爱范儿
奇客Solidot–传递最新科技情报
奇客Solidot–传递最新科技情报
月光博客
月光博客
MongoDB | Blog
MongoDB | Blog
S
SegmentFault 最新的问题
GbyAI
GbyAI
Hugging Face - Blog
Hugging Face - Blog
Microsoft Azure Blog
Microsoft Azure Blog
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(openrouter): add inbound audio STT support · opencla...
remdev · 2026-05-12 · via Recent Commits to openclaw:main

@@ -0,0 +1,180 @@

1+

import { afterEach, describe, expect, it, vi } from "vitest";

2+

import {

3+

openrouterMediaUnderstandingProvider,

4+

transcribeOpenRouterAudio,

5+

} from "./media-understanding-provider.js";

6+7+

const { assertOkOrThrowHttpErrorMock, postJsonRequestMock, resolveProviderHttpRequestConfigMock } =

8+

vi.hoisted(() => ({

9+

assertOkOrThrowHttpErrorMock: vi.fn(async () => {}),

10+

postJsonRequestMock: vi.fn(),

11+

resolveProviderHttpRequestConfigMock: vi.fn((params: Record<string, unknown>) => ({

12+

baseUrl: params.baseUrl ?? params.defaultBaseUrl ?? "https://openrouter.ai/api/v1",

13+

allowPrivateNetwork: false,

14+

headers: new Headers(params.defaultHeaders as HeadersInit | undefined),

15+

dispatcherPolicy: undefined,

16+

})),

17+

}));

18+19+

vi.mock("openclaw/plugin-sdk/provider-http", () => ({

20+

assertOkOrThrowHttpError: assertOkOrThrowHttpErrorMock,

21+

postJsonRequest: postJsonRequestMock,

22+

requireTranscriptionText: (value: string | undefined, message: string) => {

23+

const text = value?.trim();

24+

if (!text) {

25+

throw new Error(message);

26+

}

27+

return text;

28+

},

29+

resolveProviderHttpRequestConfig: resolveProviderHttpRequestConfigMock,

30+

}));

31+32+

describe("openrouter media understanding provider", () => {

33+

afterEach(() => {

34+

assertOkOrThrowHttpErrorMock.mockClear();

35+

postJsonRequestMock.mockReset();

36+

resolveProviderHttpRequestConfigMock.mockClear();

37+

});

38+39+

it("declares image and audio capabilities with defaults", () => {

40+

expect(openrouterMediaUnderstandingProvider).toMatchObject({

41+

id: "openrouter",

42+

capabilities: ["image", "audio"],

43+

defaultModels: {

44+

image: "auto",

45+

audio: "openai/whisper-large-v3-turbo",

46+

},

47+

autoPriority: { audio: 35 },

48+

});

49+

expect(openrouterMediaUnderstandingProvider.transcribeAudio).toBeTypeOf("function");

50+

});

51+52+

it("sends JSON STT payload to OpenRouter transcriptions endpoint", async () => {

53+

const release = vi.fn(async () => {});

54+

postJsonRequestMock.mockResolvedValue({

55+

response: new Response(JSON.stringify({ text: "hello world" }), { status: 200 }),

56+

release,

57+

});

58+59+

const result = await transcribeOpenRouterAudio({

60+

buffer: Buffer.from("audio-bytes"),

61+

fileName: "voice.oga",

62+

mime: "audio/ogg",

63+

apiKey: "sk-openrouter",

64+

timeoutMs: 12_000,

65+

language: " en ",

66+

fetchFn: fetch,

67+

});

68+69+

expect(result).toEqual({

70+

text: "hello world",

71+

model: "openai/whisper-large-v3-turbo",

72+

});

73+

expect(resolveProviderHttpRequestConfigMock).toHaveBeenCalledWith(

74+

expect.objectContaining({

75+

provider: "openrouter",

76+

capability: "audio",

77+

}),

78+

);

79+

expect(postJsonRequestMock).toHaveBeenCalledWith(

80+

expect.objectContaining({

81+

url: "https://openrouter.ai/api/v1/audio/transcriptions",

82+

timeoutMs: 12_000,

83+

body: {

84+

model: "openai/whisper-large-v3-turbo",

85+

input_audio: {

86+

data: Buffer.from("audio-bytes").toString("base64"),

87+

format: "ogg",

88+

},

89+

language: "en",

90+

},

91+

}),

92+

);

93+

const headers = postJsonRequestMock.mock.calls[0]?.[0]?.headers as Headers;

94+

expect(headers.get("authorization")).toBe("Bearer sk-openrouter");

95+

expect(headers.get("http-referer")).toBe("https://openclaw.ai");

96+

expect(headers.get("x-openrouter-title")).toBe("OpenClaw");

97+

expect(release).toHaveBeenCalledOnce();

98+

});

99+100+

it("accepts temperature via provider query options", async () => {

101+

const release = vi.fn(async () => {});

102+

postJsonRequestMock.mockResolvedValue({

103+

response: new Response(JSON.stringify({ text: "ok" }), { status: 200 }),

104+

release,

105+

});

106+107+

await transcribeOpenRouterAudio({

108+

buffer: Buffer.from("audio"),

109+

fileName: "voice.webm",

110+

apiKey: "sk-openrouter",

111+

timeoutMs: 5_000,

112+

query: { temperature: 0.2 },

113+

fetchFn: fetch,

114+

});

115+116+

expect(postJsonRequestMock).toHaveBeenCalledWith(

117+

expect.objectContaining({

118+

body: expect.objectContaining({

119+

temperature: 0.2,

120+

}),

121+

}),

122+

);

123+

});

124+125+

it("falls back to filename extension when mime is missing", async () => {

126+

const release = vi.fn(async () => {});

127+

postJsonRequestMock.mockResolvedValue({

128+

response: new Response(JSON.stringify({ text: "ok" }), { status: 200 }),

129+

release,

130+

});

131+132+

await transcribeOpenRouterAudio({

133+

buffer: Buffer.from("audio"),

134+

fileName: "voice.opus",

135+

apiKey: "sk-openrouter",

136+

timeoutMs: 5_000,

137+

fetchFn: fetch,

138+

});

139+140+

expect(postJsonRequestMock).toHaveBeenCalledWith(

141+

expect.objectContaining({

142+

body: expect.objectContaining({

143+

input_audio: expect.objectContaining({ format: "ogg" }),

144+

}),

145+

}),

146+

);

147+

});

148+149+

it("throws when format cannot be resolved", async () => {

150+

await expect(

151+

transcribeOpenRouterAudio({

152+

buffer: Buffer.from("audio"),

153+

fileName: "voice.bin",

154+

mime: "application/octet-stream",

155+

apiKey: "sk-openrouter",

156+

timeoutMs: 5_000,

157+

fetchFn: fetch,

158+

}),

159+

).rejects.toThrow("OpenRouter STT could not resolve audio format");

160+

expect(postJsonRequestMock).not.toHaveBeenCalled();

161+

});

162+163+

it("throws when provider response omits text", async () => {

164+

const release = vi.fn(async () => {});

165+

postJsonRequestMock.mockResolvedValue({

166+

response: new Response(JSON.stringify({}), { status: 200 }),

167+

release,

168+

});

169+170+

await expect(

171+

transcribeOpenRouterAudio({

172+

buffer: Buffer.from("audio"),

173+

fileName: "voice.mp3",

174+

apiKey: "sk-openrouter",

175+

timeoutMs: 5_000,

176+

fetchFn: fetch,

177+

}),

178+

).rejects.toThrow("OpenRouter transcription response missing text");

179+

});

180+

});