需依次完成五步：一、安装官方插件xiaoyaner.openclaw-node-vscode并重启vs code；二、npm全局安装openclaw并启动网关服务；三、通过setup wizard配置localhost:18789连接；四、在设置中启用上下文菜单、code lens和内联建议；五、验证补全、修复、重构及右键功能。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已安装OpenClaw并希望在VS Code中启用智能代码补全与重构功能，但右键菜单缺失、快捷键无响应或补全建议不出现，则很可能是插件配置、网关服务或上下文权限未正确就绪。以下是解决此问题的步骤：
一、确认并安装正确的VS Code插件
OpenClaw在VS Code中存在多个名称相似的插件，仅特定版本支持右键菜单与深度上下文调用。使用错误插件将导致全部AI功能不可见。
1、按下 Ctrl+Shift+X 打开扩展市场。
2、在搜索框中粘贴并输入：xiaoyaner.openclaw-node-vscode。
3、从搜索结果中识别并点击安装标有 ✅ “Official OpenClaw Node for VS Code” 的扩展（发布者为 xiaoyaner）。
4、安装完成后，必须重启VS Code，否则插件不会激活上下文菜单能力。
二、启动并验证OpenClaw网关服务
VS Code插件本身不运行AI模型，它依赖本地运行的OpenClaw网关（Gateway）提供RPC通信与模型调度能力。网关未启动或端口冲突将直接导致所有功能失效。
1、以管理员身份打开终端（Windows PowerShell / macOS Terminal / Linux Bash）。
2、执行全局安装命令：npm install -g openclaw@latest。
3、启动网关服务：openclaw gateway --port 18789。
4、观察终端输出，确认出现 Gateway running on http://localhost:18789 字样，且无 ERROR 或 EADDRINUSE 报错。
5、保持该终端窗口开启（可最小化），切勿关闭。
三、完成VS Code与网关的手动连接配置
即使插件与网关均已就位，VS Code仍需显式指向网关地址与端口，否则无法建立通信链路。默认配置通常为空，必须手动填写。
1、按下 Ctrl+Shift+P 打开命令面板。
从 agency-agents-zh 仓库管理和激活 AI 智能体人格。支持 176 个专业智能体，涵盖工程、设计、营销、销售、产品等领域。安装后首次使用时会自动克隆仓库。当用户要求激活特定智能体（如"激活小红书运营"、"激活前端开发者"）、列出可用智能体、或搜索智能体时使用此技能。
2、输入并选择：OpenClaw: Setup Wizard。
3、在向导界面中依次填写：
Host： localhost
Port： 18789
Token： 留空（除非您在网关启动时指定了 --token 参数）。
4、点击 Approve 或 Connect 完成绑定。
四、启用编辑器上下文菜单与快捷键
VS Code默认可能禁用第三方插件的右键菜单项。即使插件已安装且网关已连通，若未显式启用，右键仍不会显示“Explain Code”“Refactor Code”等选项。
1、按下 Ctrl+, 打开设置界面。
2、在搜索栏中输入：OpenClaw: Enable Editor Context Menu。
3、找到该设置项后，勾选 Enabled 复选框。
4、同时检查以下两项是否启用：
OpenClaw: Enable Code Lens
OpenClaw: Enable Inline Suggestions。
五、验证并触发智能补全与重构功能
所有前置条件满足后，即可通过多种方式调用OpenClaw的代码理解与生成能力。每种方式对应不同开发场景，无需切换窗口即可完成操作。
1、在Python文件中输入 df.（假设df为pandas DataFrame），等待约1秒，查看是否出现带AI图标的内联补全建议。
2、选中一段含逻辑错误的代码，按下 Ctrl+Shift+P → 输入 OpenClaw: Fix This Bug 并回车。
3、将光标置于函数定义上方空白行，输入注释 # TODO: 实现用户登录校验逻辑，然后按下 Ctrl+Alt+Space 触发上下文感知补全。
4、右键任意选中文本，确认菜单底部出现 OpenClaw 子菜单，并包含 Explain Code、Refactor Code、Generate Test Cases 等选项。
