白板

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install excalidraw-whiteboard
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 excalidraw-whiteboard。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

白板是 Openclaw Skills 工具，可在项目设计讨论期间与用户协作处理可编辑的 Excalidraw 画布。其内置 CLI 可创建和重新打开命名白板、读取场景数据、截取预览，并在可能的情况下保留用户的布局和注释进行定向修改。
每个白板都有稳定的会话 ID、保存于本地的状态和独立的 loopback 服务器，因此可以在不同聊天和进程重启后继续使用。白板让整个工作流程保持在本地：无需 MCP，不会对外提供网络服务，也不会上传白板。代理可以将完成的场景和预览导出到项目中，以供审阅和分享。

应用场景

为 API、系统架构、流程或其他项目设计讨论创建新画布。
通过会话 ID 重新打开先前创建的白板，或使用会话列表查找白板。
同时利用场景描述和渲染后的截图阅读并讨论用户的草图。
在保留现有图表结构和用户注释的同时，进行有针对性的修改。
将完成的迭代导出为 Excalidraw 文件和 PNG 预览，供项目使用。
在之后的聊天中继续使用白板，或在保留已保存状态的同时停止其会话。

工作原理

根据技能文件定位内置的 scripts/session.mjs 路径，并在 CLI 命令中使用其绝对路径。
列出当前项目的会话以查找现有白板，或使用简短的主题名称启动一个新白板。启动操作始终会创建新白板。
通过 ID 打开所选会话。CLI 会启动或重新使用该白板，并返回当前 URL；如果有本地浏览器，请在其中打开该 URL。
使用 describe 读取现有画布，并在需要时截取屏幕截图。结合场景和图像了解结构与布局；对于含义不明确的标记，请询问用户。
通过 run SESSION_ID 执行用户要求的修改，并优先采用有针对性的更新。在进行重大修改前保存一个命名快照；如果用户仍在绘图，请与其协调。
检查修改后的场景和最新图像，修正布局问题，并将 .excalidraw 和 PNG 文件导出到项目的图表目录或 boards/。
对带有标注连接线的图表，在导出的场景上运行布局检查器，解决报告的问题，并目视检查最终图像。除非用户要求停止会话，否则让服务器继续运行。

配置指南

要求：Node.js 20 或更高版本、npm、Git、本地 shell，以及同一台计算机上的浏览器。运行时需单独安装在 ~/.local/share/codex-whiteboard/ 下。如果缺少运行时，请运行该技能的设置脚本；设置过程会下载并构建固定版本的运行时，因此需要网络连接。
根据已安装的技能目录定位脚本，然后使用绝对路径，以便从任何项目运行命令。例如：
SKILL_DIR="/absolute/path/to/whiteboard-skill"
SESSION_CLI="$SKILL_DIR/scripts/session.mjs"
SETUP_SCRIPT="$SKILL_DIR/scripts/setup.mjs"
node "$SETUP_SCRIPT"
node "$SESSION_CLI" list --project /absolute/path/to/project
node "$SESSION_CLI" start --project /absolute/path/to/project --name "API design"
node "$SESSION_CLI" open SESSION_ID
将示例中的技能和项目路径以及 SESSION_ID 替换为实际值。WHITEBOARD_HOME 可选用于覆盖本地运行时和会话存储目录；WHITEBOARD_RUNTIME 可选用于指定现有的本地运行时构建。避免使用未固定版本的 npx 命令以及原型中的固定端口包装器。打开会话会返回 URL，但不会自动启动浏览器。

数据架构

白板会在本地存储会话状态，并为每个白板关联一个稳定的会话 ID、名称和项目路径。每个会话都有独立的 loopback 服务器；重启后其端口可能改变，因此请通过打开会话来获取当前 URL。
数据或产物 用途
会话 ID 为 CLI 操作选择确切的白板，并允许之后的聊天继续使用该白板。
已保存的会话状态 在不同聊天和进程重启后保留白板。
命名快照 为代理所做的更改提供恢复点，尤其适用于重大修改前。
.excalidraw 导出文件 当前场景的显式副本；实时服务不会监视导出的文件。
PNG 预览 渲染后的图像，用于审阅和分享图表。
布局检查报告 标记需要关注的连接线标签间距、重叠或重复标签问题；不会编辑或删除元素。
运行时和会话存储默认位于 ~/.local/share/codex-whiteboard/，并可通过 WHITEBOARD_HOME 重定向。完成的导出文件应放在项目现有的图表目录中；若不存在此类目录，则放在 boards/ 中。选择能够标识会话的文件名，并避免覆盖其他白板。

高级特性

使用会话 ID 在不同聊天和进程重启后继续使用确切的白板；如果不知道 ID，请列出会话。
WHITEBOARD_HOME
更改本地运行时和会话存储目录，或使用
WHITEBOARD_RUNTIME
指定现有的本地运行时构建。
在进行重大更改前保存命名快照，并在用导入的白板替换当前场景前导出当前场景。
对包含标注连接线的导出场景运行内置的
scripts/check-layout.mjs
，以识别需要审查的问题；仍需进行目视检查。
让修改仅限于本地和 loopback。该辅助工具会串行处理自身命令并验证会话身份，但无法防止与同时进行的人工绘图发生冲突。
根据要求使用
stop SESSION_ID
停止特定会话；停止操作会保留白板和快照。避免停止所有服务器或隐式连接另一代理。

name: whiteboard description: "Start, reopen, read, and edit local Excalidraw whiteboards with the user during project design discussions. Use for shared canvas sessions and iterative system diagrams." license: MIT