文件描述符限制过低会导致workbuddy多im连接异常、连接拒绝及claw沙箱初始化失败；需依次检查并调高shell会话、进程级、内核级fd限制，支持临时验证与永久配置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在安装WorkBuddy后发现无法维持多个IM平台长连接、频繁出现“连接拒绝”或Claw沙箱初始化失败，则很可能是系统级文件描述符（File Descriptor）限制过低所致。以下是检查与优化并发连接限制的具体操作步骤：
一、检查当前Shell会话的文件描述符限制
该步骤用于确认当前终端环境是否已受默认限制约束，是定位瓶颈的第一环。Linux/macOS系统默认软限制常为1024，远低于WorkBuddy多平台满载所需的连接数。
1、打开终端，执行命令查看当前软限制值：ulimit -n
2、执行命令查看当前硬限制值：ulimit -Hn
3、若两项返回值均≤1024，说明限制已构成实际瓶颈，需立即调整。
二、检查WorkBuddy进程实际使用的文件句柄数
该步骤用于验证客户端运行时真实资源占用情况，排除配置未生效或进程继承错误限制的可能。仅查看全局设置不足以反映实际运行态限制。
1、启动WorkBuddy桌面客户端，并确保其处于在线状态。
2、在终端中执行命令获取WorkBuddy主进程PID：pgrep -f "WorkBuddy.*electron"
3、将上一步获取的PID代入以下命令，查看该进程当前打开的文件句柄数量：ls -1 /proc/[PID]/fd | wc -l
4、若输出值持续接近或等于
三、检查内核级全局文件句柄容量
该步骤用于确认操作系统底层是否具备支撑高并发连接的资源池容量。即使用户级限制已调高，若内核file-max值过低，仍会在高负载下触发分配失败。
1、执行命令查看当前系统可分配的最大文件句柄总数：cat /proc/sys/fs/file-max
2、执行命令查看单个进程可申请的最大句柄上限：cat /proc/sys/fs/nr_open
3、若两项数值均低于65535，需同步调整内核参数以匹配WorkBuddy高并发需求。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
四、临时提升当前会话限制以快速验证
该方法不修改系统持久配置，仅对当前终端及其派生进程生效，适用于快速判断问题是否由FD限制引发，且无需重启服务或系统。
1、在已打开的终端中执行命令，将软硬限制均设为65535：ulimit -n 65535 && ulimit -Hn 65535
2、验证设置是否成功：ulimit -Sn 与 ulimit -Hn 应均显示65535
3、关闭当前WorkBuddy进程，再从此终端中重新启动客户端。
4、观察Claw连接状态是否恢复稳定，若连接数显著提升，即可确认原因为FD限制。
五、永久修改用户级文件描述符限制
该配置通过PAM模块生效，确保所有以该用户身份启动的会话（包括systemd服务、SSH登录、GUI终端）自动加载新限制，适用于WorkBuddy以普通用户或专用服务账户长期运行的场景。
1、使用root权限编辑limits配置文件：sudo vim /etc/security/limits.conf
2、在文件末尾新增四行配置：* soft nofile 65535
3、* hard nofile 65535
4、* soft nproc 65535
5、* hard nproc 65535
6、保存并退出编辑器，完全退出当前用户会话（非仅关闭终端），重新登录系统。
7、再次执行
