workbuddy远程频繁断连主因是tcp keepalive间隔过长致中间设备清空连接，可通过四种方式优化：一、修改claw配置文件tcp_keepalive参数；二、企微机器人会话中启用短周期应用层心跳；三、sysctl全局调优系统tcp keepalive内核参数；四、启动claw时动态注入套接字keepalive选项。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果WorkBuddy在远程执行过程中频繁自动断开连接，则可能是由于TCP Keepalive心跳间隔设置过长，导致中间网络设备（如NAT网关、防火墙）主动清除空闲连接。以下是优化KeepAlive心跳间隔的多种方法：
一、调整WorkBuddy客户端内置Claw模块的Keepalive参数
该方法直接修改WorkBuddy所依赖的Claw通信层心跳行为，适用于本地部署场景，无需系统级权限，影响范围仅限当前客户端实例。
1、打开WorkBuddy安装目录下的配置文件：%APPDATA%\WorkBuddy\claw\config.yml（Windows）或~/Library/Application Support/WorkBuddy/claw/config.yml（macOS）。
2、定位到tcp_keepalive配置段，将原有参数替换为以下值：
3、设置idle: 300（空闲5分钟即发起首次探测）。
4、设置interval: 20（每次探测间隔20秒）。
5、设置probes: 5（连续5次无响应才判定连接失效）。
6、保存文件后，重启WorkBuddy主程序使配置生效。
二、在企业微信机器人会话中启用短周期健康检查
该方法利用WorkBuddy与企微机器人之间的应用层心跳机制，通过高频指令触发状态校验，绕过底层TCP超时限制，适用于网络环境不可控但企微通道稳定的场景。
1、在企业微信中进入已绑定的WorkBuddy机器人对话窗口。
2、发送指令：/keepalive 30（数字30表示每30秒发起一次轻量级状态探针）。
3、确认收到绿色反馈：“应用层心跳已激活，周期30s”。
4、观察后续任务执行中Claw状态栏是否持续显示蓝色脉动，而非间歇性变灰。
腾讯云代码助手CodeBuddy旗下WorkBuddy 4.24.8版本正式发布。本版本重点修复了上下文压缩异常、冷加载时偶现历史消息丢失、任务停止卡死等问题，并深度优化了Windows沙箱(lightSandbox)的日志写入与误弹窗逻辑，提供更安全稳定的AI协作体验。
三、通过sysctl全局调优系统TCP Keepalive行为
该方法作用于操作系统内核层面，统一影响所有启用SO_KEEPALIVE的进程（含WorkBuddy后台服务），适用于WorkBuddy以系统服务方式运行的桌面环境。
1、以管理员身份打开终端（Windows PowerShell或macOS Terminal）。
2、执行命令查看当前值：cat /proc/sys/net/ipv4/tcp_keepalive_time（Linux）或使用等效命令获取当前参数（macOS需通过sysctl net.inet.tcp.keepidle等）。
3、将空闲启动时间设为300秒：sudo sysctl -w net.ipv4.tcp_keepalive_time=300（Linux）或sudo sysctl -w net.inet.tcp.keepidle=300000（macOS，单位毫秒）。
4、将探测间隔设为15秒：sudo sysctl -w net.ipv4.tcp_keepalive_intvl=15（Linux）或sudo sysctl -w net.inet.tcp.keepintvl=15000（macOS）。
5、将最大探测次数设为6：sudo sysctl -w net.ipv4.tcp_keepalive_probes=6（Linux）或sudo sysctl -w net.inet.tcp.keepcnt=6（macOS）。
四、在Claw服务启动时动态注入Keepalive套接字选项
该方法通过启动参数强制为Claw监听套接字设置精细心跳参数，不依赖系统默认值，适合多用户共用一台主机且需差异化配置的场景。
1、关闭正在运行的WorkBuddy客户端。
2、在命令行中切换至WorkBuddy安装目录，执行带参数的启动命令：
3、Windows示例：WorkBuddy.exe --claw-keepalive-idle=300 --claw-keepalive-intvl=20 --claw-keepalive-probes=5。
4、macOS/Linux示例：./WorkBuddy --claw-keepalive-idle=300 --claw-keepalive-intvl=20 --claw-keepalive-probes=5。
5、确认启动日志中出现“Claw TCP keepalive configured: idle=300s, intvl=20s, probes=5”字样。
