当前位置：首页 > news >正文

OpenClaw-VSCode：在 VS Code 里玩转 OpenClaw，远程管理+SSH 双剑合璧 - 教程

news 2026/3/27 2:47:42

OpenClaw-VSCode：在 VS Code 里玩转 OpenClaw，远程管理+SSH 双剑合璧

摘要：还在频繁切换窗口管理 OpenClaw？试试这款开源 VS Code 插件！通过 WebSocket 直连网关，侧边栏即可聊天交互，配合 VS Code SSH 远程开发，打造丝滑的远程 AI 工作流。

项目地址：https://github.com/MaoTouHU/openclaw-vscode

关键词：OpenClaw、VS Code 插件、WebSocket、远程开发、AI 网关

文章目录

OpenClaw-VSCode：在 VS Code 里玩转 OpenClaw，远程管理+SSH 双剑合璧

一、痛点：为什么需要 OpenClaw-VSCode？

在使用 OpenClaw 这类 AI 网关时，开发者常面临几个烦恼：

窗口切换频繁 —— 需要单独打开浏览器或客户端管理对话
远程开发割裂 —— 用 VS Code SSH 连服务器写代码，却没法直接操作部署在远端的 OpenClaw
配置繁琐 —— 手动改配置文件容易出错

OpenClaw-VSCode 正是为解决这些问题而生。它将 OpenClaw 的交互能力直接嵌入 VS Code 侧边栏，让你在编码的同时无缝管理 AI 对话。
在这里插入图片描述

二、核心功能一览

功能	亮点说明
WebSocket 远程连接	支持本地/远程网关，实时双向通信
侧边栏聊天界面	原生 VS Code UI 风格，不跳出编辑器
Token 身份认证	企业级安全验证，防止未授权访问
⚙️ 可视化配置	点击设置，告别手搓 JSON
自动重连机制	网络波动也不怕，自动恢复连接

三、安装与配置（5 分钟上手）

3.1 安装插件

目前可通过以下方式安装：

方式一：VS Code 扩展市场搜索 OpenClaw（待上架）
方式二：本地安装 .vsix 文件（见项目 Release）

# 克隆项目自行打包
git clone https://github.com/MaoTouHU/openclaw-vscode.git
cd openclaw-vscode
npm install
npm run package
# 在 VS Code 中安装生成的 .vsix 文件

3.2 连接配置

安装后，在 VS Code 左侧活动栏找到 OpenClaw 图标，点击 ⚙️ 配置：

场景 A：本地开发

{
"openclaw.gatewayUrl": "ws://localhost:18789",
"openclaw.gatewayToken": ""
}

场景 B：远程服务器（配合 SSH）

{
"openclaw.gatewayUrl": "ws://your-server.com:18789",
"openclaw.gatewayToken": "your-secret-token"
}

场景 C：生产环境（WSS 加密）

{
"openclaw.gatewayUrl": "wss://your-domain.com:18789",
"openclaw.gatewayToken": "your-secret-token"
}

技巧：配合 VS Code 的 SSH 远程开发功能，你可以在连接远程服务器写代码的同时，直接管理部署在该服务器上的 OpenClaw，无需额外端口映射！

四、实战：SSH 远程开发工作流

这是本插件最香的使用场景：

SSH 连接到远程服务器（VS Code Remote-SSH）
安装 OpenClaw-VSCode 插件（会自动同步到远程）

配置指向本地（对远程而言）的 Gateway

{
"openclaw.gatewayUrl": "ws://localhost:18789"
}

开始边写代码边对话，所有操作都在一个窗口完成

这种"代码+AI"同屏工作流，大幅提升远程开发效率。

五、命令速查

命令	作用
`OpenClaw: 连接到网关`	建立 WebSocket 连接
`OpenClaw: 断开连接`	手动断开当前会话
`OpenClaw: 配置连接`	修改 URL 和 Token

快捷键：Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（Mac）打开命令面板。

六、技术栈与二次开发

本项目基于以下技术构建：

TypeScript —— 类型安全的扩展开发
VS Code Extension API —— 原生侧边栏 Webview
WebSocket Client —— 实时通信

本地开发

# 1. 克隆仓库
git clone https://github.com/MaoTouHU/openclaw-vscode.git
# 2. 安装依赖
npm install
# 3. 编译并监听
npm run watch
# 4. 按 F5 启动调试（会新开 Extension Development Host 窗口）

项目结构

openclaw-vscode/
├── src/
│   ├── extension.ts          # 入口文件
│   ├── panel/                # 侧边栏面板逻辑
│   └── websocket/            # WebSocket 连接管理
├── media/                    # UI 资源（HTML/CSS/JS）
└── package.json              # 扩展配置