OpenClaw Pi 개발 워크플로우: 테스트 및 디버깅 가이드

새로운 기능을 통합할 때마다 어디서부터 손을 대야 할지 막막할 때가 있죠. 특히 Pi 통합 같은 작업은 테스트와 검증 과정이 꼼꼼해야 나중에 고생하지 않아요. OpenClaw에서 Pi 통합 작업을 할 때 제가 직접 사용하고 추천하는 깔끔한 워크플로우를 정리해 드릴게요.

Pi 개발 워크플로우

이 가이드는 OpenClaw에서 Pi 통합 작업을 진행할 때 사용하기 좋은 워크플로우를 요약한 것입니다.

타입 체크 및 린팅

코드 품질을 유지하는 가장 기본은 역시 린팅과 타입 체크예요.

• 타입 체크 및 빌드: pnpm build
• 린트: pnpm lint
• 포맷 체크: pnpm format
• 푸시 전 전체 검사: pnpm lint && pnpm build && pnpm test

Pi 테스트 실행하기

Pi에 집중된 테스트 세트를 Vitest로 직접 실행해 보세요.

pnpm test -- \
  "src/agents/pi-*.test.ts" \
  "src/agents/pi-embedded-*.test.ts" \
  "src/agents/pi-tools*.test.ts" \
  "src/agents/pi-settings.test.ts" \
  "src/agents/pi-tool-definition-adapter*.test.ts" \
  "src/agents/pi-hooks/**/*.test.ts"

라이브 프로바이더 테스트를 포함하려면 이 명령어를 사용하세요:

OPENCLAW_LIVE_TEST=1 pnpm test -- src/agents/pi-embedded-runner-extraparams.live.test.ts

이 명령어는 다음과 같은 주요 Pi 유닛 스위트를 모두 커버해요:

• src/agents/pi-*.test.ts
• src/agents/pi-embedded-*.test.ts
• src/agents/pi-tools*.test.ts
• src/agents/pi-settings.test.ts
• src/agents/pi-tool-definition-adapter.test.ts
• src/agents/pi-hooks/*.test.ts

수동 테스트

직접 확인해보고 싶을 때는 이 흐름을 추천해요:

• Gateway를 dev 모드로 실행:
  • pnpm gateway:dev
• Agent를 직접 트리거:
  • pnpm openclaw agent --message "Hello" --thinking low
• 대화형 디버깅을 위해 TUI 사용:
  • pnpm tui

Tool call 동작을 확인하려면 read나 exec 액션을 유도해 보세요. Tool 스트리밍과 페이로드 처리가 어떻게 이루어지는지 직접 확인할 수 있어요.

초기화 및 리셋

상태 데이터는 OpenClaw 상태 디렉토리에 저장돼요. 기본값은 ~/.openclaw이며, OPENCLAW_STATE_DIR 환경 변수가 설정되어 있다면 해당 디렉토리를 사용하세요.

모든 것을 리셋하려면 다음 항목들을 확인하세요:

• openclaw.json: 설정 파일
• credentials/: 인증 프로필 및 토큰
• agents/<agentId>/sessions/: 에이전트 세션 히스토리
• agents/<agentId>/sessions.json: 세션 인덱스
• sessions/: 레거시 경로가 존재하는 경우
• workspace/: 완전히 비어있는 워크스페이스를 원하는 경우

세션만 리셋하고 싶다면 해당 에이전트의 agents/<agentId>/sessions/와 agents/<agentId>/sessions.json 파일만 삭제하면 돼요. 다시 인증하는 번거로움을 피하려면 credentials/ 디렉토리는 남겨두는 것이 좋아요.

참고 자료

• Testing
• Getting Started

다음 단계

• 에이전트 구성 가이드
• 환경 변수 설정

AI Setup Assistant