智能体引擎
引擎故障排除
修复缺失的 CLI、认证失败、模型错误以及路径差异。
“找不到 CLI”
- 打开终端并直接运行该 CLI。
- 确认该命令是可执行文件,而不仅仅是 shell 别名或函数。
- 安装完成后重启 MengBot。
- 如果自动检测仍然失败,请在 Settings → Engines 中设置确切的 可执行文件路径。
桌面应用通常继承与终端不同的环境。这在 Windows 快捷方式、macOS Finder 启动以及 Linux 应用程序菜单中很常见。
认证失败
在终端中运行提供商自带的 status 或 login 命令。MengBot 使用 CLI 的已认证会话;仅安装二进制文件是不够的。
来自 api.openai.com 的 401 Unauthorized 响应意味着启动的 Codex 进程未收到有效的认证。确认 codex login status,如有需要请重新登录,然后重启 MengBot。不要将 ChatGPT 密码粘贴到 MengBot 中。
所选模型失败
- 更新 CLI 后刷新模型选择器。
- 选择该提供商账户实际可用的模型。
- 确认自定义包装器会转发模型参数,并保留提供商预期的环境。
- 直接使用同一模型运行提供商 CLI,以区分是账户问题还是 MengBot 集成问题。
Codex 沙箱不匹配
MengBot 在启动一轮对话时会保留 Codex 已解析的网络和可写文件夹设置。如果 Codex 未返回已解析的沙箱,或返回的模式与请求的模式不同,该轮对话会在发送你的消息之前停止。请检查原生 Codex 沙箱设置和所选的访问模式,然后重试。MengBot 不会静默地用更宽泛的访问权限替换该策略。
Windows 注意事项
在引擎覆盖设置中使用真实的 .exe、.cmd 或可解析的命令路径。如果某个 CLI 安装在 WSL 中,Windows 桌面应用无法在没有显式桥接或包装器的情况下将该 Linux 二进制文件视为原生 Windows 可执行文件。