先给你结论:VS Code 里装 OpenClaw 插件很简单,关键是装对官方插件、网关要先跑起来、再连接。下面按步骤来,你照着做就行。


一、先分清:装哪个插件(很重要)

现在主要有两个可用插件:

  1. 官方主插件(推荐,带聊天+右键+代码补全)
    名字:OpenClaw Node for VS Code
    内部 ID:xiaoyaner.openclaw-node-vscode

  2. 另一个通用版(只有侧边聊天)
    名字:OpenClaw(或 OpenClaw Chinese)

你要深度集成、右键菜单、代码助手,就装 OpenClaw Node for VS Code


二、安装步骤(最简单:市场直接装)

  1. 打开 VS Code

  2. 左侧点「扩展」图标,或按:

    Ctrl + Shift + X
    
  3. 搜索框直接粘贴:

    OpenClaw Node
    

    或更精准:

    xiaoyaner.openclaw-node-vscode
    
  4. 找到 Official OpenClaw Node for VS Code,点「安装」

  5. 安装完重启 VS Code

快速命令安装(Ctrl+P 后粘贴回车):

ext install xiaoyaner.openclaw-node-vscode

三、必须先做:把本地 OpenClaw 网关跑起来

插件只是“前端”,必须本地网关先启动,否则连不上:

  1. 开一个终端(PowerShell 或 VS Code 终端)
  2. 启动网关(你平时启动 OpenClaw 的命令),例如:
    node scripts/run-node.mjs
    或全局安装的话:
    openclaw gateway --port 18789
  3. 看到类似:
    Gateway running on http://localhost:18789
    
    就成功了,这个终端不要关,最小化放着

四、VS Code 插件连接本地网关

  1. 重启 VS Code 后
  2. 按:
    Ctrl + Shift + P
    
  3. 输入:
    OpenClaw: Setup Wizard
    
  4. 向导里填:
    • Host:localhost
    • Port:18789(默认)
    • 认证:填你设置的密码
  5. 点「连接」,左侧会出现小龙虾图标,打开就能聊天。

五、简单测试是否正常

在侧边栏聊天里发:

列出当前 VS Code 打开的文件

能正常回复,就是通了。


六、常见坑(你大概率会遇到)

  • 连不上:网关没启动、端口不对、防火墙拦截;确认 localhost:18789 能在浏览器打开
  • 没右键菜单:装错插件(必须是 xiaoyaner.openclaw-node-vscode)、没重启 VS Code
  • Agent busy / 卡住:按 Esc 终止,或重启网关

如果你愿意,我可以直接给你一套**“一键安装+配置+启动”的命令脚本**,你复制到终端就能全部搞定,要不要?