VS Code / Cursor Node 技能

通过 OpenClaw Node 协议远程控制 VS Code 或 Cursor IDE。

相关资源

• OpenClaw Node for VS Code — 您需安装的 VS Code/Cursor 扩展（必需）
• cursor-ide-agent — 同时支持 CLI 和 Node 调用路径的整合型技能（若您同时使用 Cursor CLI，请安装此替代项）
• 源码：github.com/xiaoyaner-home/openclaw-vscode

前提条件

• 已安装并成功连接扩展 openclaw-node-vscode（状态栏显示 🟢）
• 该 Node 已在 nodes status 中可见
• 所调用命令已列入 Gateway 的 allowCommands 白名单中

调用模式

nodes invoke --node "" --invokeCommand "" --invokeParamsJson '{"key":"val"}'

对于耗时较长的操作，必须同时指定 invokeTimeoutMs（Gateway 内部超时）和 timeoutMs（HTTP 层超时，其值必须更大）。

超时配置参考：

命令分类

快速示例

读取一个文件

nodes invoke --node "my-vscode" --invokeCommand "vscode.file.read" --invokeParamsJson '{"path":"src/main.ts"}'
→ { content, totalLines, language }

查找全部引用位置

nodes invoke --node "my-vscode" --invokeCommand "vscode.lang.references" --invokeParamsJson '{"path":"src/main.ts","line":10,"character":5}'
→ { locations: [{ path, line, character }] }

Git 状态 + 提交

nodes invoke --node "my-vscode" --invokeCommand "vscode.git.status"
→ { branch, staged, modified, untracked, ahead, behind }

nodes invoke --node "my-vscode" --invokeCommand "vscode.git.stage" --invokeParamsJson '{"paths":["src/main.ts"]}'
nodes invoke --node "my-vscode" --invokeCommand "vscode.git.commit" --invokeParamsJson '{"message":"fix: resolve type error"}'

委托任务给 Cursor Agent

nodes invoke --node "my-vscode" --invokeCommand "vscode.agent.run" --invokeParamsJson '{"prompt":"Add error handling to all API endpoints","mode":"plan"}' --invokeTimeoutMs 180000 --timeoutMs 185000
→ { output, exitCode }

常见工作流

详见 references/workflows.md 中的分步详细说明：

• 修复类型错误
• 安全的跨文件重构
• 将复杂任务委托给 Cursor Agent

错误处理

安全性

• 所有路径均以工作区根目录为基准 —— 绝对路径与 ../ 路径均被拦截
• 写入操作受扩展设置 readOnly 和 confirmWrites 约束
• 终端功能默认禁用；启用后仅允许白名单中的命令
• 每台设备拥有唯一的 Ed25519 身份标识，须经 Gateway 显式批准