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-сервер для подключения ваших внутренних инструментов.