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

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?

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

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

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


二、核心功能一览

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

三、安装与配置(5 分钟上手)

3.1 安装插件

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

  • 方式一 :VS Code 扩展市场搜索 OpenClaw(待上架)
  • 方式二 :本地安装 .vsix 文件(见项目 Release)
bash 复制代码
# 克隆项目自行打包
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:本地开发

json 复制代码
{
  "openclaw.gatewayUrl": "ws://localhost:18789",
  "openclaw.gatewayToken": ""
}

场景 B:远程服务器(配合 SSH)

json 复制代码
{
  "openclaw.gatewayUrl": "ws://your-server.com:18789",
  "openclaw.gatewayToken": "your-secret-token"
}

场景 C:生产环境(WSS 加密)

json 复制代码
{
  "openclaw.gatewayUrl": "wss://your-domain.com:18789",
  "openclaw.gatewayToken": "your-secret-token"
}

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


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

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

  1. SSH 连接到远程服务器(VS Code Remote-SSH)

  2. 安装 OpenClaw-VSCode 插件(会自动同步到远程)

  3. 配置指向本地(对远程而言)的 Gateway

    json 复制代码
    {
      "openclaw.gatewayUrl": "ws://localhost:18789"
    }
  4. 开始边写代码边对话,所有操作都在一个窗口完成

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


五、命令速查

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

快捷键:Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(Mac)打开命令面板。


六、技术栈与二次开发

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

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

本地开发

bash 复制代码
# 1. 克隆仓库
git clone https://github.com/MaoTouHU/openclaw-vscode.git

# 2. 安装依赖
npm install

# 3. 编译并监听
npm run watch

# 4. 按 F5 启动调试(会新开 Extension Development Host 窗口)

项目结构

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

七、常见问题

Q:连接失败怎么办?

  • 检查 OpenClaw Gateway 是否已启动并监听对应端口
  • 确认防火墙/安全组放行 WebSocket 端口(默认 18789)
  • 查看 VS Code 输出面板(Output > OpenClaw)的详细日志

Q:支持 wss 吗?

  • 完全支持,只需将 URL 协议改为 wss:// 并配置有效证书

Q:Token 如何获取?

  • 在 OpenClaw Gateway 的配置文件中查看或生成

八、参与贡献

本项目采用 MIT 协议 开源,欢迎提交 PR:

  • 🐛 Bug 反馈:GitHub Issues
  • 💡 功能建议:Discussions
  • 🔧 代码贡献:Fork 后提交 PR

Star 支持 :如果觉得有用,请给项目点个 ⭐ https://github.com/MaoTouHU/openclaw-vscode


九、总结

OpenClaw-VSCode 填补了 OpenClaw 在 IDE 集成方面的空白,特别适合:

  • 需要远程管理 OpenClaw 的开发者
  • 追求All-in-One 工作流的效率党
  • 使用 VS Code SSH 远程开发的用户

立即体验 :https://github.com/MaoTouHU/openclaw-vscode


本文首发于 CSDN,转载请注明出处。

相关推荐
ndz9 小时前
PixVerse 768 个官方特效模板:Playground 预览,再用 API 批量出视频
ai编程
冬奇Lab11 小时前
一天一个开源项目(第263篇):江山时序 —— 纯静态的中国历史交互地图,从三家分晋拖到今天,还能让 AI 查地名
开源
LV技术派11 小时前
肝了一周,我把 Super Agent 的架构融入到了我的 AI Native 工作台中
aigc·ai编程
wflynn12 小时前
GitHub 日榜趋势速报 | 2026-11-18
开源·github
孟健13 小时前
用 unslop 拯救 AI 生成网页的塑料感,7 分钟重构落地实测
前端·人工智能·ai编程
Hvitur13 小时前
Git - 多分支合并
git·github
stormzhangV14 小时前
Google 重返第一梯队
人工智能·google·aigc
Pniubi14 小时前
SoduWork开源贡献日记——开源贡献入门教程
开源
Yeautumn16 小时前
给 Antigravity 搓了个「主 Carbon + 副 Neon」混合编排插件:让顶配模型当包工头,快手模型并发干活
开源
工程小白菜16 小时前
ai-code-review 全链路:让 AI 来审 AI 的代码
ci/cd·ai编程