MengBotDocs
智能体引擎

引擎故障排除

修复缺失的 CLI、认证失败、模型错误以及路径差异。

“找不到 CLI”

  1. 打开终端并直接运行该 CLI。
  2. 确认该命令是可执行文件,而不仅仅是 shell 别名或函数。
  3. 安装完成后重启 MengBot。
  4. 如果自动检测仍然失败,请在 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 可执行文件。

On this page