Open-source speech recognition toolkit for training, inference, streaming ASR, VAD, punctuation, speaker diarization pipelines, and OpenAI-compatible/MCP serving.
Python asraudiochineseemotion-recognitionfunasrmcp-servermultilingual-asropenai-compatible-apiparaformerpunctuationpytorchreal-time-asrspeaker-diarizationspeech-recognitionspeech-to-textstreaming-asrtranscriptionvllmvoice-activity-detectionwhisper-alternative
docs: disclose unmerged OpenClaw SDK dependency
zhifu gaof8c88061831d
diff --git a/.github/workflows/product-site.yml b/.github/workflows/product-site.ymlindex 0cf41eecc..d4ae4de8a 100644--- a/.github/workflows/product-site.yml+++ b/.github/workflows/product-site.yml@@ -11,6 +11,7 @@ on:- 'tests/test_sphinx_links.py'- 'tests/test_vllm_examples_contract.py'- 'tests/test_readme_task_entrypoints.py'+ - 'tests/test_community_projects_entries.py'- 'model_zoo/**/*.md'- 'runtime/**/*.md'- 'examples/openai_api/**/*.md'@@ -34,6 +35,7 @@ on:- 'tests/test_sphinx_links.py'- 'tests/test_vllm_examples_contract.py'- 'tests/test_readme_task_entrypoints.py'+ - 'tests/test_community_projects_entries.py'- 'model_zoo/**/*.md'- 'runtime/**/*.md'- 'examples/openai_api/**/*.md'@@ -91,6 +93,7 @@ jobs:run: >-python -m pytesttests/test_readme_task_entrypoints.py+ tests/test_community_projects_entries.pytests/test_learning_docs_contract.pytests/test_reference_docs_contract.pytests/test_vllm_examples_contract.pydiff --git a/README.md b/README.mdindex 4300147fe..ff9275240 100644--- a/README.md+++ b/README.md@@ -125,7 +125,7 @@ results = model.generate(["audio1.wav", "audio2.wav"], language="auto")>> **Use with AI agents:** [MCP Server](examples/mcp_server/) for Claude/Cursor · [OpenAI API](examples/openai_api/) for LangChain/Dify/AutoGen>-> **Use with voice agents:** [OpenClaw realtime plugin](integrations/openclaw/) for self-hosted Talk and Voice Call transcription · [Hugging Face speech-to-speech with SenseVoice](./docs/community_projects.md#speech-to-speech) (merged source checkout; not in v1.0.0)+> **Use with voice agents:** [OpenClaw realtime plugin](integrations/openclaw/#compatibility) (experimental; requires an unmerged upstream SDK patch) · [Hugging Face speech-to-speech with SenseVoice](./docs/community_projects.md#speech-to-speech) (merged source checkout; not in v1.0.0)### Why FunASR?diff --git a/README_zh.md b/README_zh.mdindex 2c5ac1e3a..24083770c 100644--- a/README_zh.md+++ b/README_zh.md@@ -115,7 +115,7 @@ results = model.generate(["audio1.wav", "audio2.wav"], language="auto")>> **接入 AI Agent:** [MCP 服务](examples/mcp_server/) 支持 Claude/Cursor · [OpenAI API](examples/openai_api/README_zh.md) 支持 LangChain/Dify/AutoGen>-> **接入语音 Agent:** [OpenClaw 实时转写插件](integrations/openclaw/) 支持私有部署的 Talk 与 Voice Call 转写 · [Hugging Face speech-to-speech + SenseVoice](./docs/community_projects_zh.md#speech-to-speech)(已合入源码,v1.0.0 尚未包含)+> **接入语音 Agent:** [OpenClaw 实时转写插件](integrations/openclaw/#compatibility)(实验性;依赖尚未合并的上游 SDK 补丁)· [Hugging Face speech-to-speech + SenseVoice](./docs/community_projects_zh.md#speech-to-speech)(已合入源码,v1.0.0 尚未包含)### 为什么选 FunASR?diff --git a/docs/community_growth_20k.md b/docs/community_growth_20k.mdindex 9c72d1b4d..629da0769 100644--- a/docs/community_growth_20k.md+++ b/docs/community_growth_20k.md@@ -101,6 +101,8 @@ As of 2026-09-05 05:27 UTC, the ecosystem has 37,164 combined GitHub stars, or 5- The remaining package-boundary review finding was addressed on signed+DCO head `d2e9e8803a90b13a0a9816f2afb37a6c64aaa0e2`. Fresh local evidence passed the external package consumer, all 147 public Plugin SDK subpaths, the SDK surface budget, 21 package-contract tests, formatting, and `git diff --check`.- Exact-head GitHub CI completed with 154 successful, 39 skipped, and one neutral check, zero failures, and zero unresolved review threads. The permanent public SDK boundary still requires an OpenClaw maintainer decision.+**2026-10-31 disposition:** #118977 was closed without merging. The [closing bot comment](https://github.com/openclaw/openclaw/pull/118977#issuecomment-6542645321) reports no demonstrated bundled-provider need for the proposed public SDK surface. The August validation above is historical; this is not a merged integration or adoption result. The [local plugin remains experimental](../integrations/openclaw/README.md#compatibility) and still requires the unmerged SDK patch.+### 2026-08-17 Fun-ASR-Nano checkpoint owner handoff- FunASR issue [#3496](https://github.com/modelscope/FunASR/issues/3496) was routed to `LauraGPT` and `pengzhendong`, the two maintainers with direct write access to `QwenAudio/Fun-ASR`. The issue blocks the Hugging Face checkpoint path because 86 CTC tensors are absent there, while the complete ModelScope artifact is available and integrity-checked.diff --git a/integrations/openclaw/README.md b/integrations/openclaw/README.mdindex 76e8d0e01..194704669 100644--- a/integrations/openclaw/README.md+++ b/integrations/openclaw/README.md@@ -1,6 +1,6 @@# FunASR for OpenClaw-`openclaw-funasr` connects OpenClaw Talk and Voice Call to a self-hosted+`openclaw-funasr` is an experimental adapter connecting OpenClaw Talk and Voice Call to a self-hosted[FunASR](https://github.com/modelscope/FunASR) WebSocket server. Audio stays oninfrastructure you control.@@ -14,11 +14,18 @@ infrastructure you control.## Compatibility-The first release requires OpenClaw `>=2026.7.2` with-[openclaw/openclaw#118977](https://github.com/openclaw/openclaw/pull/118977).-Publishing to npm and ClawHub is intentionally gated on that SDK change landing-in an OpenClaw release; the compatibility floor will be pinned to the exact-release before publication.+On 2026-10-31, [openclaw/openclaw#118977](https://github.com/openclaw/openclaw/pull/118977)+was closed without merging. This adapter still requires that experimental SDK+patch; the declared `>=2026.7.2` range is not a supported stock-install compatibility floor.+No supported released OpenClaw version has been established by the validation below.++The build, test, installation, and configuration instructions below apply only+to a development checkout containing that patch. They are not a setup recipe+for an unmodified OpenClaw release.++Publishing to npm and ClawHub remains blocked pending an accepted and released upstream SDK contract.+The exact compatible release and its behavior must be validated before publication;+the historical local proof does not remove this requirement.## Start FunASR@@ -45,7 +52,7 @@ suite exercises the real shared WebSocket session helper, including protocolnegotiation, audio conversion, 60 ms framing, finalization, reconnect handling,bounded transcript state, and package metadata.-Install the packed artifact before publication:+Install the packed artifact in that experimental checkout only:```bashopenclaw plugins install npm-pack:/absolute/path/to/openclaw-funasr-0.1.0.tgz --force@@ -97,6 +104,9 @@ Embedded credentials in `baseUrl` are rejected. Use `apiKey` or## Verified behavior+The following is historical local protocol proof with the required SDK patch,+not validation of a released OpenClaw installation.+The end-to-end proof used the official FunASR server, a public 5.55 second16 kHz sample converted to the same 8 kHz mu-law frames emitted by OpenClaw,and the plugin's production adapter. It streamed 278 audio frames, produceddiff --git a/tests/test_community_projects_entries.py b/tests/test_community_projects_entries.pyindex 28c76a8c6..3fd0e5283 100644--- a/tests/test_community_projects_entries.py+++ b/tests/test_community_projects_entries.py@@ -53,3 +53,42 @@ def test_speech_to_speech_source_install_is_discoverable_and_release_bounded():if "`huggingface/speech-to-speech#319`" in line)assert revision in row and "Merged" in rowassert "Wait for maintainer review" not in row+++def test_openclaw_readme_entrypoints_disclose_unmerged_sdk_requirement():+ for suffix, marker in (("", "experimental; requires an unmerged upstream SDK patch"),+ ("_zh", "\u5b9e\u9a8c\u6027\uff1b\u4f9d\u8d56\u5c1a\u672a\u5408\u5e76\u7684\u4e0a\u6e38 SDK \u8865\u4e01")):+ text = (ROOT / f"README{suffix}.md").read_text(encoding="utf-8")+ entry = next(line for line in text.splitlines() if "integrations/openclaw/" in line)+ assert "integrations/openclaw/#compatibility" in entry+ assert marker in entry+++def test_openclaw_compatibility_records_closed_unmerged_dependency():+ text = (ROOT / "integrations/openclaw/README.md").read_text()+ compatibility = text.split("## Compatibility", 1)[1].split("\n## ", 1)[0]+ assert "2026-10-31" in compatibility+ assert "closed without merging" in compatibility+ assert "https://github.com/openclaw/openclaw/pull/118977" in compatibility+ assert "not a supported stock-install compatibility floor" in compatibility+ assert "npm and ClawHub" in compatibility+ assert "accepted and released upstream SDK contract" in compatibility+++def test_openclaw_protocol_proof_is_not_released_host_acceptance():+ text = (ROOT / "integrations/openclaw/README.md").read_text()+ proof = text.split("## Verified behavior", 1)[1].split("\n## ", 1)[0]+ assert "historical local protocol proof" in proof+ assert "not validation of a released OpenClaw installation" in proof+ assert "278 audio frames" in proof+ assert "seven partial transcripts" in proof+++def test_openclaw_growth_record_keeps_history_and_current_disposition_separate():+ text = (ROOT / "docs/community_growth_20k.md").read_text()+ section = text.split("### 2026-08-16 OpenClaw", 1)[1].split("\n### ", 1)[0]+ assert "154 successful, 39 skipped" in section+ assert "2026-10-31 disposition" in section+ assert "closed without merging" in section+ assert "#issuecomment-6542645321" in section+ assert "not a merged integration or adoption result" in section