OpenClaw agent runtime workflow

기준일: 2026-07-26
공식 기준: OpenClaw agent runtime workflow

OpenClaw agent runtime workflow 문서는 OpenClaw 공식 문서(openclaw-agent-runtime)를 한국어로 정리한 가이드입니다. Developer workflow for OpenClaw agent runtime: build, test, and live validation 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

Developer workflow for OpenClaw agent runtime: build, test, and live validation

한국어 가이드 범위: openclaw-agent-runtime 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

• Type checking and linting
• Running Agent Runtime Tests
• Manual testing
• Clean slate reset
• References
• 관련 문서

상세 내용

본문

Developer workflow for the agent runtime (src/agents/) in the OpenClaw repo.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Type checking and linting

주요 항목:

• Default local gate: pnpm check (typecheck, lint, policy guards)
• Build gate: pnpm build when the change can affect build output, packaging, or lazy-loading/module boundaries
• Full pre-push gate: pnpm build && pnpm check && pnpm check:test-types && pnpm test

Running Agent Runtime Tests

The first glob also covers the agent-tools*, agent-settings, and agent-tool-definition-adapter* suites.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

pnpm test \
  "src/agents/agent-*.test.ts" \
  "src/agents/embedded-agent-*.test.ts" \
  "src/agents/agent-hooks/**/*.test.ts"

pnpm test:live src/agents/embedded-agent-runner-extraparams.live.test.ts

Manual testing

For tool call behavior, prompt for a read or exec action so you can watch tool streaming and payload handling.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• Run the Gateway in dev mode (skips channel connections via OPENCLAW_SKIP_CHANNELS=1): pnpm gateway:dev
• Trigger one agent turn through the Gateway: pnpm openclaw agent --message "Hello" --thinking low
• Use the TUI for interactive debugging: pnpm tui

Clean slate reset

State lives in the OpenClaw state directory: ~/.openclaw by default, or $OPENCLAW_STATE_DIR when set. Paths relative to that directory:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• Sessions only: do not delete agents/<agentId>/agent/openclaw-agent.sqlite; session rows live there alongside other per-agent state. Use /new or /reset to start a fresh session for one chat, and openclaw sessions cleanup for session maintenance.
• Keep auth: leave agents/<agentId>/agent/openclaw-agent.sqlite and credentials/ in place.

Path	Holds
openclaw.json	Config
state/openclaw.sqlite	Shared runtime state database
agents/<agentId>/agent/openclaw-agent.sqlite	Per-agent model auth profiles (API keys + OAuth) and runtime state
credentials/	Provider/channel credentials outside the auth profile store
agents/<agentId>/sessions/	Transcript history and legacy session migration sources
sessions/	Legacy single-agent session store (old installs only)
workspace/	Default agent workspace (extra agents use workspace-<agentId>)

References

주요 항목:

• Testing
• Getting Started

관련 문서

주요 항목:

• OpenClaw agent runtime architecture

실습 체크리스트

1. 공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/openclaw-agent-runtime
2. 관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
3. 설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
4. Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

pnpm test \
  "src/agents/agent-*.test.ts" \
  "src/agents/embedded-agent-*.test.ts" \
  "src/agents/agent-hooks/**/*.test.ts"

pnpm test:live src/agents/embedded-agent-runner-extraparams.live.test.ts

관련 링크

• 공식 원문: openclaw-agent-runtime
• OpenClaw 문서 홈

이 가이드는 공식 문서를 한국어 학습용으로 재구성한 것입니다. 옵션 기본값·플래그 이름은 설치 버전에 따라 달라질 수 있습니다.