RouteClaw

OpenClaw с умным pre-filter роутингом — отвечает на простые вопросы в ~50 токенов вместо 2 000+.

RouteClaw — это форк OpenClaw (MIT), который устраняет главную неэффективность шлюза: системный промпт на ~2 000 токенов отправлялся при каждом сообщении, включая "привет" и heartbeat-пинги.

Путь запроса — OpenClaw vs RouteClaw

flowchart TB
    classDef waste  fill:#ffe0e0,stroke:#cc3333,color:#333
    classDef save   fill:#e0ffe0,stroke:#339933,color:#333
    classDef fwd    fill:#fff8e0,stroke:#cc9900,color:#333
    classDef io     fill:#f0f0ff,stroke:#6666cc,color:#333

    subgraph OC["🦞  OpenClaw — каждое сообщение без исключений"]
        direction TB
        OC1([Сообщение пользователя]):::io
        OC1 --> OC2[Загрузка файлов воркспейса\nSOUL.md · AGENTS.md · USER.md …]:::waste
        OC2 --> OC3[Построение системного промпта\n~2 000 токенов]:::waste
        OC3 --> OC4[Вставка inbound_meta\nв системный промпт\n⚡ кэш сбрасывается на каждом чате]:::waste
        OC4 --> OC5[API-вызов\n~2 050 токенов 💸]:::waste
        OC5 --> OC6([Ответ]):::io
    end

    subgraph RC["🦎  RouteClaw — умный роутинг"]
        direction TB
        RC1([Сообщение пользователя]):::io
        RC1 --> RC2{"Pre-filter\n~50 токенов"}:::save
        RC2 -- "✅ может ответить сразу" --> RC3([Прямой ответ\n~50 токенов итого]):::save
        RC2 -- "FORWARD\nнужны инструменты / поиск" --> RC4[Загрузка файлов воркспейса]:::fwd
        RC4 --> RC5["Построение системного промпта\n(SYSTEM.md или фреймворк)"]:::fwd
        RC5 --> RC6["inbound_meta → user context\n✅ системный промпт остаётся в кэше"]:::fwd
        RC6 --> RC7[API-вызов\n~2 100 токенов]:::fwd
        RC7 --> RC8([Ответ]):::io
    end

Простое сообщение ("привет", "сколько будет 2+2?") — RouteClaw отвечает на уровне pre-filter, не трогая файлы воркспейса и историю. Сложное сообщение ("найди последние новости об ИИ") — идёт через FORWARD и запускает полный pipeline, как в OpenClaw.

Бенчмарк токенов

| Сообщение | OpenClaw | RouteClaw | Экономия | |-----------|:--------:|:---------:|:--------:| | "привет" | ~2 050 | ~50 | 97 % | | "что такое DNS?" | ~2 050 | ~200 | 90 % | | "найди новости об ИИ" | ~2 050 | ~2 100 * | 0 % |

* Сложные запросы проходят полный pipeline — такая же стоимость, как в upstream.

Что добавляет RouteClaw

1 · Pre-filter агент

До загрузки файлов воркспейса, инструментов или истории RouteClaw делает маленький API-вызов с однострочным системным промптом:

• Может ответить из знаний → отвечает напрямую (~50 токенов итого)
• Нужны инструменты, поиск или контекст → отправляет FORWARD, запускается полный pipeline

Применяется только к агенту g1. Всё остальное без изменений.

2 · Метаданные перенесены в user context

inbound_meta (chat ID, account ID, тип канала и т.д.) раньше вставлялась в системный промпт, сбрасывая prefix-кэш при каждом новом чате. RouteClaw переносит её в user context — системный промпт остаётся статичным и кэшируется провайдером между сообщениями.

3 · Все промпты настраиваются через Markdown-файлы

Никакого hardcoded текста в JS/TS — каждый промпт это .md файл:

| Файл | Управляет | |------|-----------| | ~/.openclaw/prefilter-g1.md | Системный промпт pre-filter (горячая перезагрузка каждые 30 с) | | <workspace>/SYSTEM.md | Базовый промпт агента — полностью заменяет ~2 000-токенный шаблон фреймворка | | <workspace>/AGENTS.md | Правила роутинга агентов | | <workspace>/SOUL.md | Личность / тон | | <workspace>/IDENTITY.md | Идентичность |

Установка

# Новая установка
npm install -g routeclaw

# Оба CLI-псевдонима работают — один бинарник
routeclaw gateway start
openclaw gateway start

Миграция с OpenClaw

npm uninstall -g openclaw
npm install -g routeclaw
# Все файлы ~/.openclaw/* сохраняются

Настройка промпта pre-filter

Создайте ~/.openclaw/prefilter-g1.md (горячая перезагрузка каждые 30 с, рестарт не нужен):

Ответь на вопрос пользователя, если можешь сделать это без дополнительных
источников информации: интернета, локальных данных и т.д.
Отвечай кратко и по делу.
Если не можешь — ответь ровно одним словом: FORWARD

Файл создаётся автоматически с содержимым по умолчанию при первом запуске.

Системный промпт агента — SYSTEM.md

При первом запуске RouteClaw автоматически создаёт SYSTEM.md в каждом воркспейсе агента (например ~/.openclaw/workspace-g1-worker/SYSTEM.md) с дефолтными инструкциями OpenClaw. Никакого текста промптов в скомпилированном JS/TS нет — SYSTEM.md является единственным источником истины.

| Состояние файла | Поведение | |----------------|-----------| | Файл отсутствует | Создаётся автоматически с дефолтным промптом OpenClaw | | Файл не пустой | Используется как базовый системный промпт агента | | Файл пустой | Системный промпт не отправляется совсем |

Динамические строки (путь воркспейса, рантайм-инфо) всегда добавляются после содержимого файла. Bootstrap-файлы (AGENTS.md, SOUL.md и т.д.) по-прежнему инжектируются отдельно — они не затрагиваются.

Содержимое SYSTEM.md по умолчанию

Именно это получает каждая свежая установка. Редактируйте свободно — изменения вступают в силу после рестарта шлюза.

You are a personal assistant running inside OpenClaw.

## Tooling
Structured tool definitions are the source of truth for tool names, descriptions, and parameters.
Tool names are case-sensitive. Call tools exactly as listed in the structured tool definitions.
If a tool is present in the structured tool definitions, it is available unless a later tool call reports a policy/runtime restriction.
TOOLS.md does not control tool availability; it is user guidance for how to use external tools.

For follow-up at a future time (for example "check back in 10 minutes", reminders, run-later work,
or recurring tasks), use cron instead of exec sleep, yieldMs delays, or process polling.
Use exec/process only for commands that start now and continue running in the background.
For long-running work that starts now, start it once and rely on automatic completion wake when it
is enabled and the command emits output or fails; otherwise use process to confirm completion.
Do not emulate scheduling with sleep loops, timeout loops, or repeated polling.

For non-trivial multi-step work, keep a short plan updated with `update_plan`.
Skip `update_plan` for simple tasks or work you can finish in a few direct actions.
If a task is more complex or takes longer, spawn a sub-agent. Completion is push-based.
Do not poll `subagents list` / `sessions_list` in a loop; only check status on-demand.

## Tool Call Style
Default: do not narrate routine, low-risk tool calls (just call the tool).
Narrate only when it helps: multi-step work, complex problems, sensitive actions, or when asked.
When a first-class tool exists for an action, use it directly.
Never execute /approve through exec — it is a user-facing command, not a shell command.

## Execution Bias
If the user asks you to do the work, start doing it in the same turn.
Use a real tool call or concrete action first; do not stop at a plan or promise-to-act reply.
If the work will take multiple steps, send one short progress update before or while acting.

## Safety
You have no independent goals: do not pursue self-preservation, replication, resource acquisition,
or power-seeking; avoid long-term plans beyond the user's request.
Prioritize safety and human oversight over completion; comply with stop/pause/audit requests.
Do not manipulate anyone to expand access or disable safeguards.

## OpenClaw CLI Quick Reference
OpenClaw is controlled via subcommands. Do not invent commands.
- openclaw gateway status / start / stop / restart
If unsure, ask the user to run `openclaw help` and paste the output.

## Silent Replies
Use NO_REPLY ONLY when no user-visible reply is required.
It must be your ENTIRE message. Never append it to an actual response.

Чтобы полностью заменить промпт — перепишите файл своим содержимым. Чтобы отключить системный промпт полностью — очистите файл (echo -n > SYSTEM.md).

Обновление вместе с upstream

git remote add upstream https://github.com/openclaw/openclaw
git fetch upstream
git rebase upstream/main
pnpm build

Конфликты возникают только в 3 файлах: prefilter.ts · get-reply.ts · inbound-meta.ts

Полная документация

По каналам, скиллам, онбордингу, Docker и всему остальному — документация upstream OpenClaw. RouteClaw полностью совместим: тот же формат конфигов, та же структура воркспейса, те же CLI-команды.

🇬🇧 Read in English

Лицензия

MIT — как и в upstream OpenClaw.