QClaw在VSCode中激活手把手教程：插件安装与账号绑定

可通过OpenClaw CLI+Command Runner插件在VSCode中集成QClaw能力：需先全局安装并验证OpenClaw CLI，再安装Command Runner扩展，配置JSON绑定qclaw-code-gen等命令，通过GitHub OAuth完成身份认证，最后在编辑器中一键调用代码生成、截图等功能。

如果你已经在本地装好了QClaw桌面客户端，但希望在VSCode编辑器里直接调用它的能力——比如自然语言生成代码、执行本地文件操作、触发浏览器自动化——那么就需要通过插件机制，把QClaw的执行能力接入VSCode环境。需要说明的是，QClaw本身并没有官方VSCode插件，但借助OpenClaw CLI加自定义插件桥接的方式，完全可以实现深度集成。下面就是具体的操作路径。

一、确认本地已部署 OpenClaw CLI 环境

简单来说，QClaw桌面端基于OpenClaw封装，而VSCode集成依赖底层OpenClaw命令行工具是否可用。这一步很关键——跳过它，后续所有配置都会失效。

第一步，打开系统终端（Windows PowerShell / macOS Terminal / Linux Bash）。然后执行命令 npm install -g @openclaw/cli，安装最新版OpenClaw CLI。接着运行 openclaw --version，验证是否返回了有效版本号，比如v0.12.7之类。如果系统提示"command not found"，那就需要将npm全局bin路径加入系统PATH，然后重启VSCode。

二、安装 VSCode 扩展：Command Runner 或 Shell Command

VSCode原生并不支持直接调用OpenClaw CLI指令，需要借助一个可以执行终端命令的扩展来作为调度中介。这里推荐使用轻量级、无权限风险的扩展，避免引入额外的沙箱或远程服务。

具体操作：在VSCode中按下 Ctrl+Shift+X（Windows/Linux）或 Cmd+Shift+X（macOS） 打开扩展市场，搜索关键词 Command Runner，选择作者为"yo1dog"的扩展并安装。安装完成后重启VSCode，确保扩展已激活。然后按 Ctrl+Shift+P（或 Cmd+Shift+P） 打开命令面板，输入"Command Runner: Run Command"验证功能是否可用。

三、配置自定义命令绑定 QClaw 功能

通过Command Runner扩展，可以把常用的OpenClaw CLI指令封装成一键可触发的VSCode命令。这样一来，就可以在编辑器里直接发起QClaw任务，比如生成代码、读取当前文件内容、调用Playwright浏览器操作等。

具体设置：在VSCode中按下 Ctrl+Shift+P，输入并选择"Preferences: Open Settings (JSON)"。然后在settings.json文件末尾添加如下配置块（保留原有内容，仅追加）：

"command-runner.commands": { "qclaw-code-gen": "openclaw run skill codegen --prompt \"$(selectedText)\" --lang TypeScript", "qclaw-screenshot": "openclaw run skill screenshot", "qclaw-file-read": "openclaw run skill file-read --path \"$(file)\""

保存settings.json后，重新加载窗口（Ctrl+Shift+P → "Developer: Reload Window"）。

四、使用 GitHub 账户完成 OpenClaw 身份绑定

OpenClaw CLI默认要求用户身份认证后才能调用受控技能，比如文件读写、截图、脚本执行等。需要说明的是，这个认证与QClaw桌面端的微信绑定相互独立，需要单独通过GitHub OAuth来完成。绑定完成后，凭证会自动缓存到本地的~/.openclaw/config.json。

操作步骤：在VSCode内置终端中执行 openclaw auth login --provider github，系统会自动打开浏览器跳转到GitHub授权页，勾选 user:email 和 read:user 权限。授权成功后页面会显示"Login successful"，浏览器可以关闭。终端返回提示 "Authenticated as github_username. Config sa ved."

五、在编辑器中触发 QClaw 功能

完成上述配置后，就可以在任意代码文件中选中文本，或直接在光标定位处，通过快捷命令调用对应的QClaw技能。所有指令都会经过本地OpenClaw CLI解析，由已经运行的QClaw守护进程接管执行，结果会以终端输出或新标签页的形式返回。

举个例子：打开一个.ts文件，选中一段函数描述文字（比如"生成一个防抖函数，延迟300ms，立即执行选项可选"）。按下 Ctrl+Shift+P，输入"Command Runner: Run Command qclaw-code-gen"并回车。稍等几秒，VSCode终端就会输出生成的TypeScript函数代码。如果需要截取当前桌面，直接运行命令 Command Runner: Run Command qclaw-screenshot 即可。

来源：互联网