先给你结论:VS Code 里装 OpenClaw 插件很简单,关键是装对官方插件、网关要先跑起来、再连接。下面按步骤来,你照着做就行。
一、先分清:装哪个插件(很重要)
现在主要有两个可用插件:
-
官方主插件(推荐,带聊天+右键+代码补全)
名字:OpenClaw Node for VS Code
内部 ID:xiaoyaner.openclaw-node-vscode -
另一个通用版(只有侧边聊天)
名字:OpenClaw(或 OpenClaw Chinese)
你要深度集成、右键菜单、代码助手,就装 OpenClaw Node for VS Code。
二、安装步骤(最简单:市场直接装)
-
打开 VS Code
-
左侧点「扩展」图标,或按:
Ctrl + Shift + X -
搜索框直接粘贴:
OpenClaw Node或更精准:
xiaoyaner.openclaw-node-vscode -
找到 Official OpenClaw Node for VS Code,点「安装」
-
安装完重启 VS Code。
快速命令安装(Ctrl+P 后粘贴回车):
ext install xiaoyaner.openclaw-node-vscode
三、必须先做:把本地 OpenClaw 网关跑起来
插件只是“前端”,必须本地网关先启动,否则连不上:
- 开一个终端(PowerShell 或 VS Code 终端)
- 启动网关(你平时启动 OpenClaw 的命令),例如:
或全局安装的话:node scripts/run-node.mjsopenclaw gateway --port 18789 - 看到类似:
就成功了,这个终端不要关,最小化放着。Gateway running on http://localhost:18789
四、VS Code 插件连接本地网关
- 重启 VS Code 后
- 按:
Ctrl + Shift + P - 输入:
OpenClaw: Setup Wizard - 向导里填:
- Host:
localhost - Port:
18789(默认) - 认证:填你设置的密码
- Host:
- 点「连接」,左侧会出现小龙虾图标,打开就能聊天。
五、简单测试是否正常
在侧边栏聊天里发:
列出当前 VS Code 打开的文件
能正常回复,就是通了。
六、常见坑(你大概率会遇到)
- 连不上:网关没启动、端口不对、防火墙拦截;确认
localhost:18789能在浏览器打开 - 没右键菜单:装错插件(必须是
xiaoyaner.openclaw-node-vscode)、没重启 VS Code - Agent busy / 卡住:按
Esc终止,或重启网关
如果你愿意,我可以直接给你一套**“一键安装+配置+启动”的命令脚本**,你复制到终端就能全部搞定,要不要?