FAQ
Q1：E2B沙箱无法访问部分外网且宿主机tcpdump抓包看不到外发包的解决方法？
E2B沙箱默认存在虚拟防火墙机制，自动屏蔽了沙箱内外发部分网段的请求，需要根据客户现场情况手动配置通行。例如，若需访问10.0.14.0网段，可在宿主机执行如下指令后可正常访问：
for ns in $(ls /var/run/netns/); do sudo ip netns exec $ns nft add element inet slot-firewall filtered_always_allowlist { 10.0.14.0/24 } 2>/dev/null && echo "$ns: OK" || echo "$ns: Failed/Skip"; done
Q2：E2B沙箱部署OpenClaw，Python脚本执行出错的解决方法？
可能是很多原因导致Python执行出错，可以遵循如下方式进行排查：
- 进入Nomad中的template-manager-system任务，单击下方“ViewLogs”查看日志，查看脚本执行前后是否有新增报错，针对性排查环境原因（例如环境无创建虚机权限，或其它可能原因）。
- 可能是模板创建失败，建议重新拉取OpenClaw镜像，从头开始制作模板。
- 整个E2B管理平台部署存在错误，执行bash build.sh --stop && bash build.sh --uninstall后重新开始部署。
Q3：如何确认OpenViking已成功使能？
除文档部署教程中提到的验证方法，还可以进入OpenViking镜像，检查对应用户下是否有创建好的记忆碎片文件，通常位于entities、events、preference文件夹下。这些文件内包含以自然语言存储的记忆。
Q4：配置OpenClaw上下文窗口大小后，context依旧超限的解决方法？
工具执行结果和记忆的召回都会追加到当前上下文上，导致超出上下文窗口大小并在后续对话中触发压缩。为保证Agent工作正常，建议将窗口大小设置略小于实际所需。此外，将compaction模式从safeguard切换为default，也可改善该问题。
Q5：OpenClaw报错局域网发包数目大于网络允许最大尺寸导致无法运行gateway的解决方法？
该现象出现在OpenClaw部分版本（已知2026.4.8存在）运行于网卡数较多的机器上，并与OpenClaw探测机制有关。可通过修改openclaw.json文件来规避，具体操作为在gateway、meta等的同一层级添加如下内容。
"discovery": {
"mdns": {
"mode": "off"
}
}
Q6：OpenClaw升级后钉钉（QQ、飞书等）等机器人无法使用或channel插件安装失败的解决方法？
OpenClaw版本必须与插件版本对齐才能正确使能。建议根据实际版本进行选择，目前已知部分软件的版本匹配信息如下：
- OpenClaw 3.13版本钉钉插件安装命令：openclaw plugins install @dingtalk-real-ai/dingtalk-connector@0.7.10。
- OpenClaw 4.8之后版本QQ Bot：被OpenClaw官方收编，无需额外安装，对话控制Agent使能即可。
一般来讲，根据OpenClaw的版本，查找发布日期附近的插件版本，能够较好地兼容。
Q7：创建沙箱模板过程中死机的解决方法？
本现象由openEuler使用Yum升级时，内核小版本导致的Bug，例如：
https://gitee.com/openeuler/openeuler-upgrader/raw/master/openeuler-upgrader
本内核问题openEuler正在修复中。若确实遇到该问题，可联系鲲鹏提供firecracker二进制，替换“/fc-versions/v1.13.1/firecracker”与“/opt/e2b-infra/bin”下的原二进制文件。然后重新依次执行--install和--start流程，即可规避本问题。
bash build.sh --install bash build.sh --start
Q8：E2B沙箱服务部署过程中bash build.sh --start卡死的解决方法？
本现象由build.sh执行过程非正常中断，致使部分容器进入UNKNOWN status导致，一般1~2次reboot重启即可恢复正常。容器正常后，即可执行后续--start流程，但建议此次--start后重新执行一遍，直到build.sh看不到任何报错，以确认部署无误。