Перейти до основного вмісту
Раціональний робочий процес для роботи над середовищем виконання агента OpenClaw в OpenClaw.

​
Перевірка типів і лінтинг

  • Типовий локальний контроль: pnpm check
  • Контроль збірки: pnpm build, коли зміна може вплинути на результат збірки, пакування або межі lazy-loading/модулів
  • Повний контроль перед злиттям для змін середовища виконання агента: pnpm check && pnpm test

​
Запуск тестів середовища виконання агента

Запустіть набір тестів середовища виконання агента напряму через Vitest: 
pnpm test \
  "src/agents/agent-*.test.ts" \
  "src/agents/embedded-agent-*.test.ts" \
  "src/agents/agent-tools*.test.ts" \
  "src/agents/agent-settings.test.ts" \
  "src/agents/agent-tool-definition-adapter*.test.ts" \
  "src/agents/agent-hooks/**/*.test.ts"
Щоб включити перевірку з live-провайдером: 
OPENCLAW_LIVE_TEST=1 pnpm test src/agents/embedded-agent-runner-extraparams.live.test.ts
Це покриває основні модульні набори тестів середовища виконання агента:
  • src/agents/agent-*.test.ts
  • src/agents/embedded-agent-*.test.ts
  • src/agents/agent-tools*.test.ts
  • src/agents/agent-settings.test.ts
  • src/agents/agent-tool-definition-adapter.test.ts
  • src/agents/agent-hooks/*.test.ts

​
Ручне тестування

Рекомендований потік:
  • Запустіть Gateway у режимі розробки:
    • pnpm gateway:dev
  • Запустіть агента напряму:
    • pnpm openclaw agent --message "Hello" --thinking low
  • Використовуйте TUI для інтерактивного налагодження:
    • pnpm tui
Для поведінки викликів інструментів попросіть дію read або exec, щоб побачити потокове передавання даних інструмента й обробку payload.

​
Скидання до чистого стану

Стан зберігається в каталозі стану OpenClaw. Типове значення — ~/.openclaw. Якщо встановлено OPENCLAW_STATE_DIR, натомість використовуйте цей каталог. Щоб скинути все:
  • openclaw.json для конфігурації
  • agents/<agentId>/agent/auth-profiles.json для профілів автентифікації моделей (ключі API + OAuth)
  • credentials/ для стану провайдера/каналу, який досі зберігається поза сховищем профілів автентифікації
  • agents/<agentId>/sessions/ для історії сесій агента
  • agents/<agentId>/sessions/sessions.json для індексу сесій
  • sessions/, якщо існують застарілі шляхи
  • workspace/, якщо потрібен порожній робочий простір
Якщо потрібно скинути лише сесії, видаліть agents/<agentId>/sessions/ для цього агента. Якщо потрібно зберегти автентифікацію, залиште agents/<agentId>/agent/auth-profiles.json і будь-який стан провайдера в credentials/ на місці.

​
Довідкові матеріали

​
Пов’язане