> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenProse

OpenProse — это переносимый формат рабочих процессов, ориентированный прежде всего на Markdown, для оркестрации сеансов ИИ. В OpenClaw он поставляется как плагин, устанавливающий пакет Skills OpenProse и слеш-команду `/prose`. Программы хранятся в файлах `.prose` и могут запускать несколько субагентов с явно заданным потоком управления.

> [card] [Установка](#install)
>
> Включите плагин OpenProse и перезапустите Gateway.

> [card] [Запуск программы](#slash-command)
>
> Используйте `/prose run`, чтобы выполнить файл `.prose` или удалённую программу.

> [card] [Написание программ](#example-parallel-research-and-synthesis)
>
> Создавайте многоагентные рабочие процессы с параллельными и последовательными этапами.

## Установка

**1. Включите плагин**

OpenProse входит в комплект поставки, но по умолчанию отключён. Включите его:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins enable open-prose
```

**2. Перезапустите Gateway**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway restart
```

**3. Проверьте установку**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins list | grep prose
```

`open-prose` должен отображаться как включённый. Теперь в чате доступна команда Skills `/prose`.

При работе с клоном репозитория плагин можно установить напрямую:
`openclaw plugins install ./extensions/open-prose`

## Слеш-команда

OpenProse регистрирует `/prose` как команду Skills, которую может вызывать пользователь:

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
/prose help
/prose run <file.prose>
/prose run <handle/slug>
/prose run <https://example.com/file.prose>
/prose compile <file.prose>
/prose examples
/prose update
```

`/prose run <handle/slug>` разрешается в `https://p.prose.md/<handle>/<slug>`.
Прямые URL загружаются без изменений с помощью инструмента `web_fetch`.

Удалённые запуски верхнего уровня задаются явно. Удалённые импорты внутри программы `.prose` являются транзитивными зависимостями кода: прежде чем OpenProse загрузит какую-либо удалённую цель `use`, он показывает разрешённый список импортов и требует, чтобы оператор для этого запуска ответил в точности `approve remote prose imports`.

## Возможности

* Многоагентное исследование и обобщение с явно заданным параллелизмом.
* Воспроизводимые рабочие процессы с безопасным подтверждением действий (проверка кода, разбор инцидентов, конвейеры обработки содержимого).
* Многократно используемые программы `.prose`, которые можно запускать в поддерживаемых средах выполнения агентов.

## Пример: параллельное исследование и обобщение

```prose theme={"theme":{"light":"min-light","dark":"min-dark"}}
# Исследование и обобщение с двумя агентами, работающими параллельно.

input topic: "Что нам следует исследовать?"

agent researcher:
  model: sonnet
  prompt: "Вы проводите тщательное исследование и указываете источники."

agent writer:
  model: opus
  prompt: "Вы пишете краткое резюме."

parallel:
  findings = session: researcher
    prompt: "Исследуйте {topic}."
  draft = session: writer
    prompt: "Кратко изложите {topic}."

session "Объедините результаты исследования и черновик в окончательный ответ."
  context: { findings, draft }
```

## Сопоставление со средой выполнения OpenClaw

Программы OpenProse сопоставляются с примитивами OpenClaw:

| Концепция OpenProse | Инструмент OpenClaw |
| - | - |
| Запуск сеанса / инструмент Task | `sessions_spawn` |
| Чтение / запись файла | `read` / `write` |
| Веб-запрос | `web_fetch` (`exec` + curl, когда требуется POST) |

> [!WARNING]
>
> Если ваш список разрешённых инструментов блокирует `sessions_spawn`, `read`, `write` или `web_fetch`, программы OpenProse завершатся с ошибкой. Проверьте
> [конфигурацию списка разрешённых инструментов](https://docs2.openclaw.ai/ru/gateway/config-tools.md).

## Расположение файлов

OpenProse хранит состояние в `.prose/` вашей рабочей области:

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
.prose/
├── .env                      # конфигурация (ключ=значение), например OPENPROSE_POSTGRES_URL
├── runs/
│   └── {YYYYMMDD}-{HHMMSS}-{random}/
│       ├── program.prose     # копия выполняемой программы
│       ├── state.md          # состояние выполнения
│       ├── bindings/
│       ├── imports/          # вложенные запуски удалённых программ
│       └── agents/
└── agents/                   # постоянные агенты в области проекта
```

Постоянные агенты пользовательского уровня, общие для разных проектов, находятся по адресу:

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
~/.prose/agents/
```

## Бэкенды состояния

> [accordion] filesystem (по умолчанию)
>
> Состояние записывается в `.prose/runs/...` рабочей области. Дополнительные зависимости не требуются.

> [accordion] in-context
>
> Временное состояние хранится в окне контекста; выберите этот бэкенд с помощью `--in-context`.
> Подходит для небольших краткоживущих программ.

> [accordion] sqlite (экспериментальный)
>
> Выберите с помощью `--state=sqlite`. Требуется исполняемый файл `sqlite3` в `PATH`
> (если он отсутствует, используется filesystem); состояние сохраняется в
> `.prose/runs/{id}/state.db`.

> [accordion] postgres (экспериментальный)
>
> Выберите с помощью `--state=postgres`. Требуются `psql` и строка подключения в
> `OPENPROSE_POSTGRES_URL` (задайте её в `.prose/.env`).
>
> > [!WARNING]
> >
> > Учётные данные Postgres попадают в журналы субагентов. Используйте отдельную базу данных с минимальными привилегиями.

## Безопасность

Рассматривайте файлы `.prose` как код. Проверяйте их перед запуском, включая удалённые импорты `use`. Запросы `/prose run https://...` верхнего уровня задаются явно, но для транзитивных удалённых импортов перед их загрузкой или выполнением требуется подтверждение при каждом запуске. Используйте списки разрешённых инструментов OpenClaw и этапы подтверждения для управления побочными эффектами. Для детерминированных рабочих процессов с подтверждением действий сравните с
[Lobster](https://docs2.openclaw.ai/ru/tools/lobster.md).

## Связанные материалы

> [card] [Справочник по Skills](https://docs2.openclaw.ai/ru/tools/skills.md)
>
> Как загружается пакет Skills OpenProse и какие ограничения применяются.

> [card] [Субагенты](https://docs2.openclaw.ai/ru/tools/subagents.md)
>
> Встроенный уровень многоагентной координации OpenClaw.

> [card] [Преобразование текста в речь](https://docs2.openclaw.ai/ru/tools/tts.md)
>
> Добавьте аудиовывод в свои рабочие процессы.

> [card] [Слеш-команды](https://docs2.openclaw.ai/ru/tools/slash-commands.md)
>
> Все доступные команды чата, включая /prose.

Официальный сайт: [https://www.prose.md](https://www.prose.md)