用途：winnode 是 OpenClaw Windows-node 的命令行接口与智能体参考文档，用于在本机调用和排障 Windows 托盘节点命令，也可查询实时 MCP 服务器的工具清单。
调用方式：
winnode --command <name> [--params '<json-object>'] [--invoke-timeout <ms>] [--identity release|dev] winnode --list-tools [--mcp-url <url>|--mcp-port <port>] [--identity release|dev]
winnode.exe 通过本机回环 MCP HTTP 端点（默认 http://127.0.0.1:8765/）向托盘发送命令，调用前需在托盘 设置 → 高级 中启用 Local MCP Server。--params 为单个 JSON 对象字符串，默认 {}，不接受数组或标量；--params @<path> 可从磁盘文件加载 JSON 对象。--invoke-timeout 默认 15000 毫秒，最大 600000 毫秒，HTTP 超时另加 5 秒缓冲。--node 仅为与 openclaw nodes invoke 保持兼容而接受，本地被忽略。--idempotency-key 同样被忽略，且 CLI 会向标准错误输出 [winnode] WARN，因为本地 MCP 不去重重试。--mcp-url / --mcp-port 可覆盖端点，端口需在 [1, 65535] 范围内，越界以退出码 2 失败。--mcp-token 可覆盖 bearer token（仅测试或显式场景），使用时会输出警告；优先使用 OPENCLAW_MCP_TOKEN 环境变量或磁盘上的 %APPDATA%\OpenClawTray\mcp-token.txt。--identity release|dev 选择托盘配置以提供默认磁盘 MCP token。--verbose 会在标准错误中记录端点与被忽略的标志。
输出契约：标准输出为格式化 JSON 的能力载荷，标准错误输出错误。退出码 0 表示成功；1 表示工具错误、JSON-RPC 错误、传输失败或 HTTP 非 2xx；2 表示参数错误（标志缺失/无效、--params JSON 错误、端口/超时越界、非 http URL）。当 --mcp-url 指向非回环主机时，CLI 拒绝发送自动加载的本地 MCP token 并在标准错误警告；显式提供的 --mcp-token 会被采纳但伴随警告，以保持仅限回环的威胁模型。
支持的命令：
系统类：system.notify 显示 Windows 通知；system.run 执行规范 argv（受本地 exec 审批策略约束，shell 行为须在 argv 中显式声明，V2 拒绝非空自定义 env）；system.run.prepare 预检但不执行；system.which 将二进制名解析为绝对路径；system.execApprovals.get 返回 V2 快照；system.execApprovals.set 用 compare-and-swap 替换完整 V2 文件。
画布类：canvas.present 打开 WebView2 画布窗口；canvas.hide 隐藏画布；canvas.navigate 导航；canvas.eval 执行脚本；canvas.snapshot 截图；canvas.a2ui.push 渲染 A2UI v0.8 表面（自动打开画布）；canvas.a2ui.pushJSONL 为其别名；canvas.a2ui.reset 清空表面；canvas.a2ui.dump 返回当前表面图；canvas.caps 返回渲染器能力。
屏幕与摄像头：screen.snapshot 屏幕截图（首次需用户同意，每次调用前显示通知）；screen.record 屏幕录制（最大 300000 毫秒）；camera.list 列出摄像头；camera.snap 拍照（首次需同意并显示通知）；camera.clip 录像（最大 60000 毫秒）。
语音转文字（stt.*）：本地 Whisper.net 运行，音频不出本机，模型首次使用时下载，需在托盘设置中启用 NodeSttEnabled。stt.transcribe 固定时长麦克风采集与转写；stt.listen 带语音活动检测的采集；stt.status 引擎就绪状态。
文字转语音（tts.*）：四种提供方 Piper（本地，默认）、Windows 内置、ElevenLabs（云）、MiniMax（云）。tts.speak 朗读文本，tts.status 返回提供方就绪状态。配置的提供方不可用时回退到 Windows TTS，显式指定的提供方保持严格不做静默改道。
本地模型推理（ollama.*）：针对单独安装的 Windows Ollama 服务运行，需在托盘 设置 > 权限 中启用 NodeOllamaInferenceEnabled（默认关闭）。ollama.models 列出本地模型；ollama.chat 发送单轮对话，一次仅允许一个对话进行。
应用控制（app.*）：app.navigate 导航工作区或设置页面；app.status 返回连接/节点状态；app.sessions 列出活动会话；app.agents 列出智能体；app.nodes 列出已连接节点及能力；app.config.get 读取网关配置；app.settings.get / app.settings.set 读写本地应用设置。
限制：本机回环安全模型，非回环端点不发送自动加载 token；本地 MCP 不去重重试，重跑可能重复执行副作用；部分能力需托盘设置门控；屏幕与摄像头采集首次需用户同意；线程、定价与平台等更多细节资料未提供。