Docs: update zh-CN translations and pipeline

What:
- update zh-CN glossary, TM, and translator prompt
- regenerate zh-CN docs and apply targeted fixes
- add zh-CN AGENTS pipeline guidance

Why:
- address terminology/spacing feedback from #6995

Tests:
- pnpm build && pnpm check && pnpm test
This commit is contained in:
Josh Palmer
2026-02-03 13:23:00 -08:00
parent 9f03791aa9
commit a3ec2d0734
228 changed files with 10651 additions and 10475 deletions
+35 -35
View File
@@ -1,11 +1,11 @@
---
read_when:
- 你想通过 OpenClaw 发起外呼语音通话
- 你正在配置或开发语音通话插件
summary: 语音通话插件:通过 Twilio/Telnyx/Plivo 进行外呼和来电(插件安装 + 配置 + CLI
title: 语音通话插件
- 你想 OpenClaw 发起出站语音通话
- 你正在配置或开发 voice-call 插件
summary: Voice Call 插件:通过 Twilio/Telnyx/Plivo 进行出站 + 入站通话(插件安装 + 配置 + CLI
title: Voice Call 插件
x-i18n:
generated_at: "2026-02-01T21:34:37Z"
generated_at: "2026-02-03T07:53:40Z"
model: claude-opus-4-5
provider: pi
source_hash: d731c63bf52781cc49262db550d0507d7fc33e5e7ce5d87efaf5d44aedcafef7
@@ -13,48 +13,48 @@ x-i18n:
workflow: 15
---
# 语音通话(插件)
# Voice Call(插件)
通过插件为 OpenClaw 提供语音通话功能。支持外呼通知和多轮对话的来电策略
通过插件为 OpenClaw 提供语音通话。支持出站通知和带有入站策略的多轮对话。
当前支持的提供商:
当前提供商:
- `twilio`Programmable Voice + Media Streams
- `telnyx`Call Control v2
- `plivo`Voice API + XML transfer + GetInput speech
- `mock`(开发环境/无网络)
- `mock`(开发/无网络)
快速理解模型:
快速心智模型:
- 安装插件
- 重启 Gateway网关
-`plugins.entries.voice-call.config`进行配置
- 重启 Gateway 网关
-`plugins.entries.voice-call.config` 下配置
- 使用 `openclaw voicecall ...``voice_call` 工具
## 运行位置(本地 vs 远程)
语音通话插件运行在 **Gateway网关进程内部**
Voice Call 插件运行在 **Gateway 网关进程内部**
如果你使用远程 Gateway网关,在**运行 Gateway网关的机器**上安装配置插件,然后重启 Gateway网关以加载它。
如果你使用远程 Gateway 网关,在**运行 Gateway 网关的机器**上安装/配置插件,然后重启 Gateway 网关以加载它。
## 安装
### 方式 A:从 npm 安装(推荐)
### 选项 A:从 npm 安装(推荐)
```bash
openclaw plugins install @openclaw/voice-call
```
安装后重启 Gateway网关。
后重启 Gateway 网关。
### 方式 B:从本地文件夹安装(开发环境,不复制文件
### 选项 B:从本地文件夹安装(开发,不复制)
```bash
openclaw plugins install ./extensions/voice-call
cd ./extensions/voice-call && pnpm install
```
安装后重启 Gateway网关。
后重启 Gateway 网关。
## 配置
@@ -87,7 +87,7 @@ cd ./extensions/voice-call && pnpm install
path: "/voice/webhook",
},
// 公暴露(选择其一)
// 公暴露(选一
// publicUrl: "https://example.ngrok.app/voice/webhook",
// tunnel: { provider: "ngrok" },
// tailscale: { mode: "funnel", path: "/voice/webhook" }
@@ -109,17 +109,17 @@ cd ./extensions/voice-call && pnpm install
注意事项:
- Twilio/Telnyx 需要一个**可公访问** webhook URL。
- Plivo 需要一个**可公访问** webhook URL。
- `mock` 是本地开发提供商(不进行网络调用)。
- Twilio/Telnyx 需要**可公访问** webhook URL。
- Plivo 需要**可公访问** webhook URL。
- `mock` 是本地开发提供商(网络调用)。
- `skipSignatureVerification` 仅用于本地测试。
- 如果你使用 ngrok 免费版,`publicUrl` 设置为确的 ngrok URL;签名验证始终强制执行。
- `tunnel.allowNgrokFreeTierLoopbackBypass: true` 允许 `tunnel.provider="ngrok"``serve.bind` 为 local loopbackngrok 本地代理)时,接受签名无效的 Twilio webhook。**仅用于本地开发**
- Ngrok 免费版 URL 可能会变化或出现插页行为;如果 `publicUrl` 移,Twilio 签名将失败。生产环境建议使用稳定域名或 Tailscale funnel。
- 如果你使用 ngrok 免费版,将 `publicUrl` 设置为确的 ngrok URL;签名验证始终强制执行。
- `tunnel.allowNgrokFreeTierLoopbackBypass: true` 允许带有无效签名的 Twilio webhooks**仅当** `tunnel.provider="ngrok"``serve.bind` loopbackngrok 本地代理)时仅用于本地开发。
- Ngrok 免费版 URL 可能会更改或添加中间页面行为;如果 `publicUrl` 移,Twilio 签名将失败。对于生产环境,优先使用稳定域名或 Tailscale funnel。
## 通话的 TTS
语音通话使用核心 `messages.tts` 配置(OpenAI 或 ElevenLabs进行通话中的流式语音合成。你可以在插件配置下使用**相同的结构**进行覆盖——它会与 `messages.tts` 进行深度合并。
Voice Call 使用核心 `messages.tts` 配置(OpenAI 或 ElevenLabs)进行通话中的流式语音。你可以在插件配置下使用**相同的结构**覆盖——它会与 `messages.tts` 深度合并。
```json5
{
@@ -135,12 +135,12 @@ cd ./extensions/voice-call && pnpm install
注意事项:
- **语音通话忽略 Edge TTS**(电话音频需要 PCMEdge 输出不可靠)。
- 当启用 Twilio 媒体流时使用核心 TTS;否则通话回退到提供商原生语音。
- **语音通话忽略 Edge TTS**(电话音频需要 PCMEdge 输出不可靠)。
- 当启用 Twilio 媒体流时使用核心 TTS;否则通话回退到提供商原生语音。
### 更多示例
仅使用核心 TTS覆盖):
仅使用核心 TTS覆盖):
```json5
{
@@ -153,7 +153,7 @@ cd ./extensions/voice-call && pnpm install
}
```
仅为通话覆盖为 ElevenLabs(其他地方保持核心默认):
仅为通话覆盖为 ElevenLabs(其他地方保持核心默认):
```json5
{
@@ -197,9 +197,9 @@ cd ./extensions/voice-call && pnpm install
}
```
## 来电
## 入站通话
来电策略默认为 `disabled`。要启用来电,请设置:
入站策略默认为 `disabled`。要启用入站通话,设置:
```json5
{
@@ -209,7 +209,7 @@ cd ./extensions/voice-call && pnpm install
}
```
自动回复使用智能体系统。通过以下参数进行调优
自动响应使用智能体系统。通过以下方式调整
- `responseModel`
- `responseSystemPrompt`
@@ -239,9 +239,9 @@ openclaw voicecall expose --mode funnel
- `end_call`callId
- `get_status`callId
仓库附带了对应的 Skills 文档,位于 `skills/voice-call/SKILL.md`
仓库 `skills/voice-call/SKILL.md` 提供了配套的 skill 文档
## Gateway网关 RPC
## Gateway 网关 RPC
- `voicecall.initiate``to?``message``mode?`
- `voicecall.continue``callId``message`