更新故障 | Friends of the Crustacean 🦞🤝 | Page 1

somber solstice Apr 19, 2026, 4:22 AM

#

Config warnings:\n- plugins.entries.minimax-portal-auth: plugin not found: minimax-portal-auth (stale config entry ignored; remove it from plugins config)

plugins.allow: plugin not found: minimax-portal-auth (stale config entry ignored; remove it from plugins config)
[openclaw] Failed to start CLI: Error: The openclaw help command is unavailable because plugins.allow excludes "help". Add "help" to plugins.allow if you want that bundled plugin CLI surface.
at runCli (file:///Users/qiguaidemaomao/.npm-global/global/5/.pnpm/openclaw@2026.4.15_@napi-rs+canvas@0.1.96_@types+express@5.0.6_apache-arrow@18.1.0_hono_ffce9b7889330c815d8d2b31f4fec5ef/node_modules/openclaw/dist/run-main-BBeVm29G.js:458:45)
(node:51941) [OPENCLAW_PLUGIN_SDK_COMPAT_DEPRECATED] Warning: openclaw/plugin-sdk/compat is deprecated for new plugins. Migrate to focused openclaw/plugin-sdk/<subpath> imports. See https://docs.openclaw.ai/plugins/sdk-migration
Bundled plugins must use scoped plugin-sdk subpaths. External plugins may keep compat temporarily while migrating. Migration guide: https://docs.openclaw.ai/plugins/sdk-migration
(Use node --trace-warnings ... to show where the warning was created)

nova fjordBOT Apr 19, 2026, 4:22 AM

#

To help others find answers, you can mark your question as solved via Right click solution message -> Apps -> ✅ Mark Solution

distant wolfBOT Apr 19, 2026, 4:22 AM

#

night monolithBOT Apr 19, 2026, 4:24 AM

#

Let me verify the docs path and the current plugin docs so I don't guess.

#

I found the repo docs checkout, but the FAQ path moved. I’m locating the exact page now so I can answer against current docs instead of guessing.

#

This looks like two separate issues:

Stale plugin config
- minimax-portal-auth is no longer present
- remove it from both:
  - plugins.entries.minimax-portal-auth
  - plugins.allow
Your plugin allowlist is too strict for openclaw help
- when plugins.allow is set, bundled plugin CLI surfaces are blocked unless their plugin id is included
- if you want openclaw help, add "help" to plugins.allow

Best first step, per the docs:

openclaw --version

#

openclaw doctor

If you want OpenClaw to repair stale plugin refs automatically:

openclaw doctor --fix

If you prefer to edit manually, your config is usually ~/.openclaw/openclaw.json and it is JSON5, not YAML.

If you keep plugins.allow, it should look something like:

plugins: {

#

  allow: [
    "help",
    // ...other plugin ids you actually use
  ],
  entries: {
    // remove minimax-portal-auth from here
  },
}

Also, that plugin-sdk/compat line is a deprecation warning, not the main startup blocker here.

Docs:

FAQ: https://docs.openclaw.ai/help/faq
Doctor: https://docs.openclaw.ai/gateway/doctor
Config reference: https://docs.openclaw.ai/gateway/configuration-reference

#

If you paste your plugins block plus openclaw --version, I can sanity-check the exact fix.

somber solstice Apr 19, 2026, 4:27 AM

#

中文回复，辛苦

night monolithBOT Apr 19, 2026, 4:27 AM

#

可以，这个报错本质上是 两个独立问题：

1）旧插件配置残留

minimax-portal-auth 这个插件现在找不到了，所以要从配置里删掉这两处：

plugins.entries.minimax-portal-auth
plugins.allow 里的 minimax-portal-auth

2）`plugins.allow` 把 `help` 挡掉了

你现在设置了 plugins.allow，所以只有白名单里的插件能提供 CLI 命令。

因此如果你还想用：

openclaw help

#

就需要把 "help" 加到 plugins.allow 里。

建议先跑这几个命令

先发一下版本：

openclaw --version

然后先检查：

openclaw doctor

#

如果你想让 OpenClaw 自动修掉这类陈旧插件引用，可以直接：

openclaw doctor --fix

手动改配置的话

配置文件一般在：

~/.openclaw/openclaw.json

注意这是 JSON5，不是 YAML。

#

大概改成这样：

plugins: {
  allow: [
    "help",
    // 你实际还在用的其他 plugin id
  ],
  entries: {
    // 把 minimax-portal-auth 整段删掉
  },
}

额外说明

#

openclaw/plugin-sdk/compat is deprecated 这一行目前是 弃用警告，不是这次启动失败的主因。
这次真正卡住的是前面两个问题。

文档：

FAQ: https://docs.openclaw.ai/help/faq
Doctor: https://docs.openclaw.ai/gateway/doctor
配置参考: https://docs.openclaw.ai/gateway/configuration-reference

如果你愿意，把你的 plugins 配置段贴出来，我可以直接帮你指出该删哪几行。

somber solstice Apr 19, 2026, 4:32 AM

#

"plugins": {
"allow": [
"wecom-openclaw-plugin",
"discord",
"minimax-portal-auth",
"minimax",
"kimi",
"deepseek",
"brave",
"memory-core"
],
"entries": {
"discord": {
"enabled": true
},
"minimax-portal-auth": {
"enabled": true
},
"wecom-openclaw-plugin": {
"enabled": true

night monolithBOT Apr 19, 2026, 4:33 AM

#

我先确认一下 minimax-portal-auth 是不是已经被合并/移除了，这样我能直接给你精确改法。

#

对，就是这里 👍

你这段配置里要改两处：

直接改法

1）删掉旧的 `minimax-portal-auth`

它已经是旧 id 了，现在保留 minimax 就行。

把这里删掉：

"minimax-portal-auth",

以及这里整段删掉：

#

"minimax-portal-auth": {
  "enabled": true
},

2）把 `help` 加进 `plugins.allow`

不然 openclaw help 还是会继续报：

"help"

你这段建议改成这样

#

"plugins": {
  "allow": [
    "wecom-openclaw-plugin",
    "discord",
    "minimax",
    "kimi",
    "deepseek",
    "brave",
    "memory-core",
    "help"
  ],
  "entries": {
    "discord": {
      "enabled": true
    },

#

    "wecom-openclaw-plugin": {
      "enabled": true
    },
    "minimax": {
      "enabled": true
    }
  }
}

如果你原来 minimax-portal-auth 下面还有别的配置项，不只是 enabled，那就把那些配置迁到：

plugins.entries.minimax

#

下面。

然后执行

改完后建议跑一下：

openclaw doctor --fix
openclaw status

plugin-sdk/compat deprecated 那条先不用管，它是警告，不是这次卡住的主因。

如果你把完整 plugins.entries 再贴一下，我可以顺手帮你看还有没有别的旧字段。

#更新故障