From c004d96785047b333536edba1b3c1bf5813238e0 Mon Sep 17 00:00:00 2001
From: Mikhail Putilovskij <mputilovskij@gmail.com>
Date: Wed, 8 Apr 2026 02:57:45 +0300
Subject: [PATCH] docs: add exact run commands for matrix prototype

---
 docs/matrix-direct-agent-prototype-ru.md | 42 ++++++++++++++++++++++++
 1 file changed, 42 insertions(+)

diff --git a/docs/matrix-direct-agent-prototype-ru.md b/docs/matrix-direct-agent-prototype-ru.md
index 284c4b7..6729520 100644
--- a/docs/matrix-direct-agent-prototype-ru.md
+++ b/docs/matrix-direct-agent-prototype-ru.md
@@ -168,6 +168,48 @@ PYTHONPATH=. uv run python -m adapter.matrix.bot
 Matrix bot starting ...
 ```
 
+## Точные команды
+
+Ниже команды в том виде, в котором реально поднимался рабочий прототип.
+
+### Platform / agent backend
+
+```bash
+cd /Users/a/MAI/sem2/lambda/surfaces-bot/external/platform-agent
+deactivate 2>/dev/null || true
+uv sync
+uv pip install --python .venv/bin/python -e ../platform-agent_api
+
+export PROVIDER_URL=https://openrouter.ai/api/v1
+export PROVIDER_API_KEY='YOUR_OPENROUTER_KEY'
+export PROVIDER_MODEL='qwen/qwen3.5-122b-a10b'
+
+uv run uvicorn src.main:app --host 0.0.0.0 --port 8000
+```
+
+### Matrix bot
+
+```bash
+cd /Users/a/MAI/sem2/lambda/surfaces-bot
+
+export MATRIX_PLATFORM_BACKEND=real
+export AGENT_WS_URL=ws://127.0.0.1:8000/agent_ws/
+export MATRIX_HOMESERVER=https://matrix.lambda.coredump.ru
+export MATRIX_USER_ID=@lambda_surface_test_bot:matrix.lambda.coredump.ru
+export MATRIX_PASSWORD='YOUR_PASSWORD'
+
+PYTHONPATH=. uv run python -m adapter.matrix.bot
+```
+
+### Перезапуск Matrix state с нуля
+
+```bash
+cd /Users/a/MAI/sem2/lambda/surfaces-bot
+rm -f lambda_matrix.db
+rm -rf matrix_store
+PYTHONPATH=. uv run python -m adapter.matrix.bot
+```
+
 ## Smoke test
 
 Рекомендуемый сценарий ручной проверки: