openclaw 升级及 Peekaboo 插件安装授权指南 (macOS)

Peekaboo 插件安装与授权指南 (macOS)

环境准备与升级

在 macOS 上运行 OpenClaw 前，建议确保 Node.js 版本为 24 及以上。若之前安装了 Clawdbot 或 moltbot，可直接升级。

升级命令（无需卸载原来的 clawdbot 或者 moltbot）：

curl -fsSL https://openclaw.ai/install.sh | bash

执行成功后显示安装完成信息。

解决插件授权问题：Peekaboo

打开终端，输入以下命令检查权限状态：

peekaboo permissions

如果显示未开通，Clawbot 可能会提示失败，常见错误包括 AppleScript 卡住、需要用户交互、Peekaboo 需要屏幕录制权限等。

解决方案

1. 屏幕录制权限 打开「系统设置」→「隐私与安全性」→「屏幕录制」。点击 ➕ 号，选择'终端'，然后授予权限。

2. 辅助功能权限 打开「系统设置」→「隐私与安全性」→「辅助功能」。同样添加'终端'并授权。

再次验证权限状态：

peekaboo permissions

确认输出包含 Screen Recording (Required): Granted 和 Accessibility (Required): Granted。

注意事项

OpenClaw 调用 Peekaboo 时可能仍会提示没有权限，目前终端可以直接调用，但 OpenClaw 集成层面可能存在限制，需后续关注更新。