{"id":174,"date":"2026-03-21T22:47:20","date_gmt":"2026-03-21T14:47:20","guid":{"rendered":"https:\/\/pa.yingzhi8.cn\/index.php\/2026\/03\/21\/nodes-audio\/"},"modified":"2026-03-21T23:08:55","modified_gmt":"2026-03-21T15:08:55","slug":"nodes-audio","status":"publish","type":"post","link":"https:\/\/pa.yingzhi8.cn\/index.php\/2026\/03\/21\/nodes-audio\/","title":{"rendered":"\u97f3\u9891\u4e0e\u8bed\u97f3\u6d88\u606f"},"content":{"rendered":"<h1>\u97f3\u9891\u4e0e\u8bed\u97f3\u6d88\u606f<\/h1>\n<h1>\u97f3\u9891 \/ \u8bed\u97f3\u6d88\u606f \u2014 2026-01-17<\/h1>\n<h2>\u5df2\u652f\u6301\u7684\u529f\u80fd<\/h2>\n<ul>\n<li><strong>\u5a92\u4f53\u7406\u89e3\uff08\u97f3\u9891\uff09<\/strong>\uff1a\u5982\u679c\u97f3\u9891\u7406\u89e3\u5df2\u542f\u7528\uff08\u6216\u81ea\u52a8\u68c0\u6d4b\uff09\uff0cOpenClaw \u4f1a\uff1a<br \/>\n  1. \u627e\u5230\u7b2c\u4e00\u4e2a\u97f3\u9891\u9644\u4ef6\uff08\u672c\u5730\u8def\u5f84\u6216 URL\uff09\uff0c\u5982\u6709\u9700\u8981\u5219\u4e0b\u8f7d\u3002<br \/>\n  2. \u5728\u53d1\u9001\u7ed9\u6bcf\u4e2a\u6a21\u578b\u6761\u76ee\u4e4b\u524d\u6267\u884c <code>maxBytes<\/code> \u9650\u5236\u3002<br \/>\n  3. \u6309\u987a\u5e8f\u8fd0\u884c\u7b2c\u4e00\u4e2a\u7b26\u5408\u6761\u4ef6\u7684\u6a21\u578b\u6761\u76ee\uff08\u63d0\u4f9b\u5546\u6216 CLI\uff09\u3002<br \/>\n  4. \u5982\u679c\u5931\u8d25\u6216\u8df3\u8fc7\uff08\u5927\u5c0f\/\u8d85\u65f6\uff09\uff0c\u5219\u5c1d\u8bd5\u4e0b\u4e00\u4e2a\u6761\u76ee\u3002<br \/>\n  5. \u6210\u529f\u540e\uff0c\u5c06 <code>Body<\/code> \u66ff\u6362\u4e3a <code>[Audio]<\/code> \u5757\u5e76\u8bbe\u7f6e <code>{{Transcript}}<\/code>\u3002<\/li>\n<li><strong>\u547d\u4ee4\u89e3\u6790<\/strong>\uff1a\u8f6c\u5f55\u6210\u529f\u65f6\uff0c<code>CommandBody<\/code>\/<code>RawBody<\/code> \u4f1a\u8bbe\u7f6e\u4e3a\u8f6c\u5f55\u6587\u672c\uff0c\u56e0\u6b64\u659c\u6760\u547d\u4ee4\u4ecd\u7136\u6709\u6548\u3002<\/li>\n<li><strong>\u8be6\u7ec6\u65e5\u5fd7<\/strong>\uff1a\u5728 <code>--verbose<\/code> \u6a21\u5f0f\u4e0b\uff0c\u6211\u4eec\u4f1a\u5728\u8f6c\u5f55\u8fd0\u884c\u548c\u66ff\u6362\u6b63\u6587\u65f6\u8bb0\u5f55\u65e5\u5fd7\u3002<\/li>\n<\/ul>\n<h2>\u81ea\u52a8\u68c0\u6d4b\uff08\u9ed8\u8ba4\uff09<\/h2>\n<p>\u5982\u679c\u4f60<strong>\u672a\u914d\u7f6e\u6a21\u578b<\/strong>\u4e14 <code>tools.media.audio.enabled<\/code> <strong>\u672a<\/strong>\u8bbe\u7f6e\u4e3a <code>false<\/code>\uff0cOpenClaw \u4f1a\u6309\u4ee5\u4e0b\u987a\u5e8f\u81ea\u52a8\u68c0\u6d4b\uff0c\u5e76\u5728\u627e\u5230\u7b2c\u4e00\u4e2a\u53ef\u7528\u9009\u9879\u65f6\u505c\u6b62\uff1a<\/p>\n<ol>\n<li><strong>\u672c\u5730 CLI<\/strong>\uff08\u5982\u5df2\u5b89\u88c5\uff09<br \/>\n   * <code>sherpa-onnx-offline<\/code>\uff08\u9700\u8981 <code>SHERPA_ONNX_MODEL_DIR<\/code> \u5305\u542b encoder\/decoder\/joiner\/tokens\uff09<br \/>\n   * <code>whisper-cli<\/code>\uff08\u6765\u81ea <code>whisper-cpp<\/code>\uff1b\u4f7f\u7528 <code>WHISPER_CPP_MODEL<\/code> \u6216\u5185\u7f6e\u7684 tiny \u6a21\u578b\uff09<br \/>\n   * <code>whisper<\/code>\uff08Python CLI\uff1b\u81ea\u52a8\u4e0b\u8f7d\u6a21\u578b\uff09<\/li>\n<li><strong>Gemini CLI<\/strong>\uff08<code>gemini<\/code>\uff09\u4f7f\u7528 <code>read_many_files<\/code><\/li>\n<li><strong>\u63d0\u4f9b\u5546\u5bc6\u94a5<\/strong>\uff08OpenAI \u2192 Groq \u2192 Deepgram \u2192 Google\uff09<\/li>\n<\/ol>\n<p>\u8981\u7981\u7528\u81ea\u52a8\u68c0\u6d4b\uff0c\u8bf7\u8bbe\u7f6e <code>tools.media.audio.enabled: false<\/code>\u3002<br \/>\n\u8981\u81ea\u5b9a\u4e49\uff0c\u8bf7\u8bbe\u7f6e <code>tools.media.audio.models<\/code>\u3002<br \/>\n\u6ce8\u610f\uff1a\u4e8c\u8fdb\u5236\u68c0\u6d4b\u5728 macOS\/Linux\/Windows \u4e0a\u91c7\u7528\u5c3d\u529b\u800c\u4e3a\u7684\u65b9\u5f0f\uff1b\u8bf7\u786e\u4fdd CLI \u5728 <code>PATH<\/code> \u4e2d\uff08\u6211\u4eec\u4f1a\u5c55\u5f00 <code>~<\/code>\uff09\uff0c\u6216\u901a\u8fc7\u5b8c\u6574\u547d\u4ee4\u8def\u5f84\u8bbe\u7f6e\u663e\u5f0f CLI \u6a21\u578b\u3002<\/p>\n<h2>\u914d\u7f6e\u793a\u4f8b<\/h2>\n<h3>\u63d0\u4f9b\u5546 + CLI \u56de\u9000\uff08OpenAI + Whisper CLI\uff09<\/h3>\n<p>&#8220;`json5  theme={&#8220;theme&#8221;:{&#8220;light&#8221;:&#8221;min-light&#8221;,&#8221;dark&#8221;:&#8221;min-dark&#8221;}}<br \/>\n{<br \/>\n  tools: {<br \/>\n    media: {<br \/>\n      audio: {<br \/>\n        enabled: true,<br \/>\n        maxBytes: 20971520,<br \/>\n        models: [<br \/>\n          { provider: &#8220;openai&#8221;, model: &#8220;gpt-4o-mini-transcribe&#8221; },<br \/>\n          {<br \/>\n            type: &#8220;cli&#8221;,<br \/>\n            command: &#8220;whisper&#8221;,<br \/>\n            args: [&#8220;&#8211;model&#8221;, &#8220;base&#8221;, &#8220;{{MediaPath}}&#8221;],<br \/>\n            timeoutSeconds: 45,<br \/>\n          },<br \/>\n        ],<br \/>\n      },<br \/>\n    },<br \/>\n  },<br \/>\n}<\/p>\n<pre><code>\n### \u4ec5\u63d0\u4f9b\u5546 + \u4f5c\u7528\u57df\u63a7\u5236\n\n```json5  theme={&quot;theme&quot;:{&quot;light&quot;:&quot;min-light&quot;,&quot;dark&quot;:&quot;min-dark&quot;}}\n{\n  tools: {\n    media: {\n      audio: {\n        enabled: true,\n        scope: {\n          default: &quot;allow&quot;,\n          rules: [{ action: &quot;deny&quot;, match: { chatType: &quot;group&quot; } }],\n        },\n        models: [{ provider: &quot;openai&quot;, model: &quot;gpt-4o-mini-transcribe&quot; }],\n      },\n    },\n  },\n}\n<\/code><\/pre>\n<h3>\u4ec5\u63d0\u4f9b\u5546\uff08Deepgram\uff09<\/h3>\n<p><code>json5  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}<br \/>\n{<br \/>\n  tools: {<br \/>\n    media: {<br \/>\n      audio: {<br \/>\n        enabled: true,<br \/>\n        models: [{ provider: \"deepgram\", model: \"nova-3\" }],<br \/>\n      },<br \/>\n    },<br \/>\n  },<br \/>\n}<\/code><\/p>\n<h2>\u6ce8\u610f\u4e8b\u9879\u4e0e\u9650\u5236<\/h2>\n<ul>\n<li>\u63d0\u4f9b\u5546\u8ba4\u8bc1\u9075\u5faa\u6807\u51c6\u7684\u6a21\u578b\u8ba4\u8bc1\u987a\u5e8f\uff08\u8ba4\u8bc1\u914d\u7f6e\u6587\u4ef6\u3001\u73af\u5883\u53d8\u91cf\u3001<code>models.providers.*.apiKey<\/code>\uff09\u3002<\/li>\n<li>\u5f53\u4f7f\u7528 <code>provider: \"deepgram\"<\/code> \u65f6\uff0cDeepgram \u4f1a\u8bfb\u53d6 <code>DEEPGRAM_API_KEY<\/code>\u3002<\/li>\n<li>Deepgram \u8bbe\u7f6e\u8be6\u60c5\uff1a<a href=\"\/providers\/deepgram\">Deepgram\uff08\u97f3\u9891\u8f6c\u5f55\uff09<\/a>\u3002<\/li>\n<li>\u97f3\u9891\u63d0\u4f9b\u5546\u53ef\u4ee5\u901a\u8fc7 <code>tools.media.audio<\/code> \u8986\u76d6 <code>baseUrl<\/code>\u3001<code>headers<\/code> \u548c <code>providerOptions<\/code>\u3002<\/li>\n<li>\u9ed8\u8ba4\u5927\u5c0f\u9650\u5236\u4e3a 20MB\uff08<code>tools.media.audio.maxBytes<\/code>\uff09\u3002\u8d85\u5927\u97f3\u9891\u4f1a\u8df3\u8fc7\u8be5\u6a21\u578b\u5e76\u5c1d\u8bd5\u4e0b\u4e00\u4e2a\u6761\u76ee\u3002<\/li>\n<li>\u97f3\u9891\u7684\u9ed8\u8ba4 <code>maxChars<\/code> <strong>\u672a\u8bbe\u7f6e<\/strong>\uff08\u5b8c\u6574\u8f6c\u5f55\u6587\u672c\uff09\u3002\u8bbe\u7f6e <code>tools.media.audio.maxChars<\/code> \u6216\u6bcf\u4e2a\u6761\u76ee\u7684 <code>maxChars<\/code> \u6765\u88c1\u526a\u8f93\u51fa\u3002<\/li>\n<li>OpenAI \u81ea\u52a8\u68c0\u6d4b\u9ed8\u8ba4\u4f7f\u7528 <code>gpt-4o-mini-transcribe<\/code>\uff1b\u8bbe\u7f6e <code>model: \"gpt-4o-transcribe\"<\/code> \u53ef\u83b7\u5f97\u66f4\u9ad8\u51c6\u786e\u5ea6\u3002<\/li>\n<li>\u4f7f\u7528 <code>tools.media.audio.attachments<\/code> \u5904\u7406\u591a\u6761\u8bed\u97f3\u6d88\u606f\uff08<code>mode: \"all\"<\/code> + <code>maxAttachments<\/code>\uff09\u3002<\/li>\n<li>\u8f6c\u5f55\u6587\u672c\u53ef\u5728\u6a21\u677f\u4e2d\u901a\u8fc7 <code>{{Transcript}}<\/code> \u4f7f\u7528\u3002<\/li>\n<li>CLI \u6807\u51c6\u8f93\u51fa\u6709\u4e0a\u9650\uff085MB\uff09\uff1b\u8bf7\u4fdd\u6301 CLI \u8f93\u51fa\u7b80\u6d01\u3002<\/li>\n<\/ul>\n<h2>\u5e38\u89c1\u9677\u9631<\/h2>\n<ul>\n<li>\u4f5c\u7528\u57df\u89c4\u5219\u91c7\u7528\u9996\u6b21\u5339\u914d\u4f18\u5148\u3002<code>chatType<\/code> \u4f1a\u88ab\u89c4\u8303\u5316\u4e3a <code>direct<\/code>\u3001<code>group<\/code> \u6216 <code>room<\/code>\u3002<\/li>\n<li>\u786e\u4fdd\u4f60\u7684 CLI \u4ee5\u9000\u51fa\u7801 0 \u9000\u51fa\u5e76\u8f93\u51fa\u7eaf\u6587\u672c\uff1bJSON \u683c\u5f0f\u9700\u8981\u901a\u8fc7 <code>jq -r .text<\/code> \u8fdb\u884c\u8f6c\u6362\u3002<\/li>\n<li>\u4fdd\u6301\u5408\u7406\u7684\u8d85\u65f6\u65f6\u95f4\uff08<code>timeoutSeconds<\/code>\uff0c\u9ed8\u8ba4 60 \u79d2\uff09\uff0c\u4ee5\u907f\u514d\u963b\u585e\u56de\u590d\u961f\u5217\u3002<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>\u97f3\u9891\u4e0e\u8bed\u97f3\u6d88\u606f \u97f3\u9891 \/ \u8bed\u97f3\u6d88\u606f \u2014 2026-01-17 \u5df2\u652f\u6301\u7684\u529f\u80fd \u5a92\u4f53\u7406\u89e3\uff08\u97f3\u9891\uff09\uff1a\u5982\u679c\u97f3\u9891\u7406\u89e3\u5df2\u542f [&hellip;]<\/p>\n","protected":false},"author":0,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[],"class_list":["post-174","post","type-post","status-publish","format-standard","hentry","category-docs"],"_links":{"self":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/174","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/types\/post"}],"replies":[{"embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/comments?post=174"}],"version-history":[{"count":1,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/174\/revisions"}],"predecessor-version":[{"id":469,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/174\/revisions\/469"}],"wp:attachment":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/media?parent=174"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/categories?post=174"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/tags?post=174"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}