工作区浏览器:为 AI 代理提供安全的远程 IDE 访问 - Openclaw Skills

作者:互联网

2026-04-17

AI快讯

什么是 工作区浏览器?

工作区浏览器是一款专门设计的实用工具,旨在通过提供基于浏览器的安全 VS Code 环境,弥合 AI 代理与其所有者之间的鸿沟。通过利用 code-server 和 Cloudflare 隧道,此技能允许用户在不损害本地网络安全的情况下,进行深入的代码检查、安装扩展并实时导航代码库。

作为 Openclaw Skills 生态系统中的一个通用组件,它确保了人类所有者与 AI 代理之间的协作既无缝又受保护。它消除了复杂的防火墙配置或静态 IP 设置的需求,使其成为临时远程审计和交互式开发环节的理想工具。

下载入口:https://github.com/openclaw/skills/tree/main/skills/mrbeandev/workspace-explorer

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install workspace-explorer

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 /skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 workspace-explorer。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

工作区浏览器 应用场景

  • 与所有者共享实时工作区,进行实时的文件和目录检查。
  • 为手动调试或使用特定 IDE 功能提供代码库的远程访问。
  • 为远程工作区审计和安全审查创建临时的安全隧道。
  • 方便在所有者需要浏览器中完整 IDE 功能的情况下进行协作代码审查。
工作区浏览器 工作原理
  1. 用户或代理通过提供特定的目录路径作为工作区来触发脚本。
  2. 在首次执行期间,该技能会自动下载所需的二进制文件,包括 code-server 和 cloudflared。
  3. 在指定端口上初始化本地 code-server 实例,以提供指定的工作区。
  4. 建立安全的 Cloudflare 隧道,将本地实例映射到临时的公共 .trycloudflare.com 域名。
  5. 系统生成一个唯一的、加密安全的密码,并向所有者显示访问 URL。

工作区浏览器 配置指南

要将其集成到您的 Openclaw Skills 库中,请克隆存储库并使用 Python 运行启动脚本:

git clone https://github.com/mrbeandev/workspace-explorer.git
cd workspace-explorer
python3 scripts/start_workspace.py /path/to/your/workspace

工作区浏览器 数据架构与分类体系

组件 描述
二进制文件 code-server 和 cloudflared 可执行文件的本地存储。
会话数据 临时元数据,包括活动的隧道 URL 和生成的密码。
心跳 利用 HEARTBEAT.md 文件监控 Openclaw Skills 中的活动会话。
name: workspace-explorer
description: Securely share your workspace with your owner via a remote VS Code environment. Use when (1) the owner requests to view or inspect your working files, (2) you need to give the owner live access to browse your codebase, (3) the owner wants to install extensions or use IDE features to explore files, or (4) you need a temporary secure tunnel for remote workspace inspection.
homepage: https://github.com/mrbeandev/workspace-explorer
user-invocable: true

Workspace Explorer

Provide secure, temporary access to your workspace via code-server (VS Code in browser) tunneled through Cloudflare.

Repository: https://github.com/mrbeandev/workspace-explorer

Installation

git clone https://github.com/mrbeandev/workspace-explorer.git

Usage

Run the start script with the workspace path:

python3 {baseDir}/scripts/start_workspace.py /path/to/workspace

The script will:

  1. Download binaries on first run (code-server + cloudflared)
  2. Start code-server on localhost
  3. Create a Cloudflare tunnel
  4. Print the public URL and password directly to terminal (Note: Wait 15-30s for the URL to become active)

Example output: ```

? WORKSPACE READY!

?? URL: https://random-words.trycloudflare.com ?? Password: xY7kL9mN2pQ4

?? Share the URL and password with your owner. Press Ctrl+C to terminate the session.


## Options

```bash
python3 {baseDir}/scripts/start_workspace.py /path/to/workspace --port 9000
Option Default Description
workspace (required) Path to directory to serve
--port 8080 Local port for code-server
--status (flag) Check if workspace is running

Heartbeat Support

This project includes a HEARTBEAT.md file. When installed as an OpenClaw skill, the agent will periodically check if the tunnel is active and remind you if it's left running for too long.

Termination

Press Ctrl+C to stop the session. Both code-server and the tunnel will be terminated.

Security

  • Each session generates a unique cryptographically secure password
  • Tunnel URLs are temporary .trycloudflare.com domains
  • No ports need to be opened on firewall
  • Session ends when script is terminated

相关推荐