WorkBuddy要求内核版本不低于5.4且为标准发行版内核；低于该版本或含-rt/-xen等后缀需升级或启用降级模式，同时须确认overlay、user_namespaces、seccomp模块已加载。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试在 Linux 系统上安装或运行 WorkBuddy，但启动失败或服务异常退出，则可能是由于内核版本不满足最低运行门槛。以下是针对内核版本要求的详细核查与适配操作：
一、确认官方支持的内核版本范围
WorkBuddy 仅兼容特定 Linux 内核 ABI 接口，低于阈值将导致二进制加载失败、Claw 子系统无法初始化或沙箱崩溃。官方明确要求内核版本不低于 5.4，且必须为标准发行版内核（非 RT、LTS-extended 或自编译裁剪版）。
1、打开终端，执行 uname -r 命令，查看当前运行的内核版本号。
2、若输出为 4.19.0-25-amd64 或 5.3.18-lp152.106-default 等低于 5.4 的版本，即不满足基础兼容性。
3、若输出含 -rt、-xen、-edge 等后缀，需进一步验证是否通过 ABI 兼容性测试，不可直接认定可用。
二、升级至兼容内核的操作路径
对于 Ubuntu/Debian/CentOS Stream 等受支持发行版，应优先采用发行版官方仓库提供的标准内核包，避免手动编译引入符号缺失风险。
1、Ubuntu 20.04 用户执行 sudo apt update && sudo apt install --install-recommends linux-generic-hwe-20.04，安装 HWE 内核栈（默认含 5.15+）。
2、Ubuntu 22.04 用户运行 sudo apt install linux-generic-hwe-22.04，获取长期支持的 6.2+ 内核。
3、CentOS Stream 9 用户执行 sudo dnf upgrade kernel-core，确保 kernel-core 版本 ≥ 5.14.0-70.13.1.el9_0（该版本为 Stream 9 最小兼容基线）。
4、升级完成后重启系统，并再次运行 uname -r 验证新内核已激活。
三、绕过内核限制的临时兼容方案
当无法升级内核（如嵌入式设备、云主机受限镜像），可启用 WorkBuddy 的降级运行模式，牺牲部分本地沙箱功能以维持主引擎可用。
1、在安装目录下创建空文件 .disable_sandbox（注意开头为英文点号）。
2、设置环境变量 export WB_SKIP_KERNEL_CHECK=1，并在启动脚本中持久化该变量。
3、以非 root 用户身份运行 ./workbuddy --no-sandbox --disable-gpu 启动客户端。
4、此时 Claw 远程控制模块、屏幕内容识别及文件系统深度监控将被禁用，仅保留本地命令执行与 API 调用能力。
四、验证内核模块加载状态
WorkBuddy 启动时依赖若干内核模块提供进程隔离与资源监控能力，缺失将触发静默降级或初始化中断。
1、执行 lsmod | grep -E 'overlay|namespaces|seccomp'，确认 overlayfs、user_namespaces、seccomp 模块已加载。
2、若输出为空，需检查内核配置：运行 zcat /proc/config.gz | grep -E 'OVERLAY_FS|USER_NS|SECCOMP'（若无 config.gz 则查 /boot/config-$(uname -r)）。
3、关键配置项必须为 y 或 m；若为 n，则该内核不支持 WorkBuddy 沙箱机制，不可用于生产部署。
五、WSL 2 环境下的特殊处理
在 Windows Subsystem for Linux 2 中运行 WorkBuddy 时，实际使用的是微软定制的 WSL2 内核（5.10.16.3-microsoft-standard-WSL2），该内核虽版本达标，但缺少部分桌面级内核接口。
1、执行 wsl --update 确保 WSL2 内核为最新稳定版（≥ 5.15.153.1）。
2、在 WSL2 发行版中运行 echo 1 | sudo tee /proc/sys/kernel/unprivileged_userns_clone，启用非特权用户命名空间支持。
3、修改 /etc/wsl.conf，添加 [kernel] commandline = "systemd.unified_cgroup_hierarchy=1"，确保 cgroup v2 正确挂载。
4、重启 WSL2：执行 wsl --shutdown 后重新启动发行版，再尝试运行 WorkBuddy。
