OpenClaw + VS Code: подключение, установка и настройка

VS Code (Visual Studio Code) — самый популярный редактор кода в мире, и OpenClaw встраивается в него за 5 минут. В этом руководстве — как подключить OpenClaw к VS Code на Windows, macOS и Linux, какой плагин использовать и как решить типичные ошибки запуска.

Кратко: что нужно

• VS Code 1.95+ (скачать)
• Node.js 22.12+ (важно — на Node 18 OpenClaw не запустится, см. требования к Node)
• Установленный OpenClaw (npm i -g openclaw или скрипт-установщик)
• 5 минут времени

Способ 1: запуск во встроенном терминале (рекомендуется)

OpenClaw — CLI-приложение, поэтому самый надёжный способ работы с ним в VS Code — встроенный терминал. Этот вариант не требует никаких плагинов и работает одинаково на всех ОС.

Шаг 1. Откройте проект в VS Code

File → Open Folder → выберите папку проекта

Это важно: OpenClaw читает AGENTS.md и .openclaw из корня проекта, поэтому открывайте именно папку, а не отдельный файл.

Шаг 2. Откройте встроенный терминал

Горячая клавиша: Ctrl+` (Windows/Linux) или Cmd+` (macOS).

Шаг 3. Запустите OpenClaw

openclaw

Если получаете openclaw: command not found — установите глобально:

npm install -g openclaw

Шаг 4. Проверьте Node.js

Самая частая ошибка пользователей VS Code:

openclaw: Node.js v22.12+ is required (current: v18.19.1)

Решение:

nvm install 22
nvm use 22
nvm alias default 22

После этого закройте и заново откройте терминал в VS Code, чтобы он подхватил новую версию Node. Подробнее — Node.js 22 для OpenClaw.

Способ 2: VS Code-плагин для OpenClaw

Официального расширения от команды OpenClaw в Marketplace пока нет, но есть community-плагины, которые добавляют:

• Подсветку синтаксиса AGENTS.md, SOUL.md, HEARTBEAT.md
• Сниппеты для быстрого создания скелета AGENTS.md
• Боковую панель с историей сессий OpenClaw
• Inline-индикатор, когда агент сейчас выполняет задачу в фоне

Установка:

Ctrl+Shift+X → найдите "openclaw" → Install

Выбирайте плагин с наибольшим числом установок и проверяйте, что издатель указан явно — это снижает риск зловредного расширения.

Способ 3: OpenClaw как MCP-сервер для VS Code Copilot Chat

Если вы используете GitHub Copilot Chat в VS Code, OpenClaw можно подключить как MCP-сервер — тогда вы сможете звать его инструменты прямо из Copilot:

// .vscode/mcp.json
{
  "servers": {
    "openclaw": {
      "command": "openclaw",
      "args": ["mcp", "serve"]
    }
  }
}

После перезапуска VS Code инструменты OpenClaw появятся в Copilot Chat в виде @openclaw.

Настройка: AGENTS.md в корне проекта

Чтобы агент сразу понимал ваш проект, создайте AGENTS.md в корне репозитория:

# Проект: MyApp

## Стек
- Node.js 22 + Fastify + TypeScript
- PostgreSQL 16 + Prisma

## Команды
- npm run dev
- npm run test
- npm run typecheck

## Конвенции
- Файлы: kebab-case
- Компоненты: PascalCase

## Что не трогать
- .env, /legacy/

Подробный workflow с AGENTS.md и сессиями — в статье OpenClaw + VS Code: workflow разработчика.

Горячие клавиши для быстрого запуска

Добавьте в keybindings.json (Ctrl+Shift+P → Preferences: Open Keyboard Shortcuts (JSON)):

[
  {
    "key": "ctrl+shift+o",
    "command": "workbench.action.terminal.sendSequence",
    "args": { "text": "openclaw\n" },
    "when": "terminalFocus"
  }
]

Теперь Ctrl+Shift+O запускает OpenClaw в активном терминале.

OpenClaw vs VS Code Copilot: чем отличается

Параметр	OpenClaw в VS Code	Copilot в VS Code
Где работает	CLI в терминале	Чат-панель + inline
Доступ к файлам	Полный (по allowedPaths)	Только открытые/выделенные
Локальные LLM	Да (Ollama, Qwen)	Нет
Цена	Open-source	Подписка
Сессии и память	Да, постоянные	Только в рамках чата

OpenClaw сильнее в задачах, требующих автономной работы с файлами проекта; Copilot — в inline-подсказках по мере набора. Многие используют оба.

Типичные проблемы и решения

openclaw: command not found в терминале VS Code, но работает в обычном

VS Code открывает терминал с урезанным PATH. Решение: в настройках VS Code (Ctrl+,) включите Terminal › Integrated › Inherit Env и перезапустите VS Code.

Запуск через nvm-версию Node не подхватывается

Добавьте в начало встроенного терминала команду:

source ~/.nvm/nvm.sh && nvm use 22

Или укажите путь к нужному Node в Terminal › Integrated › Env: Osx/Linux/Windows.

Агент не видит AGENTS.md

Проверьте, что папка проекта открыта именно как корень (а не вложенная). В терминале выполните pwd — путь должен совпадать с папкой, где лежит AGENTS.md.

Высокое потребление токенов

Ограничьте контекст через .openclaw:

{
  "allowedPaths": ["src/", "tests/"],
  "deniedPaths": ["node_modules/", "dist/", ".env*"]
}

Подробнее — оптимизация стоимости токенов.

Что дальше

• Workflow разработчика в VS Code — сессии, code review, тесты
• Подключение MCP-серверов — расширение возможностей агента
• Permissions и yolo-режим — как настроить права доступа
• Локальные модели через Ollama — работа без облака

Соседние интеграции с рабочими сервисами: GitHub и Google Workspace.