src/agents/)을 위한 개발자 워크플로입니다.
타입 검사 및 린팅
- 기본 로컬 게이트:
pnpm check(타입 검사, 린팅, 정책 가드) - 빌드 게이트: 변경 사항이 빌드 출력, 패키징 또는 지연 로딩/모듈 경계에 영향을 줄 수 있는 경우
pnpm build - 전체 푸시 전 게이트:
pnpm build && pnpm check && pnpm check:test-types && pnpm test
에이전트 런타임 테스트 실행
에이전트 런타임 단위 테스트 스위트를 실행합니다.agent-tools*, agent-settings,
agent-tool-definition-adapter* 스위트도 포함됩니다.
라이브 테스트는 단위 테스트 구성에서 제외됩니다. 라이브
래퍼를 통해 실행하십시오(OPENCLAW_LIVE_TEST=1을 설정하며 공급자 자격 증명이 필요합니다).
수동 테스트
- 개발 모드에서 Gateway를 실행합니다(
OPENCLAW_SKIP_CHANNELS=1을 통해 채널 연결을 건너뜁니다):pnpm gateway:dev - Gateway를 통해 에이전트 턴 하나를 트리거합니다:
pnpm openclaw agent --message "Hello" --thinking low - 대화형 디버깅에는 TUI를 사용합니다:
pnpm tui
read 또는 exec 작업을 요청하는 프롬프트를 입력하십시오.
초기 상태로 재설정
상태는 기본적으로 OpenClaw 상태 디렉터리인~/.openclaw에 저장되며,
$OPENCLAW_STATE_DIR이 설정된 경우 해당 디렉터리에 저장됩니다. 다음 경로는 해당 디렉터리를 기준으로 합니다.
완전히 재설정하려면 해당 경로를 삭제하십시오. 범위를 좁혀 재설정하려면 다음과 같이 하십시오.
- 세션만:
agents/<agentId>/agent/openclaw-agent.sqlite를 삭제하지 마십시오. 세션 행은 에이전트별 다른 상태와 함께 여기에 저장됩니다. 한 채팅에서 새 세션을 시작하려면/new또는/reset을 사용하고, 세션 유지 관리에는openclaw sessions cleanup을 사용하십시오. - 인증 유지:
agents/<agentId>/agent/openclaw-agent.sqlite와credentials/를 그대로 두십시오.
auth-profiles.json 파일은 더 이상 런타임에서 읽지 않습니다.
openclaw doctor --fix는 해당 파일을 SQLite 저장소로 가져옵니다.