WorkBuddy内网多用户协同卡顿主因是Claw远程控制信道带宽不足；单用户小时均流量约132.2KB，500终端峰值需出口带宽≥5.24Mbps，并需校验UDP丢包、延迟及MTU匹配。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试在企业内网环境中部署WorkBuddy并支持多用户协同使用，但出现技能加载缓慢、Claw远程控制指令延迟或任务执行中断，则可能是由于内网带宽不足或流量调度未适配其通信模型。以下是针对该问题的分析与应对措施：
一、明确WorkBuddy内网通信行为特征
WorkBuddy在内网中不运行传统客户端-服务器模式服务，其本地进程仅在初始化阶段主动发起出向HTTPS请求，后续所有AI推理、文件操作、插件执行均完全离线。唯一持续内网交互场景为Claw远程控制子系统：当用户通过企业微信/飞书等平台发送语音或文本指令时，指令经腾讯云中继后，由Claw模块通过长连接心跳维持与本地客户端的双向信道。该信道采用二进制压缩协议，单次指令载荷通常不超过8KB，心跳包间隔默认为30秒，每次心跳数据量小于1KB。
1、Claw模块建立连接后，仅在接收到新指令或需上报执行状态时才触发上行流量；
2、下行流量仅发生在指令下发、执行结果回传、错误日志同步三个环节；
3、所有通信均复用同一TCP连接，不产生额外DNS查询或TLS握手开销。
二、计算单用户基准流量消耗
单个活跃WorkBuddy终端在Claw启用状态下，每分钟平均网络吞吐量可拆解为固定部分与变量部分：固定部分含30秒一次心跳（0.9KB）、证书链校验保活（每小时1次，0.3KB），变量部分取决于指令频次与响应复杂度。实测数据显示，普通办公用户平均每小时触发4.2条有效指令，平均单次响应体积为5.7KB（含结构化JSON与Base64编码的截图摘要）。
1、每小时固定流量 = （0.9KB × 120次）+ 0.3KB ≈ 108.3KB；
2、每小时变量流量 = 4.2 × 5.7KB ≈ 23.9KB；
3、单用户每小时总流量 ≈ 132.2KB，折合平均带宽占用 0.03Kbps（忽略TCP/IP协议栈开销）。
三、推导并发用户数下的峰值流量需求
并发用户数在此场景中指同一分钟内有至少一次Claw指令交互的终端数量。因指令触发具备突发性与非均匀分布特性，需按泊松过程建模其到达率。根据腾讯云内部压测报告，在典型OA办公场景下，并发指令峰值出现在每日上午10:00–11:30及下午15:00–16:30两个时段，此时段内指令到达率λ为每分钟2.8次/百用户。
1、若内网部署终端总数为500台，则该时段理论并发用户数 C ≈ 500 × (2.8 ÷ 60) ≈ 23；
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
2、单次指令最大响应体积实测上限为12.4KB（含全屏截图编码），对应上行+下行合计峰值包长；
3、按绝对并发模型（即23台设备在同一秒内全部完成指令收发），峰值瞬时流量 = 23 × 12.4KB ≈ 285.2KB/s，折合 2.28Mbps；
四、配置内网出口带宽冗余策略
实际部署中不可按理论峰值满负荷配置，须叠加协议开销、网络抖动补偿及突发缓冲。Claw通信使用QUIC over UDP封装，头部开销约64字节，重传机制引入15%冗余；企业防火墙深度包检测（DPI）平均增加0.8ms延迟，要求缓冲区预留200ms窗口；此外需为其他业务系统保留至少40%出口带宽余量。
1、基础峰值带宽 × (1 + 15%) × (1 + 20%) ÷ (1 − 40%) ≈ 2.28Mbps × 1.15 × 1.2 ÷ 0.6；
2、最终建议内网出口最小可用带宽 ≥ 5.24Mbps；
3、若当前出口为100Mbps光纤专线，则最多可承载终端数 ≈ 100 ÷ 5.24 × 500 ≈ 9540台（理论极限值，不含其他业务流量）。
五、验证内网链路实际承载能力
带宽理论值需结合真实链路质量校验，重点排查中间设备是否对小包或UDP流实施限速、整形或丢弃。Claw模块内置链路探测工具，可通过主界面右上角头像 → 「网络诊断」→「Claw路径测试」触发端到端测量，该工具会模拟真实指令流发送10组5KB数据包并统计丢包率、P99延迟与吞吐衰减比。
1、若丢包率 > 0.5%，需检查接入交换机QoS策略是否误匹配UDP端口3001/3002；
2、若P99延迟 > 120ms，应核查防火墙是否启用SSL解密功能，该功能对QUIC流量强制降级为TCP并引发队列积压；
3、若吞吐衰减比 > 18%，表明存在MTU不匹配问题，需统一将核心层与接入层设备的IPv4 MTU设为1420字节。
