VS Code (он же VSCode, Visual Studio Code) — самый популярный редактор для разработчиков, но большинство используют его и OpenClaw как отдельные инструменты. Правильная интеграция превращает их в единый workflow: агент понимает контекст вашего проекта, следует его конвенциям и помогает там, где это нужно прямо сейчас.

Если вы ещё не подключили OpenClaw к VS Code — начните с гайда OpenClaw + VS Code: подключение, установка и настройка. Эта же статья — про продвинутый workflow.

Установка и базовая настройка

OpenClaw работает в терминале VS Code так же, как в обычном. Откройте встроенный терминал (Ctrl+`) и запустите:

openclaw

Но чтобы агент понимал ваш проект, нужно несколько минут настройки.

AGENTS.md в корне проекта — главный файл

Создайте AGENTS.md в корне репозитория. OpenClaw читает его автоматически при запуске в этой папке:

# Контекст проекта: MyApp

## Стек
- Backend: Node.js 22 + Fastify + TypeScript
- Database: PostgreSQL 16 + Prisma ORM
- Frontend: React 19 + Vite
- Testing: Vitest + Playwright

## Конвенции кода
- Именование файлов: kebab-case
- Компоненты: PascalCase
- Константы: SCREAMING_SNAKE_CASE
- Ветки: feature/*, fix/*, chore/*

## Структура проекта
- src/api/ — роуты Fastify
- src/services/ — бизнес-логика
- src/models/ — Prisma модели
- src/components/ — React компоненты

## Команды разработки
- npm run dev — запуск в development
- npm run test — запуск тестов
- npm run typecheck — проверка типов
- npm run db:migrate — применить миграции

## Что НЕ трогать
- /legacy/ — старый код, не рефакторить без согласования
- .env файлы — не изменять, не выводить в чат

Теперь агент знает ваш стек, конвенции и ограничения с первой команды.

Workflow: код-ревью через OpenClaw

Типичный сценарий — ревью изменений перед коммитом:

# В терминале VS Code
openclaw

# В чате с агентом:
> Сделай code review diff'а текущей ветки относительно main.
  Особое внимание на: типобезопасность, потенциальные race conditions,
  соответствие конвенциям из AGENTS.md

Агент запустит git diff main...HEAD, прочитает файлы и даст конкретные замечания с номерами строк.

Workflow: написание тестов

> Напиши Vitest unit-тесты для функции calculateDiscount в src/services/pricing.ts.
  Покрой: базовый кейс, граничные значения, исключения.
  Файл тестов создай рядом: src/services/pricing.test.ts

Агент прочитает файл с функцией, поймёт зависимости и напишет тесты в вашем стиле (если в AGENTS.md указан testing framework).

Workflow: создание нового эндпоинта

> Создай CRUD-эндпоинт для сущности Product:
  - GET /products (список с пагинацией)
  - GET /products/:id
  - POST /products (только для admin)
  - PUT /products/:id
  - DELETE /products/:id

  Следуй структуре существующих роутов в src/api/users.ts

Агент изучит существующие роуты, поймёт паттерны и создаст согласованный код.

Настройка .openclaw в проекте

Помимо AGENTS.md, создайте .openclaw файл для настроек конкретно для этого проекта:

{
  "allowedPaths": ["src/", "tests/", "prisma/"],
  "deniedPaths": ["secrets/", ".env*", "node_modules/"],
  "preferredModel": "claude-sonnet-4-6",
  "autoContext": true,
  "contextFiles": [
    "AGENTS.md",
    "src/types/index.ts",
    "prisma/schema.prisma"
  ]
}

contextFiles — файлы, которые агент всегда читает в начале сессии. Добавьте туда типы и схему БД — агент будет понимать структуру данных без дополнительных вопросов.

Терминальные сессии: работа с большими задачами

Для многошаговых задач используйте именованные сессии:

# Начало сессии с именем
openclaw --session refactor-auth

# Продолжение той же сессии позже
openclaw --session refactor-auth --resume

Сессия сохраняет весь контекст разговора. Можно закрыть терминал, вернуться завтра и продолжить с того же места.

Интеграция с Git через OpenClaw

# Интерактивный коммит с умным сообщением
> Посмотри на staged изменения и составь commit message
  по conventional commits. Предложи 3 варианта.

# Подготовка PR description
> На основе всех коммитов этой ветки составь описание PR:
  что изменено, почему, как тестировать.

Горячие клавиши: открываем терминал быстрее

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

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

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

Расширение OpenClaw для VS Code

Официального расширения пока нет, но сообщество создало несколько unofficial. Самое популярное — openclaw-vscode (устанавливается через Marketplace):

Подсветка .openclaw файлов
Сниппеты для AGENTS.md
Панель с историей сессий
Inline подсказки когда агент выполняет задачу

Параллельная работа: агент + вы

Самый продуктивный паттерн — разделить экран. В левой половине VS Code вы пишете код, в правой — встроенный терминал с OpenClaw:

┌──────────────────┬──────────────────┐
│ Editor           │ OpenClaw Terminal │
│                  │                  │
│ ← вы редактируете│ ← агент          │
│    файлы         │    помогает,      │
│                  │    объясняет,     │
│                  │    пишет тесты   │
└──────────────────┴──────────────────┘

Агент видит ваши изменения через файловую систему в реальном времени.

Частые ошибки

1. Запускаете OpenClaw не из корня проекта AGENTS.md не будет найден. Всегда запускайте из папки проекта: cd /path/to/project && openclaw.

2. Слишком широкие задачи без контекста «Отрефакторь весь проект» — плохо. «Отрефакторь функцию calculateTax в src/services/tax.ts, применив паттерн Strategy» — хорошо.

3. Не ограничиваете allowedPaths Агент может случайно изменить конфиги или сгенерировать файлы не в том месте. Задайте allowedPaths явно.

4. Игнорируете AGENTS.md Без него агент каждый раз спрашивает базовые вещи: «Какой стек?», «Как запустить тесты?». 30 минут на AGENTS.md экономят часы в неделю.

Итог

Связка VS Code + OpenClaw работает максимально когда: проект имеет AGENTS.md, сессии именованы, allowedPaths ограничен, а задачи конкретны. Инвестируйте 30 минут в настройку — и агент станет не «ещё одним чатботом», а реальным участником разработки.

Следующий шаг: создайте MCP-сервер для подключения ваших внутренних инструментов.