当workbuddy并发连接达上限时,可通过三类方案优化:一、部署claw多实例集群并用nginx/traefik反向代理分流;二、启用workbuddy v2.4.1+内置分布式credits共享池;三、基于平台优先级实施动态限流与自动降级。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您在使用WorkBuddy时遭遇并发连接数触及上限,导致多IM平台掉线、定时任务排队或Agent调用被拒,则可能是当前单实例资源调度能力已达瓶颈。以下是通过负载均衡策略优化额度分配的多种可行方案:
一、部署Claw多实例集群并配置反向代理分流
该方法将单一Claw沙箱实例拆分为多个独立运行的副本,由Nginx或Traefik统一接收外部WebSocket/HTTP请求,并依据连接ID哈希或平台类型实现会话亲和性路由,从而在不突破单实例配额前提下成倍扩展整体连接容量。
1、在本地不同端口启动三个Claw沙箱实例:执行claw-server --port=9001 --instance-id=wechat、claw-server --port=9002 --instance-id=dingtalk、claw-server --port=9003 --instance-id=feishu。
2、编辑Nginx配置文件/etc/nginx/conf.d/workbuddy-balancer.conf,添加upstream块定义三节点组,并配置map指令按请求头X-Platform匹配路由规则。
3、启用session_sticky模块确保同一企业微信用户的长连接始终转发至相同后端实例,避免状态丢失。
4、重启Nginx服务:sudo systemctl restart nginx,并在WorkBuddy客户端设置中将Claw地址改为http://localhost:8080(即Nginx监听地址)。
二、启用WorkBuddy内置的跨实例Credits共享池
WorkBuddy v2.4.1起支持多客户端实例间Credits动态调配,通过中央配额协调器实时监控各实例消耗速率,在某实例临近阈值时自动从空闲实例划拨额度,维持整体服务连续性,无需修改代码或重写调度逻辑。
1、确保所有待接入的WorkBuddy桌面客户端版本均为2.4.1或更高,可通过右上角「关于」页确认。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表,就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
2、在任一主控客户端中进入【账户与配额】→【高级设置】,开启「启用分布式配额协同」开关。
3、点击「生成集群密钥」,复制生成的32位十六进制密钥字符串。
4、在其余客户端的同一设置页中粘贴该密钥,点击「加入配额集群」,各实例状态栏将同步显示「共享池已激活」。
三、基于平台优先级实施动态连接数限流与升降级
该策略不增加物理资源,而是通过运行时策略引擎对不同IM平台连接施加差异化QoS控制:高优先级平台(如企业微信)保底连接数不低于800,低优先级平台(如QQ)允许在总配额紧张时自动收缩至200以下,从而保障核心业务通道稳定性。
1、打开Claw设置中心,进入「连接策略」页签,启用「智能平台分级限流」。
2、在平台列表中,为「企业微信」设置最低保障连接数为<strong><font color="green">800</font></strong>,最高弹性上限为<strong><font color="green">1200</font></strong>;为「QQ」设置最低保障为<strong><font color="green">100</font></strong>,最高上限为<strong><font color="green">400</font></strong>。
3、勾选「启用自动降级触发条件」,设定当总连接数达<strong><font color="green">2500</font></strong>时,系统自动削减低优先级平台心跳频率与重连尝试次数。
4、保存配置后,点击「立即应用策略」,Claw内核将在3秒内完成连接数重分布。










