OpenClaw Windows 问题修复教程

环境

• Windows 11
• Git Bash（已安装，含 /bin/sh）
• OpenClaw

问题一：plugins.entries.browser-plugin: plugin not found

原因：配置里残留了已卸载的 browser-plugin 插件条目。

修复步骤：

# 1. 确认问题
openclaw config get plugins.allow
# 输出应包含 "browser-plugin"

# 2. 从 allow 列表移除
openclaw config set plugins.allow '["lossless-claw","minimax","feishu","browser","tavily"]'

# 3. 从 entries 移除
openclaw config unset plugins.entries.browser-plugin

问题二：shell env fallback failed: spawnSync /bin/sh ENOENT

原因：env.shellEnv.enabled: true 让 OpenClaw 在 Windows 上尝试调用 /bin/sh，但 Node.js 的 spawnSync 在 Windows 下找不到它。

修复步骤：

# 关闭 shellEnv 功能（大多数场景不需要）
openclaw config set env.shellEnv.enabled false

问题三：让配置生效

修改配置后，需要重启 gateway：

# 先停止 gateway
openclaw gateway stop

# 再重新启动
openclaw gateway

如果是第一次设置，gateway 可能已在运行，用 openclaw gateway stop 停止后重启即可。

验证

重启后运行：

openclaw doctor

应该不再有 browser-plugin 和 spawnSync /bin/sh 的警告。

如果后续又出现 browser-plugin 警告

说明插件配置又自动恢复了。检查：

openclaw plugins list

如果有 browser-plugin 在列表里但实际未安装，需要手动移除：

openclaw config unset plugins.entries.browser-plugin
openclaw config set plugins.allow '["lossless-claw","minimax","feishu","browser","tavily"]'
openclaw gateway stop && openclaw gateway