> ## 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.

# Przepływ pracy środowiska uruchomieniowego agenta OpenClaw

Przepływ pracy deweloperskiej dla środowiska uruchomieniowego agenta (`src/agents/`) w repozytorium OpenClaw.

## Sprawdzanie typów i lintowanie

* Domyślna lokalna bramka: `pnpm check` (sprawdzanie typów, lintowanie, zabezpieczenia zasad)
* Bramka kompilacji: `pnpm build`, gdy zmiana może wpłynąć na wynik kompilacji, pakowanie albo granice leniwego ładowania/modułów
* Pełna bramka przed wysłaniem zmian: `pnpm build && pnpm check && pnpm check:test-types && pnpm test`

## Uruchamianie testów środowiska uruchomieniowego agenta

Uruchom zestawy testów jednostkowych środowiska uruchomieniowego agenta:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
pnpm test \
  "src/agents/agent-*.test.ts" \
  "src/agents/embedded-agent-*.test.ts" \
  "src/agents/agent-hooks/**/*.test.ts"
```

Pierwszy wzorzec glob obejmuje również zestawy `agent-tools*`, `agent-settings` i
`agent-tool-definition-adapter*`.

Testy na żywo są wykluczone z konfiguracji testów jednostkowych; uruchamiaj je za pomocą
wrappera testów na żywo (ustawia `OPENCLAW_LIVE_TEST=1` i wymaga danych uwierzytelniających dostawcy):

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
pnpm test:live src/agents/embedded-agent-runner-extraparams.live.test.ts
```

## Testowanie ręczne

* Uruchom Gateway w trybie deweloperskim (pomija połączenia z kanałami za pomocą `OPENCLAW_SKIP_CHANNELS=1`): `pnpm gateway:dev`
* Wyzwól jedną turę agenta przez Gateway: `pnpm openclaw agent --message "Hello" --thinking low`
* Użyj TUI do interaktywnego debugowania: `pnpm tui`

Aby przetestować zachowanie wywołań narzędzi, poproś o działanie `read` lub `exec`, aby obserwować
strumieniowanie narzędzi i obsługę ładunku.

## Reset do stanu początkowego

Stan znajduje się w katalogu stanu OpenClaw: domyślnie `~/.openclaw` lub
`$OPENCLAW_STATE_DIR`, jeśli ustawiono. Ścieżki względem tego katalogu:

| Ścieżka                                        | Zawartość                                                                                                             |
| ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| `openclaw.json`                                | Konfiguracja                                                                                                          |
| `state/openclaw.sqlite`                        | Współdzielona baza danych stanu środowiska uruchomieniowego                                                           |
| `agents/<agentId>/agent/openclaw-agent.sqlite` | Profile uwierzytelniania modelu dla poszczególnych agentów (klucze API + OAuth) oraz stan środowiska uruchomieniowego |
| `credentials/`                                 | Dane uwierzytelniające dostawców/kanałów poza magazynem profili uwierzytelniania                                      |
| `agents/<agentId>/sessions/`                   | Historia transkrypcji i źródła migracji starszych sesji                                                               |
| `sessions/`                                    | Starszy magazyn sesji pojedynczego agenta (tylko stare instalacje)                                                    |
| `workspace/`                                   | Domyślny obszar roboczy agenta (dodatkowi agenci używają `workspace-<agentId>`)                                       |

Usuń te ścieżki, aby wykonać pełny reset. Resetowanie w węższym zakresie:

* Tylko sesje: nie usuwaj `agents/<agentId>/agent/openclaw-agent.sqlite`; wiersze sesji znajdują się tam wraz z innym stanem poszczególnych agentów. Użyj `/new` lub `/reset`, aby rozpocząć nową sesję dla jednego czatu, oraz `openclaw sessions cleanup` do konserwacji sesji.
* Zachowaj uwierzytelnianie: pozostaw `agents/<agentId>/agent/openclaw-agent.sqlite` i `credentials/` bez zmian.

Starsze pliki `auth-profiles.json` nie są już odczytywane w czasie działania;
`openclaw doctor --fix` importuje je do magazynu SQLite.

## Materiały referencyjne

* [Testowanie](/pl/help/testing)
* [Pierwsze kroki](/pl/start/getting-started)

## Powiązane

* [Architektura środowiska uruchomieniowego agenta OpenClaw](/pl/agent-runtime-architecture)