OpenClaw Client for VSCode

AI chat sidebar and node host for OpenClaw gateway. Connects to your OpenClaw instance via WebSocket and provides a native chat interface directly in VSCode.

Features

• Agent HUD — Connection status, model settings, session management
• Multi-Agent Support — Switch between agents (main, clerk, coder2, designer, manager, etc.) with one click; each agent gets its own chat tab and independent session pool
• Session Management — Each agent maintains multiple sessions; create, switch, and delete sessions independently per agent
• Supervisor Mode — Configure a supervisor agent to periodically check your current agent's output with customizable intervals, reminder messages, and stop signals
• Streaming Responses — Real-time markdown rendering of AI responses
• Image & Video Support — Automatically display images and videos embedded in gateway replies (base64-encoded data URLs)
• Auto-Retry on Agent Failure — When the gateway returns an agent run failure error, the extension automatically sends "Continue" up to 3 times to resume the conversation. Resets when a normal response is received or the user sends a new message.
• Slash Commands — Type / to see available commands (/stop, /new, /models, /help, etc.), sent to gateway and response displayed in chat
• Context Meter — Visual indicator of token usage per session
• Device Identity — Ed25519 signed authentication (compatible with OpenClaw pairing)
• Message History — Persistent input history, cycle with Ctrl+Up / Ctrl+Down
• @path File Context — Type @ to search and attach workspace files as context to your message
• Directory Navigation — Type @folder/ to browse directory contents; selecting a directory auto-expands its children
• Line Number References — Attach file context with line numbers using @path#L123 (single line) or @path#L100-#L200 (line range)
• Node Capabilities — Runs as a paired node, enabling exec, read, write, edit tool calls from the agent
• Exec Approval — Commands are executed locally with a cwd-based approval dialog (Allow Once / Always Allow / Deny)
• Configurable Agent/Session — Set agentId and sessionKey in VSCode settings to control which agent and session the extension connects to
• Open Agent Workspace — Add the agent's workspace folder to VS Code Explorer with one click

Requirements

• A running OpenClaw gateway (default: ws://127.0.0.1:18789)
• VSCode 1.80 or newer
• An open workspace folder (for file search and node tool execution)

Install

From VS Marketplace

Search for nufeng1999 in the VS Code Extensions panel, or visit the Marketplace page.

From Source

git clone <repo-url>
cd openclaw-vscode
npm install
npm run build

Then copy the folder to ~/.vscode/extensions/.

Configuration

Open VSCode Settings and search for openclaw:

General Settings

Supervisor Settings

Usage

1. Start the OpenClaw gateway
2. Open the OpenClaw sidebar from the Activity Bar
3. The extension connects automatically (operator + node)
4. Click Chat in the tabs bar to start chatting
5. Click agent buttons in the HUD to switch agents

HUD Panel

Toggle with the grid button (⊞) in the tabs bar. Contains:

• Agent Card — Name, emoji, connection status
• Agent Buttons — Switch between agents (shown when multiple agents exist)
• Settings — Model defaults, reliability settings, server info
• Sessions — List of chat sessions with token usage

Chat Panel

• Tabs — Each agent gets its own tab, click to switch
• Messages — Markdown-rendered assistant responses
• Input — Type and press Enter to send, Shift+Enter for newline
• Stop — Abort a running response

Multi-Agent Support

The extension supports multiple agents, each with its own chat tab and independent session pool:

Common Agent IDs:

• main — General-purpose agent
• clerk — Administrative and coordination tasks
• coder2 — Code-focused coding agent
• designer — Design and UI tasks
• manager — Project management and oversight

Session Management

Each agent has its own session pool. Manage sessions in the Sessions panel:

• New Session — Create a fresh session for the current agent
• Switch Session — Click any session to switch to it
• Delete Session — Remove unwanted sessions

Session state (message history, context) is preserved per agent.

Supervisor Feature

Configure a supervisor agent to periodically check your current agent's output and intervene if needed.

Enabling Supervision

Enable supervision via the checkbox in the chat HUD panel, or use the toggleSupervision command. When active, the extension periodically checks whether the current agent's output has changed, sends reminders if it hasn't, and asks the supervisor agent for a stop decision.

Configuration Example

{
  "openclaw.supervisor.agentId": "manager",
  "openclaw.supervisor.intervalMinutes": 5,
  "openclaw.supervisor.stopInquiryMethod": "请判断",
  "openclaw.supervisor.reminderMessage": "Please continue your work.",
  "openclaw.supervisor.stopSignalContent": "done|finished|completed",
  "openclaw.supervisor.stopSignalReply": "yes"
}

Parameters

How It Works

1. On enable, the extension sends a hello handshake to the supervisor agent (30s timeout)
2. Every intervalMinutes, the extension fetches the current agent's last output via chat.history
3. If output is unchanged, the extension sends reminderMessage to the current agent
4. The extension sends an inquiry to the supervisor agent and waits for a reply
5. If the supervisor replies with stopSignalReply (or output matches stopSignalContent), supervision stops
6. Otherwise, supervision continues until the user disables it or the output changes

Message History

Your sent messages are saved automatically (up to 200 entries, persisted across sessions).

History resets when you send a new message.

Slash Commands

Type / in the chat input to trigger the slash command dropdown. Commands are sent to the gateway and the response is displayed as an assistant message.

Navigate with ↑ / ↓, press Enter to select, or Escape to cancel.

@path File Context

Type @ in the input box to trigger file search. A dropdown shows workspace files and folders matching your query.

Directory Navigation

When you type @folder/ (with a trailing slash), the dropdown lists the contents of that directory — subdirectories and files. Selecting a directory from the list inserts @folder/subdir/ and automatically expands it, letting you drill down without re-typing. Selecting a file inserts @filepath (with a trailing space) and closes the dropdown.

In multi-root workspaces (multiple folders in the workspace), file paths are prefixed with the workspace folder name to avoid ambiguity, e.g. cqcbit.nufeng-openclaw-vscode-0.0.14/src/chatView.ts.

Line Number References

You can attach file context with specific line numbers:

When the message is sent, line number information is passed as structured data ({path, line} or {path, startLine, endLine}) to the OpenClaw gateway, allowing the AI to pinpoint exact code locations.

File Content Attachment

When you send a message containing @path, the referenced file's content is automatically read and attached as context to the AI. The @path text remains visible in the message so the AI knows which files you referenced.

• Text files: content sent as UTF-8
• Binary files (images, etc.): sent as base64 with correct MIME type
• Size limit: 20 MB total per message

Node Capabilities

On first connection, the extension registers as a node alongside its operator role. This enables the AI agent to call built-in tools:

• exec — Execute shell commands on your local machine
• read — Read files from your workspace
• write — Create or overwrite files
• edit — Apply targeted text replacements in files

Exec Approval

When the agent tries to run a command, a VSCode QuickPick dialog appears:

Approval is based on the working directory (cwd), not the specific command. Subdirectories inherit approval from their parent.

Open Agent Workspace

Clicking the Open current agent workspace button adds the agent's workspace folder to the VS Code Explorer sidebar as a multi-root entry. If the folder is already present in the workspace, the button focuses and expands it in the Explorer instead. No dialogs are shown. This works regardless of whether VS Code is in single-root, multi-root, or no-workspace mode.

Commands

How It Works

The extension connects to the OpenClaw gateway with two roles:

1. Operator — UI client for chat, sessions, and agent management
2. Node — Paired node host for tool execution (exec, read, write, edit)

Connection Flow

1. WebSocket opens → receives connect.challenge with nonce
2. Sends connect request with Ed25519 device identity signature
3. On success, loads agents, sessions, and defaults
4. Registers node capabilities (system.run, system.which, etc.)
5. Chat messages are sent via chat.send RPC
6. Responses stream in via chat events (delta → final)
7. On agent run failure responses, auto-sends "Continue" up to 3 times to resume conversation

Node Pairing

The node is auto-approved on first connect. If pairing is needed:

1. The extension sends node.pair.requested to the gateway
2. Run openclaw devices approve --latest on the server, or
3. Use the Approve Node Pairing command in VSCode

Development

npm install
npm run build        # one-time build
npm run watch        # rebuild on change

Reload VSCode after each build to test changes.

License

MIT