Skip to content

ARM64 上 doctor 报告 @discordjs/opus 缺失且 --fix 无法恢复

问题

更新到 OpenClaw 最新 npm 版本(如 2026.4.9+)后,在 ARM64 设备(树莓派、M 系列 Mac、部分 VPS)上运行 openclaw doctor 时报告 @discordjs/opus 为缺失的内置插件运行时依赖。执行 openclaw doctor --fix 无法自动恢复,因为 ARM64 没有预构建二进制,而且从源码编译会失败于 celt_neon_intr.c

解决方案

临时规避(不需要 Discord 语音功能时):

  1. 在配置中禁用 Discord 语音/音频功能,或将 Discord 插件的音频相关功能设置为 disabled
  2. 如果不使用 Discord 插件,可以将其从 plugins.allow 白名单中移除,消除 doctor 报告:
    json5
    {
      plugins: {
        allow: ["telegram", "browser"],  // 移除 discord
      },
    }

如果必须使用 Discord 语音

ARM64 上 @discordjs/opus 无法正常构建是已知限制。等待上游提供 ARM64 预构建二进制,或考虑使用 x86_64 平台运行 OpenClaw Gateway。

doctor 报告本身不影响非语音 Discord 功能:文字消息、命令、渠道路由等不依赖 @discordjs/opus,可以正常使用。