🖥️ Canvas-OS

核心用法

Canvas OS 将 Canvas 窗口转化为本地应用运行平台，通过 Python HTTP 服务器托管 HTML/CSS/JS 应用，实现超越纯文本的富交互 UI。用户可通过自然语言命令快速打开应用、构建模板或注入实时数据。

工作流程

1. 应用构建：在 ~/.openclaw/workspace/apps/ 下创建自包含 HTML 文件，暴露 window.app API
2. 本地服务：使用 python3 -m http.server 启动端口（9876-9880+）
3. Canvas 导航：通过 openclaw nodes canvas navigate 加载 localhost
4. 数据注入：通过 openclaw nodes canvas eval --js 实时更新 UI
5. 双向通信：应用通过 openclaw://agent 深链接回调代理

显著优点

• 富交互体验：动画、实时数据、完整 CSS/JS 能力，远超传统终端输出
• 快速原型：内置 Dashboard、Tracker、Timer 等模板，一键生成
• 动态更新：无需刷新页面，代理可直接注入 JavaScript 修改元素
• A2UI 速显：临时数据展示无需完整应用架构
• 设计一致性：内置暗黑主题配色，匹配 OpenClaw 视觉风格

潜在局限

• 平台依赖：需 OpenClaw macOS 应用及已配对节点，Linux/Windows 不可用
• 本地网络限制：仅 localhost 访问，无法直接对外暴露
• 端口管理：硬编码默认端口（9876-9880），多应用并发需手动协调
• 安全边界模糊：canvas eval 执行任意 JS，lsof -ti:$PORT | xargs kill -9 强制终止端口占用，缺乏沙箱隔离
• 持久化薄弱：data.json 仅建议存在，无强制存储机制

适合人群

• 需要可视化工作台的 OpenClaw 重度用户
• 习惯快速搭建本地工具前端的开发者
• 追求暗黑美学、实时数据看板的效率型用户

常规风险

• 命令注入：eval --js 参数若拼接用户输入可导致代码执行
• 端口冲突：强制 kill -9 可能误杀系统服务
• 深链接劫持：openclaw://agent 回调若未校验消息源，可能被恶意页面利用
• 无 HTTPS：localhost 明文传输，敏感数据暴露风险

核心用法

Canvas OS 是一个将 OpenClaw Canvas 转化为应用平台的 Skill。它允许用户用 HTML/CSS/JS 构建富交互 UI，在本地运行并通过 Canvas 窗口呈现。

快速启动：使用自然语言命令如 "Open dashboard" 或 "Build me a tracker"，Agent 会自动完成：终止旧进程 → 启动本地 HTTP 服务 → 导航 Canvas 到对应端口 → 注入初始数据。整个过程无需手动操作。

开发模式：应用存储于 ~/.openclaw/workspace/apps/[app-name]/，包含 index.html（自包含 UI）、data.json（持久状态）和 manifest.json（元数据）。Agent 可通过 canvas eval 实时注入 JavaScript 更新界面，实现真正的"实时 A2UI"体验。

双向通信：应用通过 openclaw://agent 深度链接回调 Agent，用户点击按钮即可触发新命令，形成完整交互闭环。

显著优点

1. 真正的富 UI：突破纯文本限制，支持动画、图表、实时数据可视化
2. 零外部依赖：仅使用 Python3 内置 http.server，无 npm/webpack 等复杂工具链
3. 自包含设计：单 HTML 文件内嵌 CSS/JS，便于迁移和版本控制
4. 实时热更新：Agent 可随时注入 JS 修改运行中的应用，无需重启
5. 隐私优先：所有数据本地存储，无云端传输

潜在局限

• 平台限制：需 OpenClaw Canvas（macOS 应用）和已配对节点
• 进程管理粗糙：当前使用 kill -9 强制终止，存在资源泄漏风险
• 无沙箱隔离：应用运行在用户目录，需信任应用代码
• 调试困难：服务器日志重定向到 /dev/null，故障排查不便
• 版本绑定：依赖 openclaw CLI 的特定功能，兼容性待明确

适合人群

• 需要数据看板、习惯追踪等可视化工具的效率用户
• 希望快速原型化内部工具的技术团队
• 偏好本地优先、隐私保护的开发者

常规风险

| 风险项 | 等级 | 说明 |

|--------|------|------|

| 进程强制终止 | 低 | `kill -9` 可能导致端口占用或资源未释放 |

| 输入验证不足 | 低 | APP_NAME/PORT 参数未严格校验，存在注入可能 |

| 外部工具依赖 | 信息 | 功能依赖 openclaw CLI，版本兼容性需关注 |

缓解建议：生产使用前实施优雅进程终止、添加参数验证、开启日志记录选项。定期复审 Skill 安全态势。