OpenClaw zoom-meetings 插件详解:让 Agent 以 Chrome 访客身份加入 Zoom 会议 OpenClaw zoom-meetings 插件详解让 Agent 以 Chrome 访客身份加入 Zoom 会议【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw本文基于 OpenClaw 仓库中的插件参考文档 zoom-meetings 展开系统介绍openclaw/zoom-meetings插件的发行方式、安装配置、工具契约、完整配置参数表以及 Chrome 访客加入流程并结合 extensions/zoom-meetings 下的真实源码说明 URL 校验、网关超时推导与 CLI 命令的实现细节。读完本文你可以独立完成该插件的安装、配置、远端节点部署与加入验证并理解其底层运行契约。插件定位以 Chrome 浏览器访客身份参会参考文档对该插件的一句话定位是“Join Zoom meetings as a Chrome browser guest”以 Chrome 浏览器访客身份加入 Zoom 会议。插件的实际行为边界在 docs/plugins/zoom-meetings.md 中进一步明确支持zoom.us/j/...链接以及example.zoom.us/j/...这类企业账户子域名的会议邀请通过 OpenClaw Chrome profile 中的 Zoom Web App 以访客身份加入不创建会议、不电话拨入、不调用 Zoom Meeting SDK、不录制音视频。插件入口 index.ts 通过MeetingPlatformAdapter.createPluginShellEntry组装平台适配器、配置模式、工具参数、运行时、节点处理器与 CLI 注册全部由这一壳函数声明说明 Zoom 插件与 Google Meet、Microsoft Teams 插件共用同一套“会议运行时”基础设施详见 Meeting plugins。发行与安装参考文档给出的发行信息Distribution如下且与仓库内 package.json 的openclaw段完全一致项值源码依据插件 IDzoom-meetingsopenclaw.plugin.json包名openclaw/zoom-meetingspackage.json的name字段安装途径npm 或 ClawHubclawhub:openclaw/zoom-meetings默认途径为 npmpackage.json的openclaw.install最低宿主版本2026.7.2minHostVersion同上插件 API 兼容2026.9.4openclaw.compat.pluginApi同上默认启用是enabledByDefault: trueopenclaw.plugin.json当前包版本2026.9.4package.json安装命令来自插件 README 与 Meeting plugins 指南openclaw plugins install openclaw/zoom-meetings openclaw gateway restart安装或更新插件后必须重启 Gateway。openclaw.plugin.json的activation段声明了插件的激活条件启动时激活onStartup、执行zoommeetings命令时激活以及具备tool能力时激活。若某个环境不需要该插件可以用openclaw plugins disable zoom-meetings禁用。SurfaceCLI 命令、工具与转写契约参考文档Surface 一节声明了该插件对外暴露的两类契约源码可逐条印证CLI 命令openclaw zoommeetingsopenclaw.plugin.json注册了名为zoommeetings的 CLI 命令描述为 “Join and manage Zoom meeting guests”且带子命令。src/cli-output-mode.ts 中的machineOutput逻辑保证“只有openclaw zoommeetings 子命令两级路径才走机器可读输出模式”并且注释明确说明无关命令的元数据发现不应加载会议运行时即 CLI 元数据是惰性的不会拖慢其他命令的启动。日常最常用的两个子命令来自 Meeting plugins 的验证表# 环境自检Chrome profile、音频后端等 openclaw zoommeetings setup # 以访客身份加入会议 openclaw zoommeetings join https://zoom.us/j/1234567890工具契约zoom_meetingscontracts中tools声明了唯一工具zoom_meetings其参数模式在 index.ts 中用 TypeBox 定义共 7 个参数参数类型/取值说明actionjoin|leave|status|transcript|speak必填操作类型urlstringZoom 会议 URL可选join 时使用transportchrome|chrome-node可选本地 Chrome 或配对节点上的 Chromemodeagent|bidi|transcribe可选参与模式sessionIdstringZoom 会议会话 IDsinceIndexinteger≥0从该索引续读转写messagestringspeak时要说的内容/指示transcriptSourceProviders契约声明了转写源 IDzoom别名zoom-meetings这意味着浏览器加入过程中持久化的字幕行与派生摘要会进入共享状态数据库可通过openclaw transcripts列出、查看或导出。此外index.ts 中resolveToolRuntime会先检查 Gateway 是否可用不可用时抛出 “Zoom meeting tools require a Gateway-hosted agent run.”——即该工具必须运行在 Gateway 托管的 agent 上下文中不能在纯本地无 Gateway 环境调用。配置参考configSchema全参数openclaw.plugin.json中的configSchema严格禁止额外属性additionalProperties: false。完整参数如下参数类型/取值默认说明enabledboolean—插件开关defaultModeagent|bidi|transcribeagent默认参与模式chrome.audioBackendauto|blackhole-2ch|pipewire-pulseauto虚拟音频后端macOS 自动选 BlackHole 2chLinux 自动选 PipeWire-Pulse见uiHints帮助文本chrome.audioFormatpcm16-24khz|g711-ulaw-8khzpcm16-24khz音频编码格式chrome.audioBufferBytesnumber≥17—音频缓冲字节数chrome.launchboolean—是否自动启动 Chromechrome.browserProfilestring—使用的 OpenClaw 浏览器 profilechrome.guestNamestring—访客显示名填入 prejoin 页chrome.reuseExistingTabboolean—复用已有标签页chrome.autoJoinboolean—自动加入chrome.joinTimeoutMsnumber≥1—加入超时chrome.waitForInCallMsnumber≥1—等待进入会中的超时chrome.audioInputCommand/chrome.audioOutputCommandstring[]—自定义音频输入/输出命令chrome.bargeInInputCommandstring[]—打断检测的输入命令chrome.bargeInRmsThreshold/chrome.bargeInPeakThresholdnumber0—打断 RMS/峰值阈值chrome.bargeInCooldownMsnumber≥1—打断冷却时间chromeNode.nodestring—拥有 Chrome 与原生虚拟音频后端的配对节点 ID/名称/IPrealtime.strategyagent|bidi—实时策略realtime.providerstring—实时提供商realtime.transcriptionProviderstring—agent模式使用的实时转写提供商realtime.voiceProviderstring—bidi模式使用的双向语音提供商realtime.modelstring—实时模型覆盖realtime.instructionsstring—实时系统指示realtime.introMessagestring—入会自我介绍消息realtime.agentIdstring—agent模式咨询的 agentrealtime.toolPolicysafe-read-only|owner|none—实时工具策略realtime.providersobject—各提供商的覆盖配置uiHints中把browserProfile、waitForInCallMs、audioInputCommand、audioOutputCommand、chromeNode.node、realtime.model、realtime.instructions、realtime.agentId、realtime.toolPolicy标记为advanced高级选项控制界面默认隐藏而defaultMode的帮助文本概括了三种模式的分工“Agent consults OpenClaw, bidi uses direct realtime voice, and transcribe observes only.”配置示例Meeting plugins 给出的 Zoom 配置写法entry id 为zoom-meetings省略chromeNode时 Chrome 运行在 Gateway 宿主机上{ plugins: { entries: { zoom-meetings: { config: { defaultMode: agent, chrome: { guestName: OpenClaw Agent }, chromeNode: { node: meeting-node }, }, }, }, }, }网关操作超时的推导逻辑src/config.ts 中resolveGatewayOperationTimeoutMs展示了超时的实际计算方式取 60 秒下限并对joinTimeoutMs waitForInCallMs 30 秒余量外加定时器宽限取最大值。也就是说如果你在配置里拉大了joinTimeoutMs或waitForInCallMsGateway 侧等待该工具返回的超时会随之自动放大无需单独配置。同一文件还定义了默认的实时指令defaultRealtimeInstructions以 OpenClaw 语音传输身份加入私有 Zoom 会议agent模式下等待咨询结果并原样复述bidi模式下直接应答并可用咨询工具做深度推理。会议 URL 的严格校验规则插件对会议 URL 有硬性约束。src/transports/zoom-meetings-urls.ts 中的parseZoomMeetingIdentity定义了合法链接的全部条件协议必须是https:且不允许自定义端口、用户名、密码主机名必须是zoom.us或以.zoom.us结尾isZoomHostname路径匹配两种形态之一邀请链接/j/meeting-id会议号为9~11 位数字Web 客户端链接仅app.zoom.us下的/wc/meeting-id/join查询参数?pwd会被解析为会议口令passcode。normalizeZoomMeetingUrl在链接不合法时抛出Zoom meeting URL must use https://account.zoom.us/j/meeting-id合法则剥离 fragment 后规范化输出。从源码结构看kind区分invitation与web-clientnormalizeZoomMeetingUrlForReuse则用于判断两个 URL 是否指向同一会议复用标签页场景。Chrome 访客加入流程与 Zoom 策略处理docs/plugins/zoom-meetings.md 描述了浏览器适配器的实际操作序列选择Join from browser→ 填写访客名 → 关闭摄像头 → 配置麦克风 → 点击Join并且在导航前为app.zoom.us源预先授予麦克风与扬声器选择权限会中状态检测依赖 Zoom 的 Leave 控件。需要特别理解的一点是插件与平台策略的关系Zoom 账户可以禁用浏览器加入、要求登录、邮箱验证、口令、CAPTCHA、主持人准入或设备权限插件遇到这些情况时不会绕过而是在结果中报告manualAction操作者需要在同一个OpenClaw Chrome profile 中手动完成所请求的步骤然后重试status或语音操作反复新开标签页无法解决账户、租户、等候室或 CAPTCHA 拦截。文档同时记录了验证状态Zoom Web App 在 2026.8.1 版本通过官方测试会议做过实机验证interstitial 页、iframe 内访客名输入、麦克风/摄像头控制、浏览器与 macOS 媒体权限、会中检测、实时字幕、主持人结束检测当等候室与认证状态下没有稳定的 DOM 标识符时保留文本回退方案。三种参与模式与音频要求Zoom、Google Meet、Teams 三个会议插件共享同一组模式见 Meeting plugins模式行为音频要求agent实时转写给配置的 OpenClaw agent常规 OpenClaw TTS 朗读回复Chrome 回话需要受支持的虚拟音频后端bidi实时语音模型直接监听并应答同上transcribe只读观察在平台提供字幕时暴露有界实时字幕转写不需要虚拟音频桥选择建议只需要会议文本用transcribe需要常规 OpenClaw 推理与工具用agent低延迟直接语音优先于每轮走 agent 时用bidi。三种模式下浏览器加入都会把已完成的字幕行与派生摘要持久化到共享状态数据库transcripts.enabled: false可全局关闭持久化笔记。agent/bidi模式的 Chrome 回话还依赖宿主上的虚拟音频设施macOS 安装blackhole-2ch与soxLinux 桌面使用 PipeWire-Pulse 并安装pulseaudio-utils。远端 Chrome 节点必须放行browser.proxy与平台命令zoommeetings.chrome这是 Zoom 插件的专属节点命令对应openclaw.plugin.json中chromeNode配置所指向的节点。Gateway 宿主始终拥有 agent 与模型凭据——即使 Chrome 跑在配对节点上。验证与排障推荐流程是先运行openclaw zoommeetings setup做环境自检把任何失败的自检项视为对应传输/模式的阻塞项然后用transcribe模式做只读冒烟测试确认status报告处于会中会话后再期待字幕文本。回话talk-back冒烟测试中插件以有界波形指纹关联当前输出代际与虚拟麦克风回采的音频只有真实语音路径走通才会报告speechOutputVerified: true——仅输出字节计数增长或被他人音频污染都不算通过。相关文档Zoom meetings 插件指南Meeting plugins 共享指南安装、模式、Chrome 与虚拟音频、转写、远端节点与验证插件源码目录extensions/zoom-meetings【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考