데이터베이스 우선 상태 리팩터링

결정

2단계 SQLite 구성을 사용합니다.

• 전역 데이터베이스: ~/.openclaw/state/openclaw.sqlite
• 에이전트 데이터베이스: 에이전트가 소유하는 워크스페이스, 트랜스크립트, VFS, 아티팩트 및 에이전트별 대규모 런타임 상태를 위한 에이전트당 하나의 SQLite 데이터베이스
• 구성은 계속 파일 기반으로 유지합니다. openclaw.json은 데이터베이스 외부에 유지합니다. 런타임 인증 프로필은 SQLite로 이동하며, 외부 공급자 또는 CLI 자격 증명 파일은 OpenClaw 데이터베이스 외부에서 해당 소유자가 계속 관리합니다.

전역 데이터베이스는 제어 평면 데이터베이스입니다. 에이전트 검색, 공유 Gateway 상태, 페어링, 기기/Node 상태, 작업 및 플로 원장, Plugin 상태, 스케줄러 런타임 상태, 백업 메타데이터 및 마이그레이션 상태를 소유합니다.

에이전트 데이터베이스는 데이터 평면 데이터베이스입니다. 에이전트의 세션 메타데이터, 트랜스크립트 이벤트 스트림, VFS 워크스페이스 또는 스크래치 네임스페이스, 도구 아티팩트, 실행 아티팩트 및 검색과 인덱싱이 가능한 에이전트 로컬 캐시 데이터를 소유합니다.

이 구성을 사용하면 대규모 에이전트 워크스페이스, 트랜스크립트 및 바이너리 스크래치 데이터를 공유 Gateway 쓰기 경로에 강제로 넣지 않고도 하나의 영구적인 전역 뷰를 확보할 수 있습니다.

엄격한 계약

이 마이그레이션에는 하나의 표준 런타임 형태만 있습니다.

• 세션 행에는 세션 메타데이터만 저장합니다. transcriptLocator, 트랜스크립트 파일 경로, 관련 JSONL 경로, 잠금 경로, 정리 메타데이터 또는 파일 시대 호환성 포인터를 저장해서는 안 됩니다.
• 트랜스크립트 식별자는 항상 SQLite 식별자입니다. 즉, {agentId, sessionId}와 프로토콜에서 필요한 경우 선택적 주제 메타데이터를 사용합니다.
• sqlite-transcript://...는 런타임 또는 프로토콜 식별자가 아닙니다. 새 코드는 트랜스크립트 로케이터를 파생, 저장, 전달, 구문 분석 또는 마이그레이션해서는 안 됩니다. 런타임과 테스트에는 의사 로케이터가 전혀 포함되어서는 안 되며, 문서에서는 이를 금지하기 위해서만 해당 문자열을 언급할 수 있습니다.
• 레거시 sessions.json, 트랜스크립트 JSONL, .jsonl.lock, 정리, 잘라내기 및 이전 세션 경로 로직은 doctor 마이그레이션/가져오기 경로에만 속합니다.
• 레거시 세션 구성 별칭은 doctor 마이그레이션에만 속합니다. 런타임은 session.idleMinutes, session.resetByType.dm 또는 구성된 다른 에이전트에 대한 교차 에이전트 agent:main:* 기본 세션 별칭을 해석하지 않습니다.
• 세션 라우팅 식별자는 형식화된 관계형 상태입니다. 빈번하게 실행되는 런타임 및 UI 경로는 sessions.session_scope, sessions.account_id, sessions.primary_conversation_id, conversations 및 session_conversations를 읽어야 합니다. 이전 호출 지점을 삭제하는 동안 호환성 섀도로 사용하는 경우를 제외하고, 공급자 식별자를 얻기 위해 session_key를 구문 분석하거나 session_entries.entry_json을 탐색해서는 안 됩니다.
• dm과 direct 같은 채널 수준의 다이렉트 메시지 표시는 라우팅 용어이며, 트랜스크립트 로케이터나 파일 저장소 호환성 핸들이 아닙니다.
• 레거시 훅 핸들러 구성은 doctor 경고/마이그레이션 표면에만 속합니다. 런타임은 hooks.internal.handlers를 로드해서는 안 됩니다. 훅은 검색된 훅 디렉터리와 HOOK.md 메타데이터를 통해서만 실행됩니다.
• 런타임 시작, 빈번하게 실행되는 응답 경로, Compaction, 재설정, 복구, 진단, TTS, 메모리 훅, 하위 에이전트, Plugin 명령 라우팅, 프로토콜 경계 및 훅은 런타임 전체에서 {agentId, sessionId}를 전달해야 합니다.
• 테스트는 {agentId, sessionId}를 통해 SQLite 트랜스크립트 행을 시드하고 검증해야 합니다. JSONL 경로 전달, 호출자가 제공한 로케이터 보존 또는 트랜스크립트 파일 호환성만 입증하는 테스트는 doctor 가져오기, 비세션 지원/디버그 구체화 또는 프로토콜 형태를 다루지 않는 한 삭제해야 합니다.
• runEmbeddedPiAgent(...), 준비된 워커 실행 및 내부 임베디드 시도는 트랜스크립트 로케이터를 허용해서는 안 됩니다. {agentId, sessionId}를 사용하여 SQLite 트랜스크립트 관리자를 열고 해당 관리자를 내부화된 PI 호환 에이전트 세션에 전달해야 합니다. 그러면 오래된 호출자가 러너에 JSON/JSONL 트랜스크립트를 쓰도록 만들 수 없습니다.
• 러너 진단은 런타임/캐시/페이로드 추적 레코드를 SQLite에 저장해야 합니다. 런타임 진단은 JSONL 파일 재정의 옵션이나 범용 트랜스크립트 JSONL 내보내기 도우미를 노출해서는 안 됩니다. 사용자 대상 내보내기는 파일 이름을 런타임에 다시 전달하지 않고 데이터베이스 행에서 명시적 아티팩트를 구체화할 수 있습니다.
• 원시 스트림 로깅은 OPENCLAW_RAW_STREAM=1과 SQLite 진단 행을 사용합니다. 이전 pi-mono의 PI_RAW_STREAM, PI_RAW_STREAM_PATH 및 raw-openai-completions.jsonl 파일 로거 계약은 OpenClaw 런타임이나 테스트의 일부가 아닙니다.
• QMD 메모리 인덱싱은 SQLite 트랜스크립트를 마크다운 파일로 내보내서는 안 됩니다. QMD는 구성된 메모리 파일만 인덱싱하며, 세션 트랜스크립트 검색은 계속 SQLite 기반으로 유지합니다.
• 새 코드에서 QMD SDK 하위 경로는 QMD 전용입니다. SQLite 세션 트랜스크립트 인덱싱 도우미는 memory-core-host-engine-session-transcripts에 위치합니다. QMD 재내보내기는 호환성 목적으로만 존재하며 런타임 코드에서 사용해서는 안 됩니다.
• 기본 제공 메모리 인덱스는 이를 소유하는 에이전트 데이터베이스에 위치합니다. 런타임 구성 및 해석된 런타임 계약은 memorySearch.store.path를 노출해서는 안 됩니다. doctor는 해당 레거시 구성 키를 삭제하고 현재 코드는 에이전트 databasePath를 내부적으로 전달합니다.

doctor/가져오기/내보내기/디버그 경계 외부에 예외 없이 이 문장들이 참이 될 때까지 구현 작업에서 코드를 계속 삭제해야 합니다.

목표 상태 및 진행 상황

엄격한 목표

• 하나의 전역 SQLite 데이터베이스가 제어 평면 상태를 소유합니다. state/openclaw.sqlite.
• 에이전트별 하나의 SQLite 데이터베이스가 데이터 평면 상태를 소유합니다. agents/<agentId>/agent/openclaw-agent.sqlite.
• 구성은 계속 파일 기반으로 유지합니다. openclaw.json은 이 데이터베이스 리팩터링에 포함되지 않습니다.
• 레거시 파일은 doctor 마이그레이션 입력으로만 사용합니다.
• 런타임은 세션 또는 트랜스크립트 JSONL을 활성 상태로 쓰거나 읽지 않습니다.

목표 상태

• not-started: 파일 시대 런타임 코드가 여전히 활성 상태를 씁니다.
• migrating: doctor/가져오기 코드가 파일 데이터를 SQLite로 이동할 수 있습니다.
• dual-read: 임시 브리지가 SQLite와 레거시 파일을 모두 읽습니다. 이 리팩터링에서는 doctor 전용이라고 명시적으로 문서화하지 않는 한 이 상태를 금지합니다.
• sqlite-runtime: 런타임이 SQLite만 읽고 씁니다.
• clean: 레거시 런타임 API와 테스트가 제거되고 가드가 회귀를 방지합니다.
• done: 문서, 테스트, 백업, doctor 마이그레이션 및 변경 검사가 정리된 상태를 입증합니다.

현재 상태

• 세션: 런타임은 clean 상태입니다. 세션 행은 에이전트별 데이터베이스에 있으며 런타임 API는 {agentId, sessionId} 또는 {agentId, sessionKey}를 사용하고, sessions.json은 doctor 전용 레거시 입력입니다.
• 트랜스크립트: 런타임은 clean 상태입니다. 트랜스크립트 이벤트, 식별자, 스냅샷 및 궤적 런타임 이벤트는 에이전트별 데이터베이스에 있습니다. 런타임은 더 이상 트랜스크립트 로케이터나 JSONL 트랜스크립트 경로를 허용하지 않습니다.
• PI 임베디드 러너: clean 상태입니다. 임베디드 PI 실행, 준비된 워커, Compaction 및 재시도 루프는 SQLite 세션 범위를 사용하고 오래된 트랜스크립트 핸들을 거부합니다.
• Cron: 런타임은 clean 상태입니다. 런타임은 cron_jobs와 cron_run_logs를 사용합니다. 런타임 테스트는 SQLite storeKey 명명을 사용하며, 파일 시대 Cron 경로는 doctor 레거시 마이그레이션 테스트에만 남아 있습니다.
• 작업 레지스트리: clean 상태입니다. 작업 및 Task Flow 런타임 행은 state/openclaw.sqlite에 있으며, 출시되지 않은 사이드카 SQLite 가져오기 도구는 삭제되었습니다.
• Plugin 상태: clean 상태입니다. Plugin 상태/블롭 행은 공유 전역 데이터베이스에 있으며 이전 Plugin 상태 사이드카 SQLite 도우미의 사용은 가드로 방지됩니다.
• 메모리: 기본 제공 메모리와 세션 트랜스크립트 인덱싱은 sqlite-runtime 상태입니다. 메모리 인덱스 테이블은 에이전트별 데이터베이스에 있으며, Plugin 메모리 상태는 공유 Plugin 상태 행을 사용합니다. 레거시 메모리 파일은 doctor 마이그레이션 입력 또는 사용자 워크스페이스 콘텐츠입니다.
• 백업: sqlite-runtime 상태입니다. 백업 단계는 SQLite 스냅샷을 압축하고, 활성 WAL/SHM 사이드카를 제외하며, SQLite 무결성을 확인하고, 백업 실행을 전역 데이터베이스에 기록합니다.
• Doctor 마이그레이션: 의도적으로 migrating 상태입니다. Doctor는 레거시 JSON, JSONL 및 폐기된 사이드카 저장소를 SQLite로 가져오고, 마이그레이션 실행/소스를 기록하며, 성공적으로 처리한 소스를 제거합니다.
• E2E 스크립트: 런타임 적용 범위는 clean 상태입니다. Docker MCP 시드는 SQLite 행을 씁니다. 런타임 컨텍스트 Docker 스크립트는 doctor 마이그레이션 시드 내부에서만 레거시 JSONL을 생성하며 레거시 세션 인덱스 경로를 명시적으로 명명합니다.

남은 작업

• [x] doctor 레거시 입력이 아닌 경우 Cron 런타임 테스트 저장소 변수의 이름을 storePath가 아닌 이름으로 변경합니다. 파일: src/cron/service.test-harness.ts, src/cron/service.runs-one-shot-main-job-disables-it.test.ts, src/cron/service/timer.regression.test.ts, src/cron/service/ops.test.ts, src/cron/service/store.test.ts, src/cron/service.heartbeat-ok-summary-suppressed.test.ts, src/cron/service.main-job-passes-heartbeat-target-last.test.ts, src/cron/store.test.ts. 검증: pnpm check:database-first-legacy-stores; rg -n 'storePath' src/cron --glob '!**/commands/doctor/**'.
• [x] 사용되지 않는 파일 시대 내보내기 테스트 모의를 제거하거나 이름을 변경합니다. 파일: src/auto-reply/reply/commands-export-test-mocks.ts. 검증: rg -n 'resolveSessionFilePath|sessionFile|storePath|transcriptLocator' src/auto-reply/reply.
• [x] Docker 런타임 컨텍스트의 레거시 JSONL 시드가 명백히 doctor 전용임을 나타냅니다. 파일: scripts/e2e/session-runtime-context-docker-client.ts. 검증: rg -n 'sessions\\.json|sessionFile|\\.jsonl' scripts/e2e/session-runtime-context-docker-client.ts의 결과에는 seedBrokenLegacySessionForDoctorMigration만 표시됩니다.
• [x] 스키마가 변경된 후에도 Kysely 생성 형식을 일치시킵니다. 파일: src/state/openclaw-state-schema.sql, src/state/openclaw-agent-schema.sql, src/state/*generated*. 검증: 이번 작업에서는 스키마 변경이 없습니다. pnpm db:kysely:check; pnpm lint:kysely.
• [x] 수정한 저장소, 명령 및 스크립트에 대한 집중 테스트를 다시 실행합니다. 검증: pnpm test src/cron/service/store.test.ts src/cron/store.test.ts src/cron/service.heartbeat-ok-summary-suppressed.test.ts src/cron/service.main-job-passes-heartbeat-target-last.test.ts src/cron/service.every-jobs-fire.test.ts src/cron/service.persists-delivered-status.test.ts src/cron/service.runs-one-shot-main-job-disables-it.test.ts src/cron/service/ops.test.ts src/cron/service/timer.regression.test.ts src/auto-reply/reply/commands-export-trajectory.test.ts extensions/telegram/src/thread-bindings.test.ts extensions/slack/src/monitor/message-handler/prepare.test.ts src/acp/translator.session-lineage-meta.test.ts; git diff --check.
• [x] done을 선언하기 전에 변경 게이트 또는 원격 광범위 검증을 실행합니다. 검증: 임시 Node 24/pnpm 설정 및 동기화된 .git 없는 워크스페이스를 위한 명시적 경로 라우팅 후 Hetzner Crabbox 실행 run_3f1cabf6b25c에서 pnpm check:changed --timed -- <changed extension paths>가 통과했습니다.

회귀 금지

• 트랜스크립트 로케이터를 사용하지 않습니다.
• 활성 세션 파일을 사용하지 않습니다.
• doctor 레거시 마이그레이션 테스트를 제외하고 가짜 JSONL 테스트 픽스처를 사용하지 않습니다.
• Kysely 사용이 예상되는 곳에서 원시 SQLite 접근을 사용하지 않습니다.
• 새로운 파일 시대 DB 마이그레이션을 추가하지 않습니다. 전역 스키마 버전은 1로 유지합니다. 출시된 에이전트별 버전 1 스키마에는 안정적인 메모리 소스 식별자를 위한 버전 2로의 제한적인 런타임 마이그레이션이 하나 있습니다.

코드 검토 가정

이 계획을 가로막는 후속 제품 결정은 없습니다. 구현은 다음 가정에 따라 진행해야 합니다.

• 이 저장 경로에는 node:sqlite를 직접 사용하고 Node 22+ 런타임을 요구합니다.
• 일반 구성 파일은 정확히 하나만 유지합니다. 이 리팩터링에서 구성, Plugin 매니페스트 또는 Git 작업 공간을 SQLite로 이동하지 마십시오.
• 런타임 호환성 파일은 필요하지 않습니다. 레거시 JSON 및 JSONL 파일은 마이그레이션 입력으로만 사용합니다. 브랜치 로컬 SQLite 사이드카는 출시된 적이 없으므로 가져오지 않고 삭제합니다.
• 레거시 파일에서 데이터베이스로의 마이그레이션은 openclaw doctor --fix가 담당합니다. 런타임 시작은 출시된 SQLite 스키마 버전 간의 제한된 업그레이드만 담당하며, 파일 기반 시대의 상태를 가져와서는 안 됩니다.
• 자격 증명 호환성에도 동일한 규칙을 적용합니다. 런타임 자격 증명은 SQLite에 저장합니다. 이전 auth-profiles.json, 에이전트별 auth.json, 공유 credentials/oauth.json 파일은 doctor 마이그레이션 입력으로 사용한 후, 가져오기가 완료되면 제거합니다.
• 생성된 모델 카탈로그 상태는 데이터베이스에 저장합니다. 런타임 코드는 agents/<agentId>/agent/models.json에 쓰면 안 됩니다. 기존 models.json 파일은 레거시 doctor 입력이며 agent_model_catalogs로 가져온 후 제거합니다.
• 런타임은 트랜스크립트 로케이터를 마이그레이션하거나 정규화하거나 연결해서는 안 됩니다. 활성 트랜스크립트 식별자는 SQLite의 {agentId, sessionId}입니다. 파일 경로는 레거시 doctor 입력으로만 사용하며, sqlite-transcript://...는 경계 핸들로 취급하지 말고 런타임, 프로토콜, 훅 및 Plugin 표면에서 제거해야 합니다.
• 런타임의 SQLite 트랜스크립트 읽기는 이전 JSONL 항목 형식 마이그레이션을 실행하거나 호환성을 위해 전체 트랜스크립트를 다시 쓰지 않습니다. 레거시 항목 정규화는 명시적인 doctor/가져오기 유틸리티에만 둡니다. doctor는 레거시 JSONL 트랜스크립트 파일을 정규화한 후 SQLite 행을 삽입합니다. 현재 런타임 행은 이미 현재 트랜스크립트 스키마로 작성됩니다. 궤적/세션 내보내기는 해당 행을 그대로 읽어야 하며 내보내기 시점에 레거시 마이그레이션을 수행해서는 안 됩니다.
• 레거시 트랜스크립트 JSONL 구문 분석/마이그레이션 도우미는 doctor에서만 사용합니다. 런타임 트랜스크립트 형식 코드는 현재 SQLite 트랜스크립트 컨텍스트만 구성하며, 이전 JSONL 항목을 업그레이드한 후 행을 삽입하는 작업은 doctor가 담당합니다.
• 런타임이 담당하던 이전 JSONL 트랜스크립트 스트리밍 도우미는 삭제했습니다. doctor 가져오기 코드가 명시적인 레거시 파일 읽기를 담당하며, 런타임 세션 기록은 SQLite 행을 읽습니다.
• Codex 앱 서버 바인딩은 Codex Plugin 상태 네임스페이스에서 OpenClaw sessionId를 정규 키로 사용합니다. sessionKey는 라우팅/표시용 메타데이터이며, 영구 세션 ID를 대체하거나 트랜스크립트 파일 식별자를 되살려서는 안 됩니다.
• 컨텍스트 엔진은 현재 런타임 계약을 직접 받습니다. 레지스트리는 sessionKey, transcriptScope 또는 prompt를 삭제하는 재시도 심으로 엔진을 래핑해서는 안 됩니다. 현재의 데이터베이스 우선 매개변수를 받을 수 없는 엔진은 연결 계층으로 보완하지 말고 명확하게 실패해야 합니다.
• 백업 출력은 하나의 아카이브 파일로 유지해야 합니다. 데이터베이스 콘텐츠는 원시 라이브 WAL 사이드카가 아니라 압축된 SQLite 스냅샷으로 해당 아카이브에 포함되어야 합니다.
• 트랜스크립트 검색은 유용하지만 첫 번째 데이터베이스 우선 전환에는 필수가 아닙니다. 나중에 FTS를 추가할 수 있도록 스키마를 설계합니다.
• 데이터베이스 경계가 안정될 때까지 워커 실행은 설정 뒤에서 실험적 기능으로 유지해야 합니다.

코드 검토 결과

현재 브랜치는 이미 개념 증명 단계를 넘어섰습니다. 공유 데이터베이스가 존재하고, Node node:sqlite가 작은 런타임 도우미를 통해 연결되어 있으며, 이전 저장소는 이제 state/openclaw.sqlite 또는 해당 소유자의 openclaw-agent.sqlite 데이터베이스에 씁니다.

남은 작업은 SQLite를 선택하는 것이 아니라, 새로운 경계를 깔끔하게 유지하고 여전히 이전 파일 기반 환경처럼 보이는 호환성 형태의 인터페이스를 모두 삭제하는 것입니다.

• 세션 storePath는 더 이상 런타임 식별자, 테스트 픽스처 형식 또는 상태 페이로드 필드가 아닙니다. 런타임 및 브리지 테스트에는 더 이상 storePath 계약 이름이 없으며, 해당 레거시 용어는 doctor/마이그레이션 코드가 담당합니다.
• 세션 쓰기는 더 이상 이전 프로세스 내 store-writer.ts 큐를 거치지 않습니다. SQLite 패치 쓰기는 트랜잭션 외부에서 준비한 후, 명시적 충돌 감지를 포함하는 짧은 동기식 검증/적용 트랜잭션을 사용합니다.
• 레거시 경로 탐색은 여전히 유효한 마이그레이션 용도가 있지만, 런타임 코드는 sessions.json과 트랜스크립트 JSONL 파일을 가능한 쓰기 대상으로 취급하지 않아야 합니다.
• 에이전트 소유 테이블은 에이전트별 SQLite 데이터베이스에 있습니다. 전역 DB는 레지스트리/제어 영역 행을 유지하며, 트랜스크립트 식별자는 에이전트별 트랜스크립트 행의 {agentId, sessionId}입니다. 런타임 코드는 트랜스크립트 파일 경로를 영속화하거나 트랜스크립트 로케이터를 마이그레이션해서는 안 됩니다.
• doctor는 이미 여러 레거시 파일을 가져옵니다. 정리 작업의 목표는 이를 doctor가 호출하는 하나의 명시적인 마이그레이션 구현으로 만들고 영구적인 마이그레이션 보고서를 제공하는 것입니다.

구현을 가로막는 추가 제품 관련 질문은 없습니다.

현재 코드 구조

이 브랜치에는 이미 실제 공유 SQLite 기반이 있습니다:

• 이제 최소 런타임 요구 사항은 Node 22+입니다. package.json, CLI 런타임 가드, 설치 프로그램 기본값, macOS 런타임 로케이터, CI 및 공개 설치 문서가 모두 일치합니다. 기존 Node 22 호환성 레인은 제거되었습니다.
• src/state/openclaw-state-db.ts는 openclaw.sqlite를 열고 WAL, synchronous=NORMAL, busy_timeout=30000, foreign_keys=ON을 설정하며 src/state/openclaw-state-schema.sql에서 파생된 생성 스키마 모듈을 적용합니다.
• Kysely 테이블 타입과 런타임 스키마 모듈은 커밋된 .sql 파일로 만든 일회용 SQLite 데이터베이스에서 생성됩니다. 런타임 코드는 더 이상 전역, 에이전트별 또는 프록시 캡처 데이터베이스를 위해 복사하여 붙여 넣은 스키마 문자열을 유지하지 않습니다.
• 런타임 저장소는 SQLite 행 형태를 수동으로 별도 정의하는 대신 생성된 Kysely DB 인터페이스에서 선택 및 삽입 행 타입을 파생합니다. 원시 SQL은 스키마 적용, pragma 및 마이그레이션 전용 DDL로 계속 제한됩니다.
• 전역 SQLite 스키마는 user_version = 1로 유지됩니다. 에이전트별 스키마는 버전 2이며, 해당 오프너는 배포된 버전 1의 메모리 소스 키를 안정적인 정수 ID로 원자적으로 마이그레이션합니다. 파일에서 데이터베이스로의 가져오기는 계속 doctor 코드에서 수행됩니다.
• 소유권 경계가 정규 경계인 곳에서는 관계형 소유권을 강제합니다. 소스 마이그레이션 행은 migration_runs에서 연쇄 삭제되고, 작업 전송 상태는 task_runs에서 연쇄 삭제되며, 트랜스크립트 ID 행은 트랜스크립트 이벤트에서 연쇄 삭제됩니다.
• 현재 공유 테이블에는 agent_databases, auth_profile_stores, auth_profile_state, plugin_state_entries, plugin_blob_entries, media_blobs, skill_uploads, capture_sessions, capture_events, capture_blobs, sandbox_registry_entries, cron_run_logs, cron_jobs, commitments, delivery_queue_entries, model_capability_cache, workspace_setup_state, native_hook_relay_bridges, current_conversation_bindings, plugin_binding_approvals, tui_last_sessions, acp_sessions, acp_replay_sessions, acp_replay_events, task_runs, task_delivery_state, flow_runs, subagent_runs, migration_runs, backup_runs가 포함됩니다.
• 임의의 Plugin 소유 상태에는 호스트 소유 타입 지정 테이블을 제공하지 않습니다. 설치된 Plugin은 네임스페이스/키 소유권, TTL 정리, 백업 및 Plugin 마이그레이션 레코드와 함께 버전이 지정된 JSON 페이로드에는 plugin_state_entries를, 바이트에는 plugin_blob_entries를 사용합니다. 호스트가 쿼리 계약을 소유하는 경우에는 plugin_binding_approvals처럼 호스트 소유 Plugin 오케스트레이션 상태에 타입 지정 테이블을 계속 사용할 수 있습니다.
• Plugin 마이그레이션은 호스트 스키마 마이그레이션이 아니라 Plugin 소유 네임스페이스에 대한 데이터 마이그레이션입니다. Plugin은 마이그레이션 공급자를 통해 자체 버전 지정 상태/블롭 항목을 마이그레이션할 수 있으며, 호스트는 일반 마이그레이션 원장에 소스/실행 상태를 기록합니다. 호스트 자체가 새로운 Plugin 간 계약의 소유권을 맡는 경우가 아니면 새 Plugin 설치 시 openclaw-state-schema.sql을 변경할 필요가 없습니다.
• src/state/openclaw-agent-db.ts는 agents/<agentId>/agent/openclaw-agent.sqlite를 열고 전역 DB에 데이터베이스를 등록하며 에이전트 로컬 세션, 트랜스크립트, VFS, 아티팩트, 캐시 및 메모리 인덱스 테이블을 소유합니다. 이제 공유 런타임 검색은 각 호출 지점에서 해당 쿼리를 다시 구현하는 대신 생성된 타입이 적용된 agent_databases 레지스트리를 읽습니다.
• 전역 및 에이전트별 데이터베이스는 데이터베이스 역할, 스키마 버전, 타임스탬프 및 에이전트 데이터베이스의 에이전트 ID가 포함된 schema_meta 행을 기록합니다. 전역 DB는 user_version = 1로 유지되며, 에이전트별 DB는 제한된 메모리 소스 ID 마이그레이션 후 버전 2를 사용합니다.
• 이제 에이전트별 세션 ID에는 session_id를 키로 사용하는 정규 sessions 루트 테이블이 있으며, session_key, session_scope, account_id, primary_conversation_id, 타임스탬프, 표시 필드, 모델 메타데이터, 하네스 ID 및 부모/생성 연결이 쿼리 가능한 열로 포함됩니다. session_routes는 session_key에서 현재 session_id로 연결되는 고유한 활성 경로 인덱스이므로, 핫 읽기가 중복된 sessions.session_key 행 중에서 선택하도록 만들지 않고도 경로 키를 새로운 영구 세션으로 이동할 수 있습니다. 기존의 호환성 형태 session_entries.entry_json 페이로드는 외래 키를 통해 영구 session_id 루트에 연결됩니다. 이제 이 페이로드가 세션의 유일한 스키마 수준 표현은 아닙니다.
• 에이전트별 외부 대화 ID도 관계형입니다. conversations는 정규화된 공급자/계정/대화 ID를 저장하고, session_conversations는 하나의 OpenClaw 세션을 하나 이상의 외부 대화에 연결합니다. 이는 여러 피어가 session_key를 거짓으로 표현하지 않고 의도적으로 하나의 세션에 매핑될 수 있는 공유 기본 DM 세션을 지원합니다. 또한 SQLite는 자연스러운 공급자 ID의 고유성을 강제하므로 동일한 채널/계정/종류/피어/스레드 튜플이 여러 대화 ID로 분기될 수 없습니다. 공유 기본 직접 피어는 participant 역할로 연결되므로, 하나의 OpenClaw 세션이 이전 피어를 모호한 관련 행으로 격하하지 않고도 여러 외부 DM 피어를 나타낼 수 있습니다. sessions.primary_conversation_id는 계속 현재의 타입 지정 전송 대상을 가리킵니다. 닫힌 라우팅/상태 열은 TypeScript 유니온에만 의존하지 않고 SQLite CHECK 제약 조건으로 강제됩니다. 런타임 세션 프로젝션은 타입 지정 세션/대화 열을 적용하기 전에 session_entries.entry_json에서 호환성 라우팅 섀도를 제거하므로 오래된 JSON 페이로드가 전송 대상을 되살릴 수 없습니다. 마찬가지로 서브에이전트 알림 라우팅에는 타입 지정 SQLite 전송 컨텍스트가 필요하며, 더 이상 호환성 SessionEntry 경로 필드로 대체되지 않습니다. Gateway chat.send의 명시적 전송 상속은 origin/last* 호환성 필드 대신 타입 지정 SQLite 전송 컨텍스트를 읽습니다. 마찬가지로 tools.effective는 오래된 last* 세션 항목 섀도가 아니라 타입 지정 SQLite 전송/라우팅 행에서 공급자/계정/스레드 컨텍스트를 파생합니다. 시스템 이벤트 프롬프트 컨텍스트는 origin 섀도 대신 타입 지정 전송 필드에서 채널/대상/계정/스레드 필드를 다시 구성합니다. 이제 공유 deliveryContextFromSession 도우미와 세션-대화 매퍼는 SessionEntry.origin을 완전히 무시합니다. 타입 지정 전송 필드와 관계형 대화 행만 핫 경로 ID를 생성할 수 있습니다. 런타임 세션 항목 정규화는 entry_json을 영속화하거나 프로젝션하기 전에 origin을 제거하며, 인바운드 메타데이터는 새로운 origin 섀도를 만드는 대신 타입 지정 채널/채팅 필드와 관계형 대화 행을 기록합니다.
• 이제 트랜스크립트 이벤트, 트랜스크립트 스냅샷 및 궤적 런타임 이벤트는 정규 에이전트별 sessions 루트를 참조하며 세션 삭제 시 연쇄 삭제됩니다. 트랜스크립트 ID/멱등성 행은 계속 정확한 트랜스크립트 이벤트 행에서 연쇄 삭제됩니다.
• 이제 memory-core 인덱스는 명시적인 에이전트 데이터베이스 테이블 memory_index_meta, memory_index_sources, memory_index_chunks, memory_embedding_cache를 사용하며, memory_index_state는 리비전 변경을 추적합니다. 선택적 FTS/벡터 보조 인덱스는 일반적인 meta, files, chunks, chunks_fts, chunks_vec 테이블 대신 memory_index_chunks_fts와 memory_index_chunks_vec로 명명됩니다. 정규 이름은 현재 경로/소스 행 형태와 직렬화된 임베딩 호환성을 유지합니다. 이러한 테이블은 파생/검색 캐시이며 정규 트랜스크립트 저장소가 아닙니다. 삭제한 후 메모리 워크스페이스 파일과 구성된 소스에서 다시 빌드할 수 있습니다. 배포된 일반 이름의 메모리 인덱스를 열면 해당 메타데이터, 소스, 청크 및 임베딩 캐시가 정규 테이블로 마이그레이션됩니다. 파생 FTS/벡터 테이블은 정규 이름으로 다시 빌드됩니다.
• 이제 서브에이전트 실행 복구 상태는 자식, 요청자 및 컨트롤러 세션 키가 인덱싱된 타입 지정 공유 subagent_runs 행에 저장됩니다. 기존 subagents/runs.json 파일은 doctor 마이그레이션 입력으로만 사용됩니다.
• 이제 현재 대화 바인딩은 정규화된 대화 ID를 키로 사용하는 타입 지정 공유 current_conversation_bindings 행에 저장되며, 대상 에이전트/세션 열, 대화 종류, 상태, 만료 및 메타데이터가 중복된 불투명 바인딩 레코드 대신 관계형 열로 저장됩니다. 영구 바인딩 키에는 정규화된 대화 종류가 포함되므로 직접/그룹/채널 참조가 충돌할 수 없으며, SQLite는 유효하지 않은 바인딩 종류/상태 값을 거부합니다. 기존 bindings/current-conversations.json 파일은 doctor 마이그레이션 입력으로만 사용됩니다.
• 이제 전송 큐 복구는 채널, 대상, 계정, 세션, 재시도, 오류, 플랫폼 전송 및 복구 상태에 대한 타입 지정 큐 열을 재생 JSON 위에 오버레이합니다. entry_json은 재생 페이로드, 훅 및 서식 페이로드를 유지하지만, 핫 큐 라우팅/상태에서는 타입 지정 열이 권위 있는 데이터입니다.
• 이제 TUI 마지막 세션 복원 포인터는 해시된 TUI 연결/세션 범위를 키로 하는 타입 지정 공유 tui_last_sessions 행에 저장됩니다. 기존 TUI JSON 파일은 doctor 마이그레이션 입력으로만 사용됩니다.
• 이제 기본 TTS 환경설정은 speech-core Plugin 아래에 키가 지정된 공유 Plugin 상태 SQLite 행에 저장됩니다. 기존 settings/tts.json 파일은 doctor 마이그레이션 입력으로만 사용됩니다. 런타임은 더 이상 TTS 환경설정 JSON 파일을 읽거나 쓰지 않으며, 레거시 경로 리졸버는 doctor 마이그레이션 모듈에 있습니다.
• 이제 비밀 대상 메타데이터는 모든 자격 증명 대상이 구성 파일인 것처럼 표현하지 않고 저장소라는 용어를 사용합니다. openclaw.json은 계속 구성 저장소이며, 인증 프로필 대상은 공급자 형태의 자격 증명을 JSON 페이로드로 보관하는 타입 지정 SQLite auth_profile_stores 행을 사용합니다.
• 비밀 감사는 더 이상 폐기된 에이전트별 auth.json 파일을 검사하지 않습니다. 해당 레거시 파일에 대한 경고, 가져오기 및 제거는 doctor가 담당합니다.
• 이제 레거시 인증 프로필 경로 도우미는 doctor 레거시 코드에 있습니다. 핵심 인증 프로필 경로 도우미는 auth-profiles.json 또는 auth-state.json 런타임 경로가 아니라 SQLite 인증 저장소 ID와 표시 위치를 노출합니다.
• 이제 서브에이전트 실행 복구 및 OpenRouter 모델 기능 캐시 런타임 모듈은 SQLite 스냅샷 리더/라이터를 doctor 전용 레거시 JSON 가져오기 도우미와 분리하여 유지합니다. OpenRouter 기능은 하나의 불투명 캐시 블롭이나 공급자별 호스트 테이블 대신 provider_id = "openrouter" 아래의 타입 지정 일반 model_capability_cache 행을 사용합니다. 서브에이전트 실행 taskName은 타입 지정 subagent_runs.task_name 열에 저장됩니다. payload_json 사본은 재생/디버그 데이터이며 핫 표시 또는 조회 필드의 소스가 아닙니다.
• src/agents/filesystem/virtual-agent-fs.sqlite.ts는 에이전트 데이터베이스의 vfs_entries 테이블 위에 SQLite VFS를 구현합니다. 디렉터리 읽기, 재귀적 내보내기, 삭제 및 이름 변경은 전체 네임스페이스를 스캔하거나 LIKE 경로 일치에 의존하는 대신 인덱싱된 (namespace, path) 접두사 범위를 사용합니다.
• src/agents/runtime-worker.entry.ts는 워커를 위해 실행별 SQLite VFS, 도구 아티팩트, 실행 아티팩트 및 범위 지정 캐시 저장소를 생성합니다.
• 이제 워크스페이스 부트스트랩 완료 마커는 .openclaw/workspace-state.json 대신 확인된 워크스페이스 경로를 키로 하는 타입 지정 공유 workspace_setup_state 행에 저장됩니다. 런타임은 더 이상 레거시 워크스페이스 마커를 읽거나 다시 쓰지 않으며, 도우미 API도 저장소 ID를 파생하기 위한 목적으로 가짜 .openclaw/setup-state 경로를 전달하지 않습니다.
• 이제 실행 승인은 타입 지정 공유 SQLite exec_approvals_config 싱글턴 행에 저장됩니다. doctor는 레거시 ~/.openclaw/exec-approvals.json을 가져옵니다. 런타임 쓰기는 더 이상 해당 파일을 생성하거나 다시 쓰거나 활성 저장소 위치로 보고하지 않습니다. macOS 컴패니언은 동일한 state/openclaw.sqlite 테이블 행을 읽고 씁니다. Unix 프롬프트 소켓은 영구 런타임 상태가 아니라 IPC이므로 디스크에는 해당 소켓만 유지합니다.
• 이제 장치 ID, 장치 인증 및 부트스트랩 런타임 모듈은 SQLite 스냅샷 리더/라이터를 doctor 전용 레거시 JSON 가져오기 도우미와 분리하여 유지합니다. 장치 ID는 타입 지정 device_identities 행을 사용하고 장치 인증 토큰은 타입 지정 device_auth_tokens 행을 사용합니다. 장치 인증 쓰기는 토큰 테이블을 비우는 대신 장치/역할별로 행을 조정하며, 런타임은 더 이상 이전의 전체 저장소 어댑터를 통해 단일 토큰 업데이트를 처리합니다. 레거시 버전 1 JSON 페이로드는 doctor 가져오기/내보내기 형식으로만 존재합니다.
• GitHub Copilot 토큰 교환 캐시는 공유 SQLite Plugin 상태 테이블의 github-copilot/token-cache/default 아래를 사용합니다. 이는 공급자가 소유하는 캐시 상태이므로 의도적으로 호스트 스키마 테이블을 추가하지 않습니다.
• GitHub Copilot Compaction은 더 이상 openclaw-compaction-*.json 작업 공간 사이드카를 기록하지 않습니다. 하네스는 추적 중인 SDK 세션에 대해 SDK 기록 Compaction RPC를 호출하며, OpenClaw는 호환성 마커 파일 대신 SQLite에 영구 세션/트랜스크립트 상태를 보관합니다.
• 공유 Swift 런타임(OpenClawKit)은 기기 ID 및 기기 인증에 동일한 state/openclaw.sqlite 행을 사용합니다. macOS 앱 헬퍼는 별도의 JSON 또는 SQLite 경로를 소유하는 대신 공유 SQLite 헬퍼를 가져옵니다. 남아 있는 레거시 identity/device.json은 doctor가 이를 SQLite로 가져올 때까지 ID 생성을 차단하며, 이는 TypeScript 및 Android 시작 게이트와 일치합니다.
• Android 기기 ID는 형식이 지정된 state/openclaw.sqlite#table/device_identities 행에 저장된 동일한 TypeScript 호환 키 자료를 사용합니다. openclaw/identity/device.json을 읽거나 쓰지 않으며, 남아 있는 레거시 파일이 있으면 doctor가 이를 SQLite로 가져올 때까지 시작을 차단합니다.
• Android에 캐시된 기기 인증 토큰도 형식이 지정된 state/openclaw.sqlite#table/device_auth_tokens 행을 사용하며 TypeScript 및 Swift와 동일한 버전 1 토큰 의미 체계를 공유합니다. 런타임은 더 이상 SecurePrefs gateway.deviceToken* 호환성 키를 읽지 않으며, 해당 키는 마이그레이션/doctor 로직에만 속합니다.
• Android 알림의 최근 패키지 기록은 형식이 지정된 android_notification_recent_packages 행을 사용합니다. 런타임은 더 이상 이전 SharedPreferences CSV 키를 마이그레이션하거나 읽지 않습니다.
• 레거시 identity/device.json이 있거나, SQLite ID 행이 유효하지 않거나, SQLite ID 저장소를 열 수 없으면 기기 ID 생성이 실패 시 닫힘 방식으로 중단됩니다. doctor가 먼저 해당 파일을 가져오고 제거하므로, 런타임 시작 과정에서 마이그레이션 전에 페어링 ID가 암묵적으로 교체될 수 없습니다.
• 기기 ID 선택은 JSON 파일 위치 지정자가 아니라 SQLite 행 키입니다. 테스트와 Gateway 헬퍼는 명시적인 ID 키를 전달하며, doctor 마이그레이션과 실패 시 닫힘 방식의 시작 게이트만 폐기된 identity/device.json 파일 이름을 알고 있습니다.
• 이제 세션 재설정 호환성은 doctor 구성 마이그레이션에 있습니다. session.idleMinutes는 session.reset.idleMinutes로 이동하고, session.resetByType.dm은 session.resetByType.direct로 이동하며, 런타임 재설정 정책은 정규 재설정 키만 읽습니다.
• 이제 레거시 구성 호환성은 src/commands/doctor/ 아래에 있습니다. 일반 readConfigFileSnapshot() 유효성 검사는 doctor 레거시 감지기를 가져오거나 레거시 문제에 주석을 추가하지 않으며, runDoctorConfigPreflight()가 doctor의 복구/보고를 위해 해당 문제를 추가합니다. doctor 구성 흐름은 src/commands/doctor/legacy-config.ts를 가져오며, 이전 OAuth 프로필 ID 복구는 src/commands/doctor/legacy/oauth-profile-ids.ts 아래에 있습니다.
• doctor가 아닌 명령은 레거시 구성 복구를 자동 실행하지 않습니다. 예를 들어 이제 openclaw update --channel은 유효하지 않은 레거시 구성에서 실패하고, doctor 마이그레이션 코드를 암묵적으로 가져오는 대신 사용자에게 doctor를 실행하라고 요청합니다.
• 웹 푸시, APNs, Voice Wake, 업데이트 확인 및 구성 상태는 이제 구독, VAPID 키, Node 등록, 트리거 행, 라우팅 행, 업데이트 알림 상태 및 구성 상태 항목에 불투명한 전체 JSON Blob 대신 형식이 지정된 공유 SQLite 테이블을 사용합니다. 웹 푸시 및 APNs 스냅샷 쓰기는 이제 테이블을 비우는 대신 기본 키를 기준으로 구독/등록을 조정하며, 구성 상태도 구성 경로를 기준으로 동일하게 처리합니다. 해당 런타임 모듈은 SQLite 스냅샷 판독기/기록기를 doctor 전용 레거시 JSON 가져오기 헬퍼와 분리하여 유지합니다.
• Node 호스트 구성은 이제 공유 SQLite 데이터베이스의 형식이 지정된 싱글턴 행을 사용하며, doctor가 일반 런타임 사용 전에 이전 node.json 파일을 가져옵니다.
• 기기/Node 페어링, 채널 페어링, 채널 허용 목록 및 부트스트랩 상태는 이제 불투명한 전체 JSON Blob 대신 형식이 지정된 SQLite 행을 사용합니다. Plugin 바인딩 승인 및 Cron 작업 상태도 동일하게 분리됩니다. 런타임 모듈은 SQLite 기반 작업과 중립적인 스냅샷 헬퍼를 노출하고, 페어링/부트스트랩 및 Plugin 바인딩 승인 스냅샷 쓰기는 테이블을 잘라내는 대신 기본 키를 기준으로 행을 조정하며, doctor는 src/commands/doctor/legacy/* 모듈을 통해 이전 JSON 파일을 가져오고 제거합니다.
• 이제 설치된 Plugin 레코드는 SQLite 설치 Plugin 인덱스에 있습니다. 런타임 구성 읽기/쓰기는 더 이상 이전 plugins.installs 작성 구성 데이터를 마이그레이션하거나 보존하지 않으며, doctor가 일반 런타임 사용 전에 해당 레거시 구성 형식을 SQLite로 가져옵니다.
• 이제 QQBot 자격 증명 복구 스냅샷은 SQLite Plugin 상태의 qqbot/credential-backups 아래에 있습니다. 런타임은 더 이상 qqbot/data/credential-backup*.json을 쓰지 않으며, QQBot doctor 계약이 활성 상태 디렉터리에서 해당 레거시 백업 파일을 가져오고 보관합니다.
• Gateway 다시 로드 계획은 내부 installedPluginIndex.installRecords.* 차이 네임스페이스에서 SQLite 설치 Plugin 인덱스 스냅샷을 비교합니다. 런타임 다시 로드 결정은 더 이상 해당 행을 가짜 plugins.installs 구성 객체로 감싸지 않습니다.
• Matrix 명명 계정 자격 증명 업그레이드는 더 이상 런타임 읽기 중에 발생하지 않습니다. 단일/기본 Matrix 계정을 결정할 수 있는 경우 이전 최상위 credentials/matrix/credentials.json 이름 변경은 doctor가 담당합니다.
• 코어 페어링 및 Cron 런타임 모듈은 더 이상 레거시 JSON 경로 빌더를 내보내지 않습니다. doctor 소유 레거시 모듈은 가져오기 테스트와 마이그레이션만을 위해 pending.json, paired.json, bootstrap.json 및 cron/jobs.json 원본 경로를 구성합니다. 레거시 Cron 작업 형식 정규화 및 Cron 실행 로그 가져오기는 src/commands/doctor/legacy/cron*.ts 아래에 있습니다.
• src/commands/doctor/legacy/runtime-state.ts는 Node 호스트 구성을 포함한 레거시 JSON 상태 파일을 doctor에서 SQLite로 가져옵니다. 새로운 레거시 파일 가져오기 도구는 src/commands/doctor/legacy/ 아래에 유지합니다.
• src/commands/doctor/state-migrations.ts는 레거시 sessions.json과 *.jsonl 트랜스크립트를 SQLite로 직접 가져오고, 성공적으로 가져온 원본을 제거합니다. 더 이상 루트 레거시 트랜스크립트를 agents/<agentId>/sessions/*.jsonl을 통해 준비하거나 가져오기 전에 정규 JSONL 대상을 생성하지 않습니다.
• 상태 무결성 doctor 검사는 더 이상 레거시 세션 디렉터리를 검사하거나 고아 JSONL 삭제를 제안하지 않습니다. 레거시 트랜스크립트 파일은 마이그레이션 입력으로만 사용되며, 마이그레이션 단계가 가져오기와 원본 제거를 담당합니다.
• 레거시 샌드박스 레지스트리 가져오기는 src/commands/doctor/legacy/sandbox-registry.ts 아래에 있으며, 활성 샌드박스 레지스트리 읽기와 쓰기는 계속 SQLite만 사용합니다.
• 레거시 세션 트랜스크립트 상태/가져오기 복구는 src/commands/doctor/legacy/session-transcript-health.ts 아래에 있으며, 런타임 명령 모듈은 더 이상 JSONL 트랜스크립트 구문 분석이나 활성 브랜치 복구 코드를 포함하지 않습니다.

통합/삭제 완료 주요 사항:

• Plugin 상태는 이제 공유 state/openclaw.sqlite 데이터베이스를 사용합니다. 이전 브랜치 로컬 plugin-state/state.sqlite 사이드카 가져오기 도구는 해당 SQLite 레이아웃이 출시된 적이 없으므로 제거되었습니다. 프로브/테스트 헬퍼는 Plugin 상태 전용 SQLite 경로를 노출하는 대신 공유 databasePath를 보고합니다.
• 작업 및 Task Flow 런타임 테이블은 이제 tasks/runs.sqlite 및 tasks/flows/registry.sqlite 대신 공유 state/openclaw.sqlite 데이터베이스에 있습니다. 이전 사이드카 가져오기 도구는 동일하게 출시되지 않은 레이아웃이라는 이유로 제거되었습니다.
• src/config/sessions/store.ts는 인바운드 메타데이터, 경로 업데이트 또는 업데이트 시각 읽기에 더 이상 storePath가 필요하지 않습니다. 명령 지속성, CLI 세션 정리, 하위 에이전트 깊이, 인증 재정의 및 트랜스크립트 세션 ID에는 에이전트/세션 행 API를 사용합니다. 쓰기는 낙관적 충돌 재시도와 함께 SQLite 행 패치로 적용됩니다.
• 이제 세션 대상 확인은 레거시 sessions.json 경로가 아니라 에이전트별 데이터베이스 대상을 노출합니다. 공유 Gateway, ACP 메타데이터, doctor 경로 복구 및 openclaw sessions는 agent_databases와 구성된 에이전트를 열거합니다.
• 이제 Gateway 세션 라우팅은 resolveGatewaySessionDatabaseTarget을 사용합니다. 반환된 대상은 레거시 세션 저장소 파일 경로 대신 databasePath와 후보 SQLite 행 키를 포함합니다.
• 이제 채널 세션 런타임 타입은 업데이트 시각 읽기, 인바운드 메타데이터 및 마지막 경로 업데이트에 {agentId, sessionKey}를 노출합니다. 이전 saveSessionStore(storePath, store) 호환성 타입은 제거되었습니다.
• 이제 Plugin 런타임, 확장 API 및 Plugin SDK 세션 표면은 활성 세션 전체 저장소/파일 호환성 헬퍼 대신 SQLite 기반 세션 행 헬퍼를 노출합니다. 루트 라이브러리 호환성 내보내기는 레거시 내부 및 마이그레이션 호출자를 위해 Plugin SDK 외부에서만 계속 사용할 수 있습니다. 이전 resolveLegacySessionStorePath 헬퍼는 제거되었으며, 이제 레거시 sessions.json 경로 구성은 마이그레이션 및 테스트 픽스처에만 존재합니다.
• 이제 src/config/sessions/session-entries.sqlite.ts는 에이전트별 데이터베이스에 정규 세션 항목을 저장하며, 행 수준 읽기/업서트/삭제 패치를 지원합니다. 런타임 업서트/패치/삭제는 더 이상 대소문자 변형을 검색하거나 레거시 별칭 키를 정리하지 않으며, 정규화는 doctor가 담당합니다. 독립형 JSON 가져오기 헬퍼는 제거되었으며, 마이그레이션 병합은 전체 세션 테이블을 교체하는 대신 더 새로운 행을 업서트합니다. 공개 읽기/목록/로드 헬퍼는 타입이 지정된 sessions 및 conversations 행에서 자주 사용되는 세션 메타데이터를 투영합니다. entry_json은 호환성/디버그용 섀도이며, 타입이 지정된 세션 ID 또는 전달 컨텍스트를 잃지 않고도 오래되거나 유효하지 않을 수 있습니다.
• 이제 src/config/sessions/delivery-info.ts는 타입이 지정된 에이전트별 sessions + conversations + session_conversations 행에서 전달 컨텍스트를 확인합니다. 더 이상 session_entries.entry_json에서 런타임 전달 ID를 재구성하지 않습니다. 타입이 지정된 대화 행이 누락된 경우 이는 런타임 폴백 대상이 아니라 doctor 마이그레이션/복구 문제입니다.
• 이제 저장된 세션 재설정 결정은 타입이 지정된 sessions.session_scope, sessions.chat_type 및 sessions.channel 메타데이터를 우선합니다. sessionKey 구문 분석은 명령 대상의 명시적 스레드/주제 접미사에만 남아 있습니다. 그룹과 직접 대화의 재설정 분류는 더 이상 키 형태에서 가져오지 않습니다.
• 이제 세션 목록/상태 표시 분류는 타입이 지정된 채팅 메타데이터와 Gateway 세션 종류를 사용합니다. 더 이상 session_key 내부의 :group: 또는 :channel: 부분 문자열을 영속적인 그룹/직접 대화 판별 정보로 취급하지 않습니다.
• 이제 무응답 정책 선택은 명시적 대화 유형 또는 표면 메타데이터만 사용합니다. 더 이상 session_key 부분 문자열로 직접/그룹 정책을 추측하지 않습니다.
• 이제 세션 표시 모델 확인은 session_key에서 에이전트 ID를 분리하는 대신 SQLite 세션 데이터베이스 대상에서 이를 전달받습니다.
• 이제 에이전트 간 알림 대상 하이드레이션은 타입이 지정된 sessions.list deliveryContext만 사용합니다. 더 이상 레거시 origin, 미러링된 last* 필드 또는 session_key 형태에서 채널/계정/스레드 라우팅을 복구하지 않습니다.
• 이제 sessions_send의 스레드 대상 거부는 타입이 지정된 SQLite 라우팅 메타데이터를 읽습니다. 더 이상 대상 키에서 스레드 접미사를 구문 분석하여 대상을 거부하거나 허용하지 않습니다.
• 이제 그룹 범위 도구 정책 검증은 현재 세션 또는 생성된 세션의 타입이 지정된 SQLite 대화 라우팅을 읽습니다. 더 이상 sessionKey를 디코딩하여 그룹/채널 ID를 신뢰하지 않습니다. 타입이 지정된 세션 행이 보증하지 않으면 호출자가 제공한 그룹 ID는 폐기됩니다.
• 이제 채널 모델 재정의 일치는 명시적 그룹 및 상위 대화 메타데이터를 사용합니다. 더 이상 parentSessionKey에서 상위 대화 ID를 디코딩하지 않습니다.
• 이제 저장된 모델 재정의 상속에는 타입이 지정된 세션 컨텍스트의 명시적 상위 세션 키가 필요합니다. 더 이상 sessionKey의 :thread: 또는 :topic: 접미사에서 상위 재정의를 파생하지 않습니다.
• 이전 세션 스레드 정보 래퍼와 로드된 Plugin 스레드 파서는 제거되었습니다. 어떤 런타임 코드도 config/sessions/thread-info를 가져오지 않습니다.
• 채널 대화 헬퍼는 더 이상 전체 세션 키 구문 분석 브리지를 노출하지 않습니다. 코어는 여전히 resolveSessionConversation(...)을 통해 제공자 소유의 원시 대화 ID를 정규화하지만, sessionKey에서 경로 정보를 재구성하지는 않습니다.
• 완료 전달, 전송 정책 및 작업 유지 관리는 더 이상 session_key 형태에서 채팅 유형을 파생하지 않습니다. 이전 채팅 유형 키 파서는 삭제되었습니다. 이러한 경로에는 타입이 지정된 세션 메타데이터, 타입이 지정된 전달 컨텍스트 또는 명시적 전달 대상 어휘가 필요합니다.
• 세션 목록/상태, 진단, 승인 계정 바인딩, TUI Heartbeat 필터링 및 사용량 요약은 더 이상 제공자/계정/스레드/표시 라우팅을 위해 SessionEntry.origin을 분석하지 않습니다. 남아 있는 유일한 런타임 origin 읽기는 세션 이외의 개념 또는 현재 턴의 전달 객체에 대한 것입니다.
• 이제 승인 요청의 네이티브 대화 조회는 타입이 지정된 에이전트별 세션 라우팅 행을 읽습니다. 더 이상 sessionKey에서 채널/그룹/스레드 대화 ID를 구문 분석하지 않습니다. 타입이 지정된 메타데이터가 누락된 경우 이는 마이그레이션/복구 문제입니다.
• Gateway 세션 변경/채팅/세션 이벤트 페이로드는 더 이상 SessionEntry.origin 또는 last* 경로 섀도를 그대로 반환하지 않습니다. 클라이언트는 타입이 지정된 channel, chatType 및 deliveryContext를 받습니다.
• 이제 Heartbeat 전달 확인은 타입이 지정된 SQLite deliveryContext를 직접 받을 수 있으며, Heartbeat 런타임은 현재 라우팅에 호환성 session_entries 섀도를 사용하는 대신 에이전트별 세션 전달 행을 전달합니다.
• Cron 격리 에이전트 전달 대상 확인도 호환성 항목 페이로드로 폴백하기 전에 타입이 지정된 에이전트별 세션 전달 행에서 현재 경로를 하이드레이션합니다.
• 이제 하위 에이전트 알림 출처 확인은 타입이 지정된 요청자 세션 전달 컨텍스트를 loadRequesterSessionEntry를 통해 전달하고, 호환성 last*/ deliveryContext 섀도보다 해당 행을 우선합니다.
• 이제 인바운드 세션 메타데이터 업데이트는 먼저 타입이 지정된 에이전트별 전달 행을 기준으로 병합합니다. 타입이 지정된 대화 행이 없는 경우에만 이전 SessionEntry 전달 필드를 폴백으로 사용합니다.
• 이제 재시작/업데이트 전달 추출에서는 타입이 지정된 SQLite 전달 threadId가 sessionKey에서 구문 분석한 주제/스레드 조각보다 우선합니다. 구문 분석은 레거시 스레드 형태 키에만 폴백으로 사용됩니다.
• 이제 훅 에이전트 컨텍스트 채널 ID는 타입이 지정된 SQLite 대화 ID를 우선하고, 다음으로 명시적 메시지 메타데이터를 사용합니다. 더 이상 sessionKey에서 제공자/그룹/채널 조각을 구문 분석하지 않습니다.
• 이제 Gateway chat.send 외부 경로 상속은 sessionKey 조각에서 채널/직접/그룹 범위를 추론하는 대신 타입이 지정된 SQLite 세션 라우팅 메타데이터를 읽습니다. 채널 범위 세션은 타입이 지정된 세션 채널 및 채팅 유형이 저장된 전달 컨텍스트와 일치할 때만 상속합니다. 공유 메인 세션에는 더 엄격한 CLI/클라이언트 메타데이터 없음 규칙이 계속 적용됩니다.
• 이제 재시작 센티널 깨우기 및 연속 라우팅은 Heartbeat 깨우기 또는 라우팅된 에이전트 턴 연속 작업을 대기열에 넣기 전에 타입이 지정된 SQLite 전달/라우팅 행을 읽습니다. 더 이상 세션 항목 JSON 섀도에서 전달 컨텍스트를 재구성하지 않습니다.
• 이제 Gateway tools.effective 컨텍스트 확인은 제공자, 계정, 대상, 스레드 및 응답 모드 입력에 대해 타입이 지정된 SQLite 전달/라우팅 행을 읽습니다. 더 이상 오래된 session_entries.entry_json 출처 섀도에서 자주 사용되는 라우팅 필드를 복구하지 않습니다.
• 이제 실시간 음성 상담 라우팅은 타입이 지정된 에이전트별 SQLite 세션 행에서 상위/통화 전달을 확인합니다. 내장 에이전트 메시지 경로를 선택할 때 더 이상 호환성 SessionEntry.deliveryContext 섀도로 폴백하지 않습니다.
• 이제 ACP 생성 Heartbeat 릴레이 및 상위 스트림 라우팅은 타입이 지정된 SQLite 세션 행에서 상위 전달을 읽습니다. 더 이상 호환성 세션 항목 섀도에서 상위 전달 컨텍스트를 재구성하지 않습니다.
• 이제 세션 전달 경로 보존은 타입이 지정된 채팅 메타데이터와 지속된 전달 열을 따릅니다. 더 이상 sessionKey에서 채널 힌트, 직접/메인 마커 또는 스레드 형태를 추출하지 않습니다. 내부 웹 채팅 경로는 SQLite에 해당 세션의 타입 지정/지속 전달 ID가 이미 있는 경우에만 외부 대상을 상속합니다.
• 이제 일반 세션 전달 추출은 정확히 일치하는 타입 지정 SQLite 세션 전달 행만 읽습니다. 더 이상 스레드/주제 접미사를 구문 분석하거나 스레드 형태 키에서 기본 세션 키로 폴백하지 않습니다.
• 이제 응답 디스패치, 재시작 센티널 복구 및 실시간 음성 상담 라우팅은 스레드 라우팅에 정확히 일치하는 타입 지정 SQLite 세션/대화 행을 사용합니다. 더 이상 스레드 형태의 세션 키를 구문 분석하여 스레드 ID 또는 기본 세션 전달 컨텍스트를 복구하지 않습니다.
• 이제 내장 PI 기록 제한은 제공자, 채팅 유형 및 피어 ID에 타입이 지정된 SQLite 세션 라우팅 투영(sessions + 기본 conversations)을 사용합니다. 더 이상 sessionKey에서 제공자, DM, 그룹 또는 스레드 형태를 구문 분석하지 않습니다.
• 이제 Cron 도구 전달 추론은 명시적 전달 또는 현재 타입 지정 전달 컨텍스트만 사용합니다. 더 이상 agentSessionKey에서 채널, 피어, 계정 또는 스레드 대상을 디코딩하지 않습니다.
• 런타임 세션 행은 더 이상 이전 lastProvider 경로 별칭을 포함하지 않습니다. 헬퍼와 테스트는 타입이 지정된 lastChannel 및 deliveryContext 필드를 사용합니다. 이전 경로 별칭 또는 지속된 origin 섀도를 변환해야 하는 유일한 위치는 doctor 마이그레이션입니다.
• 이제 트랜스크립트 이벤트, VFS 행 및 도구 아티팩트 행은 에이전트별 데이터베이스에 기록됩니다. 출시되지 않은 전역 트랜스크립트 파일 매핑 테이블은 제거되었습니다. 대신 doctor가 레거시 소스 경로를 영속 마이그레이션 행에 기록합니다.
• 런타임 트랜스크립트 조회는 더 이상 JSONL 바이트 오프셋을 검색하거나 레거시 트랜스크립트 파일을 탐색하지 않습니다. Gateway 채팅/미디어/기록 경로는 SQLite에서 트랜스크립트 행을 읽습니다. 이제 세션 JSONL은 런타임 상태 또는 내보내기 형식이 아니라 레거시 doctor 입력으로만 사용됩니다.
• 트랜스크립트 상위 및 브랜치 관계는 경로 형태의 agent-db:...transcript_events... 로케이터 문자열이 아니라 SQLite 트랜스크립트 헤더의 구조화된 parentTranscriptScope: {agentId, sessionId} 메타데이터를 사용합니다.
• 트랜스크립트 관리자 계약은 더 이상 암시적으로 지속되는 create(cwd) 또는 continueRecent(cwd) 생성자를 노출하지 않습니다. 지속형 트랜스크립트 관리자는 명시적인 {agentId, sessionId} 범위로 열립니다. 테스트 및 순수 트랜스크립트 변환을 위한 메모리 내 관리자만 범위 없이 유지됩니다.
• 런타임 트랜스크립트 저장소 API는 파일 시스템 경로가 아닌 SQLite 범위를 확인합니다. 이전 resolve...ForPath 헬퍼와 사용되지 않는 transcriptPath 쓰기 옵션은 런타임 호출자에서 제거되었습니다.
• 이제 런타임 세션 확인은 {agentId, sessionId}를 사용하며 외부 경계를 위해 sqlite-transcript://<agent>/<session> 문자열을 파생해서는 안 됩니다. 레거시 절대 JSONL 경로는 doctor 마이그레이션 입력으로만 사용됩니다.
• 이제 네이티브 훅 릴레이 직접 브리지 레코드는 릴레이 ID를 키로 사용하는 타입 지정 공유 native_hook_relay_bridges 행에 저장됩니다. 런타임은 더 이상 이러한 단기 브리지 레코드를 위해 /tmp JSON 레지스트리 또는 불투명한 일반 레코드를 쓰지 않습니다.
• runEmbeddedPiAgent(...)에는 더 이상 트랜스크립트 로케이터 매개변수가 없습니다. 준비된 작업자 설명자에서도 트랜스크립트 로케이터를 생략합니다. 런타임 세션 상태와 대기 중인 후속 실행은 파생된 트랜스크립트 핸들 대신 {agentId, sessionId}을 전달합니다.
• 이제 내장 Compaction은 agentId 및 sessionId에서 SQLite 범위를 가져옵니다. Compaction 훅, 컨텍스트 엔진 호출, CLI 위임 및 프로토콜 응답은 파생된 sqlite-transcript://... 핸들을 받아서는 안 됩니다. 내보내기/디버그 코드는 행에서 명시적인 사용자 아티팩트를 구체화할 수 있지만, 일반적인 세션 JSONL 내보내기 경로를 제공하거나 파일 이름을 런타임 ID에 다시 입력하지 않습니다.
• /export-session은 SQLite에서 트랜스크립트 행을 읽고 요청된 독립 실행형 HTML 보기만 작성합니다. 내장 뷰어는 더 이상 해당 행에서 세션 JSONL을 재구성하거나 다운로드하지 않습니다.
• 컨텍스트 엔진 위임은 더 이상 에이전트 ID를 복구하기 위해 트랜스크립트 로케이터를 파싱하지 않습니다. 준비된 런타임 컨텍스트는 확인된 agentId을 기본 제공 Compaction 어댑터로 전달합니다.
• 이제 트랜스크립트 재작성 및 실시간 도구 결과 잘라내기는 {agentId, sessionId}을 기준으로 트랜스크립트 상태를 읽고 유지하며, 트랜스크립트 업데이트 이벤트 페이로드를 위한 임시 로케이터를 파생하지 않습니다.
• 트랜스크립트 상태 도우미 표면에는 더 이상 로케이터 기반 readTranscriptState, replaceTranscriptStateEvents 또는 persistTranscriptStateMutation 변형이 없습니다. 런타임 호출자는 {agentId, sessionId} API를 사용해야 합니다. Doctor 가져오기는 명시적인 파일 경로로 레거시 파일을 읽고 SQLite 행을 작성하며, 로케이터 문자열은 마이그레이션하지 않습니다.
• 런타임 세션 관리자 계약은 더 이상 open(locator), forkFrom(locator) 또는 setTranscriptLocator(...)을 노출하지 않습니다. 영구 세션 관리자는 {agentId, sessionId}만으로 열며, 목록/포크 도우미는 트랜스크립트 관리자 퍼사드 대신 행 중심 세션 및 체크포인트 API에 있습니다.
• Gateway 트랜스크립트 리더 API는 범위를 우선합니다. 이 API는 {agentId, sessionId}을 받으며, 실수로 런타임 ID가 될 수 있는 위치 기반 트랜스크립트 로케이터를 허용하지 않습니다. 활성 트랜스크립트 로케이터 파싱은 제거되었으며, 레거시 소스 경로는 Doctor 가져오기 코드에서만 읽습니다.
• 트랜스크립트 업데이트 이벤트도 범위를 우선합니다. emitSessionTranscriptUpdate은 더 이상 단독 로케이터 문자열을 허용하지 않으며, 리스너는 핸들을 파싱하지 않고 {agentId, sessionId}을 기준으로 라우팅합니다.
• Gateway 세션 메시지 브로드캐스트는 트랜스크립트 로케이터가 아니라 에이전트/세션 범위에서 세션 키를 확인합니다. 기존의 트랜스크립트 로케이터-세션 키 확인자/캐시는 제거되었습니다.
• Gateway 세션 기록 SSE는 에이전트/세션 범위를 기준으로 실시간 업데이트를 필터링합니다. 더 이상 스트림이 업데이트를 받아야 하는지 결정하기 위해 트랜스크립트 로케이터 후보, 실제 경로 또는 파일 형태의 트랜스크립트 ID를 정규화하지 않습니다.
• 세션 수명 주기 훅은 더 이상 session_end에서 트랜스크립트 로케이터를 파생하거나 노출하지 않습니다. 훅 소비자는 sessionId, sessionKey, 다음 세션 ID 및 에이전트 컨텍스트를 받으며, 트랜스크립트 파일은 수명 주기 계약의 일부가 아닙니다.
• 재설정 훅도 더 이상 트랜스크립트 로케이터를 파생하거나 노출하지 않습니다. before_reset 페이로드는 복구된 SQLite 메시지와 재설정 이유를 전달하며, 세션 ID는 훅 컨텍스트에 유지됩니다.
• 에이전트 하네스 재설정은 더 이상 트랜스크립트 로케이터를 허용하지 않습니다. 재설정 디스패치는 sessionId/sessionKey와 이유를 기준으로 범위가 지정됩니다.
• 에이전트 확장 세션 유형은 더 이상 transcriptLocator을 노출하지 않습니다. 확장은 파일 형태의 트랜스크립트 ID에 접근하는 대신 세션 컨텍스트와 런타임 API를 사용해야 합니다.
• Plugin Compaction 훅은 더 이상 트랜스크립트 로케이터를 노출하지 않습니다. 훅 컨텍스트에는 이미 세션 ID가 있으며, 트랜스크립트 읽기는 파일 형태의 핸들 대신 SQLite 범위 인식 API를 통해 수행해야 합니다.
• before_agent_finalize 훅은 네이티브 훅 릴레이 페이로드를 포함하여 더 이상 transcriptPath을 노출하지 않습니다. 완료 훅은 세션 컨텍스트만 사용합니다.
• Gateway 재설정 응답은 반환된 항목에 더 이상 트랜스크립트 로케이터를 합성하지 않습니다. 재설정은 SQLite 트랜스크립트 행을 만들고 정리된 세션 항목을 반환하며, 트랜스크립트 접근은 범위 인식 리더에 맡깁니다.
• 내장 실행 및 Compaction 결과는 세션 집계를 위해 더 이상 트랜스크립트 로케이터를 노출하지 않습니다. 자동 Compaction은 활성 sessionId, Compaction 카운터 및 토큰 메타데이터만 업데이트합니다.
• 내장 시도 결과는 더 이상 transcriptLocatorUsed을 반환하지 않으며, 컨텍스트 엔진 compact() 결과도 더 이상 트랜스크립트 로케이터를 반환하지 않습니다. 런타임 재시도 루프는 후속 sessionId만 허용합니다.
• 전송 미러 트랜스크립트 추가 결과는 더 이상 트랜스크립트 로케이터를 반환하지 않습니다. 호출자는 추가된 messageId을 받으며, 트랜스크립트 업데이트 신호는 SQLite 범위를 사용합니다.
• 상위 세션 포크 도우미는 포크된 sessionId만 반환합니다. 하위 에이전트 준비는 하위 에이전트/세션 범위를 엔진에 전달합니다.
• CLI 실행기 매개변수 및 기록 재시딩은 더 이상 트랜스크립트 로케이터를 허용하지 않습니다. CLI 기록 읽기는 {agentId, sessionId} 및 세션 키 컨텍스트에서 SQLite 트랜스크립트 범위를 확인합니다.
• 이제 CLI 및 내장 실행기 테스트 픽스처는 활성 세션을 *.jsonl 파일로 가장하거나 런타임 매개변수를 통해 sqlite-transcript://... 문자열을 전달하는 대신, 세션 ID를 기준으로 SQLite 트랜스크립트 행을 시딩하고 읽습니다.
• 세션 도구 결과 가드 이벤트는 인메모리 관리자에 파생된 로케이터가 없는 경우에도 알려진 세션 범위에서 발생합니다. 해당 테스트는 더 이상 활성 /tmp/*.jsonl 트랜스크립트 파일을 가장하지 않습니다.
• 이제 BTW 및 Compaction 체크포인트 도우미는 SQLite 범위를 기준으로 트랜스크립트 행을 읽고 포크합니다. 체크포인트 메타데이터는 이제 세션 ID와 리프/항목 ID만 저장하며, 파생된 로케이터는 더 이상 체크포인트 페이로드에 기록되지 않습니다.
• Gateway 트랜스크립트 키 조회는 프로토콜 경계에서 SQLite 트랜스크립트 범위를 사용하며, 더 이상 트랜스크립트 파일 이름의 실제 경로를 확인하거나 상태를 조회하지 않습니다.
• 자동 Compaction 트랜스크립트 순환은 SQLite 트랜스크립트 저장소를 통해 후속 트랜스크립트 행을 직접 작성합니다. 세션 행에는 영구 JSONL 경로나 유지되는 로케이터가 아닌 후속 세션 ID만 보관됩니다.
• 내장 컨텍스트 엔진 Compaction은 SQLite 명명 방식의 트랜스크립트 순환 도우미를 사용합니다. 순환 테스트는 더 이상 JSONL 후속 경로를 구성하거나 활성 세션을 파일로 모델링하지 않습니다.
• 관리되는 발신 이미지 보존은 파일 시스템 상태 호출 대신 SQLite 트랜스크립트 통계를 기준으로 트랜스크립트 메시지 캐시 키를 지정합니다.
• 런타임 세션 잠금 및 독립 실행형 레거시 .jsonl.lock Doctor 경로가 제거되었습니다.
• Microsoft Teams 런타임 배럴 및 공개 Plugin SDK는 더 이상 기존 파일 잠금 도우미를 다시 내보내지 않으며, 영구 Plugin 상태 경로는 SQLite 기반입니다.
• 세션 기간/개수 가지치기 및 명시적인 세션 정리가 제거되었습니다. Doctor가 레거시 가져오기를 담당하며, 오래된 세션은 명시적으로 재설정하거나 삭제합니다.
• Doctor 무결성 검사는 더 이상 레거시 JSONL 파일을 SQLite 세션 행의 유효한 활성 트랜스크립트로 계산하지 않습니다. 활성 트랜스크립트 상태는 SQLite만을 기준으로 하며, 레거시 JSONL 파일은 마이그레이션/고립 항목 정리 입력으로 보고됩니다.
• Doctor는 더 이상 agents/<agent>/sessions/을 필수 런타임 상태로 취급하지 않습니다. 해당 디렉터리가 이미 존재하는 경우에만 레거시 가져오기 또는 고립 항목 정리 입력으로 스캔합니다.
• Gateway sessions.resolve, 세션 패치/재설정/Compaction 경로, 하위 에이전트 생성, 빠른 중단, ACP 메타데이터, Heartbeat 격리 세션 및 TUI 패치는 더 이상 일반 런타임 작업의 부수 효과로 레거시 세션 키를 마이그레이션하거나 가지치기하지 않습니다.
• 이제 CLI 명령 세션 확인은 storePath 대신 소유 agentId을 반환하며, 일반적인 --to 또는 --session-id 확인 중에는 더 이상 레거시 기본 세션 행을 복사하지 않습니다. 레거시 기본 행 정규화는 Doctor에서만 수행합니다.
• 런타임 하위 에이전트 깊이 확인은 더 이상 sessions.json 또는 JSON5 세션 저장소를 읽지 않습니다. 에이전트 ID를 기준으로 SQLite session_entries을 읽으며, 레거시 깊이/세션 메타데이터는 Doctor 가져오기 경로를 통해서만 들어올 수 있습니다.
• 인증 프로필 세션 재정의는 파일 형태의 세션 저장소 런타임을 지연 로드하는 대신 직접 {agentId, sessionKey} 행 업서트를 통해 유지됩니다.
• 이제 자동 응답 상세 출력 게이팅 및 세션 업데이트 도우미는 세션 ID를 기준으로 SQLite 세션 행을 읽고 업서트하며, 영구 행 상태를 변경하기 전에 더 이상 레거시 저장소 경로를 요구하지 않습니다.
• 이제 명령 실행 세션 메타데이터 도우미는 항목 중심 이름과 모듈 경로를 사용하며, 기존 session-store 명령 도우미 표면은 제거되었습니다.
• 부트스트랩 헤더 시딩 및 수동 Compaction 경계 강화는 이제 SQLite 트랜스크립트 행을 직접 변경합니다. 런타임 호출자는 쓰기 가능한 .jsonl 경로가 아닌 세션 ID를 전달합니다.
• 자동 세션 순환 재생은 SQLite 트랜스크립트 행에서 {agentId, sessionId}을 기준으로 최근 사용자/어시스턴트 대화를 복사합니다. 더 이상 소스 또는 대상 트랜스크립트 로케이터를 허용하지 않습니다.
• 새로운 런타임 세션 행은 더 이상 트랜스크립트 로케이터를 저장하지 않습니다. 호출자는 {agentId, sessionId}을 직접 사용하며, 내보내기/디버그 명령은 행을 구체화할 때 출력 파일 이름을 선택할 수 있습니다.
• 이제 새로운 영구 트랜스크립트 세션을 시작하면 항상 범위를 기준으로 SQLite 행을 엽니다. 세션 관리자는 더 이상 이전 파일 시대의 트랜스크립트 경로나 로케이터를 새 세션의 ID로 재사용하지 않습니다.
• 영구 트랜스크립트 세션은 명시적인 openTranscriptSessionManagerForSession({agentId, sessionId}) API를 사용합니다. 기존의 정적 SessionManager.create/openForSession/list/forkFromSession 퍼사드는 제거되어 테스트와 런타임 코드가 실수로 파일 시대의 세션 검색을 다시 만들 수 없습니다.
• Plugin 런타임은 더 이상 api.runtime.agent.session.resolveTranscriptLocatorPath을 노출하지 않으며, Plugin 코드는 SQLite 행 도우미와 범위 값을 사용합니다.
• 공개 session-store-runtime SDK 표면은 이제 세션 행 및 트랜스크립트 행 도우미만 내보냅니다. 집중화된 SQLite 스키마/경로/트랜잭션 도우미는 sqlite-runtime에 있으며, 원시 열기/닫기/재설정 도우미는 자사 테스트에서만 로컬로 유지됩니다.
• 레거시 .jsonl 궤적/체크포인트 파일 이름 분류기는 이제 Doctor 레거시 세션 파일 모듈에 있습니다. 코어 세션 검증은 더 이상 일반 SQLite 세션 ID를 결정하기 위해 파일 아티팩트 도우미를 가져오지 않습니다.
• Active Memory 차단 하위 에이전트 실행은 Plugin 상태 아래에 임시 또는 영구 session.jsonl 파일을 만드는 대신 SQLite 트랜스크립트 행을 사용합니다. 기존 transcriptDir 옵션은 제거되었습니다.
• 일회성 슬러그 생성 및 Crestodian 플래너 실행은 임시 session.jsonl 파일을 만드는 대신 SQLite 트랜스크립트 행을 사용합니다.
• llm-task 도우미 실행 및 숨겨진 커밋먼트 추출도 SQLite 트랜스크립트 행을 사용하므로, 이러한 모델 전용 도우미 세션은 더 이상 임시 JSON/JSONL 트랜스크립트 파일을 만들지 않습니다.
• TranscriptSessionManager은 이제 열린 SQLite 트랜스크립트 범위일 뿐입니다. 런타임 코드는 openTranscriptSessionManagerForSession({agentId, sessionId})으로 이를 열며, 생성, 분기, 계속, 목록 및 포크 흐름은 정적 관리자 퍼사드가 아닌 해당 흐름을 소유한 SQLite 행 도우미에 있습니다. Doctor/가져오기/디버그 코드는 런타임 세션 관리자 외부에서 명시적인 레거시 소스 파일을 처리합니다.
• 오래된 SessionManager.newSession() 및 SessionManager.createBranchedSession() 퍼사드 메서드가 제거되었습니다. 새로운 세션 및 트랜스크립트 하위 항목은 이미 열린 관리자를 다른 영구 세션으로 변경하는 대신 해당 항목을 소유한 SQLite 워크플로에서 생성됩니다.
• 상위 트랜스크립트 포크 결정 및 포크 생성은 더 이상 storePath 또는 sessionsDir을 허용하지 않으며, 유지된 파일 시스템 경로 메타데이터 대신 {agentId, sessionId} SQLite 트랜스크립트 범위를 사용합니다.
• 메모리 호스트는 더 이상 아무 작업도 하지 않는 세션 디렉터리 트랜스크립트 분류 도우미를 내보내지 않으며, 트랜스크립트 필터링은 이제 항목 구성 중 SQLite 행 메타데이터에서 파생됩니다.
• 메모리 호스트 및 QMD 세션 내보내기 테스트는 SQLite 트랜스크립트 범위를 사용합니다. 기존 agents/<agentId>/sessions/*.jsonl 경로는 테스트에서 의도적으로 Doctor/가져오기/내보내기 호환성을 증명하는 경우에만 계속 다룹니다.
• QA-lab 원시 세션 검사는 이제 agents/qa/sessions/sessions.json을 읽는 대신 Gateway를 통해 sessions.list를 사용합니다. MSteams 피드백은 JSONL 경로를 조작하지 않고 SQLite 트랜스크립트에 직접 추가됩니다.
• 공유 인바운드 채널 턴은 이제 레거시 storePath 대신 {agentId, sessionKey}를 전달합니다. LINE, WhatsApp, Slack, Discord, Telegram, Matrix, Signal, iMessage, BlueBubbles, Feishu, Google Chat, IRC, Nextcloud Talk, Zalo, Zalo Personal, QA Channel, Microsoft Teams, Mattermost, Synology Chat, Tlon, Twitch 및 QQBot 기록 경로는 이제 updated-at 메타데이터를 읽고 SQLite ID를 통해 인바운드 세션 행을 기록합니다.
• 트랜스크립트 로케이터의 영속화가 활성 세션 행에서 제거되었습니다. resolveSessionTranscriptTarget은 agentId, sessionId 및 선택적 토픽 메타데이터를 반환하며, 레거시 트랜스크립트 파일 이름을 가져오는 코드는 doctor뿐입니다.
• 런타임 트랜스크립트 헤더는 SQLite 버전 1부터 시작합니다. 이전 JSONL V1/V2/V3 형식 업그레이드는 doctor 가져오기에만 존재하며, 행을 저장하기 전에 가져온 헤더를 현재 SQLite 트랜스크립트 버전으로 정규화합니다.
• 데이터베이스 우선 가드는 이제 SessionManager.listAll 및 SessionManager.forkFromSession을 금지합니다. 세션 목록 조회와 포크/복원 워크플로는 행/범위 지정 SQLite API만 사용해야 합니다.
• 또한 이 가드는 doctor/가져오기 코드 외부에서 레거시 트랜스크립트 JSONL 구문 분석/활성 브랜치 복구 헬퍼 이름을 금지하므로, 런타임에 두 번째 레거시 트랜스크립트 마이그레이션 경로를 추가할 수 없습니다.
• 임베디드 PI 실행은 수신 트랜스크립트 핸들을 거부합니다. 워커 시작 전과 시도가 트랜스크립트 상태에 접근하기 전에 SQLite {agentId, sessionId} ID를 사용합니다. 오래된 /tmp/*.jsonl 입력은 런타임 쓰기 대상을 선택할 수 없습니다.
• 캐시 추적, Anthropic 페이로드, 원시 스트림 및 진단 타임라인 레코드는 이제 형식이 지정된 SQLite diagnostic_events 행에 기록됩니다. Gateway 안정성 번들은 이제 형식이 지정된 SQLite diagnostic_stability_bundles 행에 기록됩니다. 이전 diagnostics.cacheTrace.filePath, OPENCLAW_CACHE_TRACE_FILE, OPENCLAW_ANTHROPIC_PAYLOAD_LOG_FILE 및 OPENCLAW_DIAGNOSTICS_TIMELINE_PATH JSONL 재정의 경로는 제거되었으며, 일반 안정성 캡처는 더 이상 logs/stability/*.json 파일을 쓰지 않습니다.
• Cron 영속화는 이제 저장할 때마다 전체 작업 테이블을 삭제하고 다시 삽입하는 대신 SQLite cron_jobs 행을 조정합니다. Plugin 대상 쓰기 반영은 일치하는 Cron 행을 직접 업데이트하고 런타임 Cron 상태를 동일한 상태 데이터베이스 트랜잭션에 유지합니다.
• Cron 런타임 호출자는 이제 안정적인 SQLite Cron 저장소 키를 사용합니다. 레거시 cron.store 경로는 doctor 가져오기 입력으로만 사용되며, 프로덕션 Gateway, 작업 유지 관리, 상태, 실행 로그 및 Telegram 대상 쓰기 반영 경로는 resolveCronStoreKey를 사용하고 더 이상 키를 경로 정규화하지 않습니다. 이제 Cron 상태는 이전의 파일 형태 storePath 필드 대신 storeKey를 보고합니다.
• Cron 런타임 로드 및 스케줄링은 더 이상 jobId, schedule.cron, 숫자형 atMs, 문자열 불리언 또는 누락된 sessionTarget 같은 레거시 영속 작업 형식을 정규화하지 않습니다. 행이 SQLite에 삽입되기 전에 doctor 레거시 가져오기가 해당 복구를 담당합니다.
• ACP 스폰은 더 이상 트랜스크립트 JSONL 파일 경로를 확인하거나 영속화하지 않습니다. 스폰 및 스레드 바인딩 설정은 SQLite 세션 행을 직접 영속화하고 세션 ID를 유지되는 트랜스크립트 ID로 보관합니다.
• ACP 세션 메타데이터 API는 이제 agentId별로 SQLite 행을 읽고, 나열하고, 업서트하며, 더 이상 ACP 세션 항목 계약의 일부로 storePath를 노출하지 않습니다.
• 세션 사용량 계산 및 Gateway 사용량 집계는 이제 {agentId, sessionId}로만 트랜스크립트를 확인합니다. 비용/사용량 캐시와 검색된 세션 요약은 더 이상 트랜스크립트 로케이터 문자열을 합성하거나 반환하지 않습니다.
• Gateway 채팅 추가, 중단된 부분 영속화, /sessions.send 및 웹 채팅 미디어 트랜스크립트 쓰기는 SQLite 트랜스크립트 범위를 통해 직접 추가합니다. Gateway 트랜스크립트 삽입 헬퍼는 더 이상 transcriptLocator 매개변수를 받지 않습니다.
• 이제 SQLite 트랜스크립트 검색은 {agentId, sessionId, updatedAt, eventCount}와 같은 트랜스크립트 범위 및 통계만 나열합니다. 사용되지 않는 listSqliteSessionTranscriptLocators 호환성 헬퍼와 행별 locator 필드는 제거되었습니다.
• 이제 트랜스크립트 복구 런타임은 repairTranscriptSessionStateIfNeeded({agentId, sessionId})만 노출합니다. 이전 로케이터 기반 복구 헬퍼는 삭제되었으며, doctor/디버그 코드는 명시적인 원본 파일 경로를 읽고 로케이터 문자열을 절대 마이그레이션하지 않습니다.
• ACP 재생 원장 런타임은 이제 acp/event-ledger.json 대신 공유 SQLite 상태 데이터베이스에 세션별 재생 행을 저장합니다. doctor는 레거시 파일을 가져온 후 제거합니다.
• Gateway 트랜스크립트 리더 헬퍼는 이제 이전 session-utils.fs 모듈 이름 대신 src/gateway/session-transcript-readers.ts에 있습니다. 폴백 재시도 기록 확인의 이름은 이전 파일 헬퍼 표면 대신 SQLite 트랜스크립트 콘텐츠를 기준으로 지정됩니다.
• Gateway의 삽입된 채팅 및 Compaction 헬퍼는 이제 값을 트랜스크립트 경로나 원본 파일로 명명하는 대신 내부 헬퍼 API를 통해 SQLite 트랜스크립트 범위를 전달합니다.
• 이제 부트스트랩 연속성 감지는 hasCompletedBootstrapTranscriptTurn을 통해 SQLite 트랜스크립트 행을 확인하며, 더 이상 파일 형태의 헬퍼 이름을 노출하지 않습니다.
• 임베디드 러너 테스트는 이제 SQLite 트랜스크립트 ID를 사용하며, 새 트랜스크립트 관리자를 열려면 항상 명시적인 sessionId가 필요합니다.
• 메모리 인덱싱 헬퍼는 이제 처음부터 끝까지 SQLite 트랜스크립트 용어를 사용합니다. 호스트는 listSessionTranscriptScopesForAgent와 sessionTranscriptKeyForScope를 내보내고, 대상 지정 동기화는 sessionTranscripts를 대기열에 추가하며, 공개 세션 검색 결과는 불투명한 transcript:<agent>:<session> 경로를 노출하고, 내부 DB 소스 키는 가짜 파일 경로 대신 source_kind='sessions' 아래의 session:<session>입니다.
• 일반 Plugin SDK 영속 중복 제거 헬퍼는 더 이상 파일 형태의 옵션을 노출하지 않습니다. 호출자는 SQLite 범위 키를 제공하며 영구 중복 제거 행은 공유 Plugin 상태에 존재합니다.
• Microsoft Teams SSO 토큰이 잠긴 JSON 파일에서 SQLite Plugin 상태로 이동했습니다. doctor는 msteams-sso-tokens.json을 가져오고 페이로드에서 표준 SSO 토큰 키를 다시 구성한 후 원본 파일을 제거합니다. 위임된 OAuth 토큰은 기존 비공개 자격 증명 파일 경계에 유지됩니다.
• Matrix 동기화 캐시 상태가 bot-storage.json에서 SQLite Plugin 상태로 이동했습니다. doctor는 레거시 원시 또는 래핑된 동기화 페이로드를 가져오고 원본 파일을 제거합니다. 활성 Matrix 및 QA Matrix 클라이언트는 가짜 sync-store.json 또는 bot-storage.json 경로가 아니라 SQLite 동기화 저장소 루트 디렉터리를 전달합니다.
• Matrix 레거시 암호화 마이그레이션 상태가 legacy-crypto-migration.json에서 SQLite Plugin 상태로 이동했습니다. doctor는 이전 상태 파일을 가져오며, Matrix SDK IndexedDB 스냅샷은 crypto-idb-snapshot.json에서 SQLite Plugin 블롭으로 이동했습니다. Matrix 복구 키와 자격 증명은 SQLite Plugin 상태 행이며, 이전 JSON 파일은 doctor 마이그레이션 입력으로만 사용됩니다.
• Memory Wiki 활동 로그는 이제 .openclaw-wiki/log.jsonl 대신 SQLite Plugin 상태를 사용합니다. Memory Wiki 마이그레이션 공급자는 이전 JSONL 로그를 가져오며, 위키 마크다운과 사용자 볼트 콘텐츠는 작업 공간 콘텐츠로서 계속 파일 기반으로 유지됩니다.
• Memory Wiki는 더 이상 .openclaw-wiki/state.json 또는 사용되지 않는 .openclaw-wiki/locks 디렉터리를 생성하지 않습니다. 이전 볼트에 해당 파일이 여전히 있으면 마이그레이션 공급자가 폐기된 Plugin 메타데이터 파일을 제거합니다.
• Crestodian 감사 항목은 이제 audit/crestodian.jsonl 대신 코어 SQLite Plugin 상태를 사용합니다. doctor는 레거시 JSONL 감사 로그를 가져오고 성공적으로 가져온 후 이를 제거합니다.
• 구성 쓰기/관찰 감사 항목은 이제 logs/config-audit.jsonl 대신 코어 SQLite Plugin 상태를 사용합니다. doctor는 레거시 JSONL 감사 로그를 가져오고 성공적으로 가져온 후 이를 제거합니다.
• macOS 컴패니언은 더 이상 openclaw.json을 편집할 때 앱 로컬 logs/config-audit.jsonl 또는 logs/config-health.json 사이드카를 쓰지 않습니다. 구성 파일은 계속 파일 기반으로 유지되고, 복구 스냅샷은 구성 파일 옆에 유지되며, 영구 구성 감사/상태 데이터는 Gateway SQLite 저장소에 속합니다.
• Crestodian 구조 보류 승인은 이제 crestodian/rescue-pending/*.json 대신 코어 SQLite Plugin 상태를 사용합니다. doctor는 레거시 보류 승인 파일을 가져오고 성공적으로 가져온 후 이를 제거합니다.
• Phone Control 임시 활성화 상태는 이제 plugins/phone-control/armed.json 대신 SQLite Plugin 상태를 사용합니다. doctor는 레거시 활성화 상태 파일을 phone-control/arm-state 네임스페이스로 가져오고 해당 파일을 제거합니다.
• doctor는 더 이상 JSONL 트랜스크립트를 제자리에서 복구하거나 백업 JSONL 파일을 생성하지 않습니다. 활성 브랜치를 SQLite로 가져온 후 레거시 원본을 제거합니다.
• 세션 메모리 훅 트랜스크립트 조회는 {agentId, sessionId} 범위 전용 SQLite 읽기를 사용합니다. 해당 헬퍼는 더 이상 트랜스크립트 로케이터, 레거시 파일 읽기 또는 파일 재작성 옵션을 받거나 파생하지 않습니다.
• Codex 앱 서버 대화 바인딩은 이제 OpenClaw 세션 키 또는 명시적인 {agentId, sessionId} 범위를 기준으로 SQLite Plugin 상태에 키를 지정합니다. 트랜스크립트 경로 폴백 바인딩을 유지해서는 안 됩니다.
• Codex 앱 서버 미러링 기록 읽기는 SQLite 트랜스크립트 범위만 사용하며, 트랜스크립트 파일 경로에서 ID를 복구해서는 안 됩니다.
• 역할 순서 지정 및 Compaction 재설정 경로는 더 이상 이전 트랜스크립트 파일의 링크를 해제하지 않습니다. 재설정은 SQLite 세션 행과 트랜스크립트 ID만 교체합니다.
• Gateway 재설정 및 체크포인트 응답은 정리된 세션 행과 세션 ID를 반환합니다. 더 이상 클라이언트용 SQLite 트랜스크립트 로케이터를 합성하지 않습니다.
• memory-core Dreaming은 더 이상 누락된 JSONL 파일을 탐색하여 세션 행을 정리하지 않습니다. 하위 에이전트 정리는 파일 시스템 존재 여부 확인 대신 세션 런타임 API를 통해 수행됩니다. 해당 트랜스크립트 수집 테스트는 agents/<id>/sessions 픽스처 또는 로케이터 자리표시자를 만드는 대신 SQLite 행을 직접 시드합니다.
• 메모리 트랜스크립트 인덱싱은 인용/읽기 헬퍼용 가상 검색 결과 경로로 transcript:<agentId>:<sessionId>를 노출할 수 있습니다. 영구 인덱스 소스는 관계형(source_kind='sessions', source_key='session:<sessionId>', session_id=<sessionId>)이므로 이 값은 런타임 트랜스크립트 로케이터도, 파일 시스템 경로도 아니며 세션 런타임 API에 절대 다시 전달해서는 안 됩니다.
• Gateway doctor 메모리 상태는 memory/.dreams/*.json 대신 SQLite Plugin 상태 행에서 단기 회상 및 단계 신호 개수를 읽습니다. CLI 및 doctor 출력은 이제 해당 저장소를 경로가 아닌 SQLite 저장소로 표시합니다.
• memory-core 런타임, CLI 상태, Gateway doctor 메서드 및 Plugin SDK 퍼사드는 더 이상 레거시 .dreams/session-corpus 파일을 감사하거나 보관하지 않습니다. 해당 파일은 마이그레이션 입력으로만 사용되며, doctor는 이를 SQLite로 가져오고 검증 후 원본을 삭제합니다. 활성 세션 수집 증거 행은 이제 가상 SQLite 경로 memory/session-ingestion/<day>.txt를 사용합니다. 런타임은 .dreams/session-corpus에서 상태를 쓰거나 파생하지 않습니다.
• memory-core 공개 아티팩트는 SQLite 호스트 이벤트를 가상 JSON 아티팩트 memory/events/memory-host-events.json으로 노출하며, 더 이상 레거시 .dreams/events.jsonl 원본 경로를 재사용하지 않습니다.
• 샌드박스 컨테이너/브라우저 레지스트리는 이제 형식이 지정된 세션, 이미지, 타임스탬프, 백엔드/구성 및 브라우저 포트 열이 있는 공유 sandbox_registry_entries SQLite 테이블을 사용합니다. doctor는 레거시 단일 및 샤딩된 JSON 레지스트리 파일을 가져오고 성공적으로 처리된 원본을 제거합니다. 런타임 읽기는 형식이 지정된 행 열을 신뢰할 수 있는 원본으로 사용하며, entry_json은 재생/디버그 복사본일 뿐입니다.
• 커미트먼트는 이제 전체 저장소 JSON 블롭 대신 형식이 지정된 공유 commitments 테이블을 사용합니다. 스냅샷 저장은 커미트먼트 ID별로 업서트하고 테이블을 비운 후 다시 삽입하는 대신 누락된 행만 삭제합니다. 런타임은 형식이 지정된 범위, 전달 기간, 상태, 시도 및 텍스트 열에서 커미트먼트를 로드하며, record_json은 재생/디버그 복사본일 뿐입니다. doctor는 레거시 commitments.json을 가져오고 성공적으로 가져온 후 이를 제거합니다.
• Cron 작업 정의, 스케줄 상태 및 실행 기록에는 더 이상 런타임이 없습니다. JSON 작성기 또는 리더입니다. 런타임은 형식이 지정된 일정, 페이로드, 전달, 실패 알림, 세션, 상태 및 런타임 상태 열이 있는 cron_jobs 행과 상태, 진단 요약, 전달 상태/오류, 세션/실행, 모델 및 토큰 합계에 대한 형식이 지정된 cron_run_logs 메타데이터를 사용합니다. job_json은 재생/디버그 사본일 뿐이며, state_json은 아직 자주 조회되는 필드가 없는 중첩된 런타임 진단을 유지하는 한편, 런타임은 형식이 지정된 열에서 자주 사용되는 상태 필드를 복원합니다. Doctor는 레거시 jobs.json, jobs-state.json 및 runs/*.jsonl 파일을 가져온 후 가져온 원본을 제거합니다. Plugin 대상 쓰기 반영은 전체 Cron 저장소를 로드하여 교체하는 대신 일치하는 cron_jobs 행을 업데이트합니다.
• Gateway 시작 시 런타임 프로젝션의 레거시 notify: true 표시를 무시합니다. cron.webhook이 유효하면 Doctor가 이를 명시적인 SQLite 전달로 변환하고, 설정되지 않았으면 아무 기능도 하지 않는 표시를 제거하며, 구성된 Webhook이 유효하지 않으면 경고와 함께 보존합니다.
• 발신 및 세션 전달 큐는 이제 공유 delivery_queue_entries 테이블에 큐 상태, 항목 종류, 세션 키, 채널, 대상, 계정 ID, 재시도 횟수, 마지막 시도/오류, 복구 상태 및 플랫폼 전송 표시를 형식이 지정된 열로 저장합니다. 런타임 복구는 형식이 지정된 열에서 이러한 자주 사용되는 필드를 읽으며, 재시도/복구 변경은 재생 JSON을 다시 작성하지 않고 해당 열을 직접 업데이트합니다. 전체 JSON 페이로드는 메시지 본문과 그 밖의 자주 사용되지 않는 재생 데이터용 재생/디버그 블롭으로만 유지됩니다.
• 관리되는 발신 이미지 레코드는 이제 형식이 지정된 공유 managed_outgoing_image_records 행을 사용하며, 미디어 바이트는 계속 media_blobs에 저장됩니다. JSON 레코드는 재생/디버그 사본으로만 유지됩니다.
• Discord 모델 선택기 기본 설정, 명령 배포 해시 및 스레드 바인딩은 이제 공유 SQLite Plugin 상태를 사용합니다. 해당 레거시 JSON 가져오기 계획은 코어 마이그레이션 코드가 아니라 Discord Plugin 설정/Doctor 마이그레이션 영역에 있습니다.
• Plugin 레거시 가져오기 감지기는 doctor-legacy-state.ts 또는 doctor-state-imports.ts처럼 Doctor 이름이 지정된 모듈을 사용하며, 일반 채널 런타임 모듈은 레거시 JSON 감지기를 가져오면 안 됩니다.
• BlueBubbles 따라잡기 커서와 인바운드 중복 제거 표시는 이제 공유 SQLite Plugin 상태를 사용합니다. 해당 레거시 JSON 가져오기 계획은 코어 마이그레이션 코드가 아니라 BlueBubbles Plugin 설정/Doctor 마이그레이션 영역에 있습니다.
• Telegram 업데이트 오프셋, 스티커 캐시 행, 전송 메시지 캐시 행, 주제 이름 캐시 행 및 스레드 바인딩은 이제 공유 SQLite Plugin 상태를 사용합니다. 해당 레거시 JSON 가져오기 계획은 코어 마이그레이션 코드가 아니라 Telegram Plugin 설정/Doctor 마이그레이션 영역에 있습니다.
• iMessage 따라잡기 커서, 답장 짧은 ID 매핑 및 전송 에코 중복 제거 행은 이제 공유 SQLite Plugin 상태를 사용합니다. 이전 imessage/catchup/*.json, imessage/reply-cache.jsonl 및 imessage/sent-echoes.jsonl 파일은 Doctor 입력으로만 사용됩니다.
• Feishu 메시지 중복 제거 행은 이제 feishu/dedup/*.json 파일이나 폐기된 수작업 dedup.* 저장소 대신 코어의 선점 가능한 중복 제거 기능(공유 SQLite Plugin 상태의 feishu.dedup.* 네임스페이스)을 사용하며, 재생 방지 캐시는 업그레이드 후 다시 구축되므로 레거시 가져오기를 수행하지 않습니다.
• Microsoft Teams 대화, 설문, 대기 중인 업로드 버퍼 및 피드백 학습 데이터는 이제 공유 SQLite Plugin 상태/블롭 테이블을 사용합니다. 대기 중인 업로드 경로는 plugin_blob_entries를 사용하므로 미디어 버퍼가 base64 JSON 대신 SQLite BLOB으로 저장됩니다. 이제 런타임 도우미 이름에는 *-fs 파일 저장소 명명 대신 SQLite/상태 명명을 사용하며, 이전 storePath 호환용 코드는 이러한 저장소에서 제거되었습니다. 해당 레거시 JSON 가져오기 계획은 Microsoft Teams Plugin 설정/Doctor 마이그레이션 영역에 있습니다.
• Zalo 호스팅 발신 미디어는 이제 openclaw-zalo-outbound-media JSON/bin 임시 사이드카 대신 공유 SQLite plugin_blob_entries를 사용합니다.
• Diffs 뷰어 HTML과 메타데이터는 이제 meta.json/viewer.html 임시 파일 대신 공유 SQLite plugin_blob_entries를 사용합니다. 렌더링된 PNG/PDF 출력은 채널 전달에 여전히 파일 경로가 필요하므로 임시 구체화 상태로 유지됩니다.
• Canvas 관리 문서는 이제 기본 state/canvas/documents 디렉터리 대신 공유 SQLite plugin_blob_entries를 사용합니다. Canvas 호스트는 해당 블롭을 직접 제공하며, 명시적인 host.root 운영자 콘텐츠 또는 다운스트림 미디어 리더에 경로가 필요할 때의 임시 구체화에만 로컬 파일을 생성합니다.
• File Transfer 감사 결정은 이제 무제한 audit/file-transfer.jsonl 런타임 로그 대신 공유 SQLite plugin_state_entries를 사용합니다. Doctor는 레거시 JSONL 감사 파일을 Plugin 상태로 가져오며, 문제없이 가져온 후 원본을 제거합니다.
• ACPX 프로세스 임대와 Gateway 인스턴스 ID는 이제 공유 SQLite Plugin 상태를 사용합니다. Doctor는 레거시 gateway-instance-id 파일을 Plugin 상태로 가져온 후 원본을 제거합니다.
• ACPX가 생성한 래퍼 스크립트와 격리된 Codex 홈은 영구적인 OpenClaw 상태가 아니라 OpenClaw 임시 루트 아래의 임시 구체화입니다. 영구적인 ACPX 런타임 레코드는 SQLite 임대 및 Gateway 인스턴스 행이며, 더 이상 해당 위치에 런타임 상태를 기록하지 않으므로 이전 ACPX stateDir 구성 영역은 제거되었습니다.
• Gateway 미디어 첨부 파일은 이제 공유 media_blobs SQLite 테이블을 표준 바이트 저장소로 사용합니다. 채널 및 샌드박스 호환성 영역에 반환되는 로컬 경로는 영구적인 미디어 저장소가 아니라 데이터베이스 행의 임시 구체화입니다. 런타임 미디어 허용 목록에는 더 이상 레거시 $OPENCLAW_STATE_DIR/media 또는 구성 디렉터리의 media 루트가 포함되지 않으며, 해당 디렉터리는 Doctor 가져오기 원본으로만 사용됩니다.
• 셸 완성은 더 이상 $OPENCLAW_STATE_DIR/completions/* 캐시 파일을 기록하지 않습니다. 설치, Doctor, 업데이트 및 릴리스 스모크 경로는 영구적인 완성 캐시 파일 대신 생성된 완성 출력 또는 프로필 소싱을 사용합니다.
• Gateway Skills 업로드 스테이징은 이제 공유 skill_uploads 행을 사용합니다. 업로드 메타데이터, 멱등성 키 및 아카이브 바이트는 SQLite에 저장되며, 설치 프로그램은 설치가 실행되는 동안에만 임시로 구체화된 아카이브 경로를 받습니다.
• 하위 에이전트 인라인 첨부 파일은 더 이상 작업 공간 .openclaw/attachments/* 아래에 구체화되지 않습니다. 생성 경로는 SQLite VFS 시드 항목을 준비하고, 인라인 실행은 해당 항목을 에이전트별 런타임 스크래치 네임스페이스에 시드하며, 디스크 기반 도구는 첨부 파일 경로에 해당 SQLite 스크래치를 오버레이합니다. 이전 하위 에이전트 실행 첨부 파일 디렉터리 레지스트리 열과 정리 훅은 제거되었습니다.
• CLI 이미지 하이드레이션은 더 이상 안정적인 openclaw-cli-images 캐시 파일을 유지하지 않습니다. 외부 CLI 백엔드는 계속 파일 경로를 받지만, 해당 경로는 정리 기능이 포함된 실행별 임시 구체화입니다.
• 캐시 추적 진단, Anthropic 페이로드 진단, 원시 모델 스트림 진단, 진단 타임라인 이벤트 및 Gateway 안정성 번들은 이제 logs/*.jsonl 또는 logs/stability/*.json 파일 대신 SQLite 행을 기록합니다. 런타임 경로 재정의 플래그와 환경 변수는 제거되었으며, 내보내기/디버그 명령으로 데이터베이스 행에서 파일을 명시적으로 구체화할 수 있습니다.
• macOS 컴패니언에는 더 이상 순환식 diagnostics.jsonl 작성기가 없습니다. 앱 로그는 통합 로깅으로 전송되며, 영구적인 Gateway 진단은 SQLite 기반으로 유지됩니다.
• macOS 포트 가디언 레코드 목록은 이제 Application Support JSON 파일이나 불투명한 싱글턴 블롭 대신 형식이 지정된 공유 SQLite macos_port_guardian_records 행을 사용합니다.
• Gateway 싱글턴 잠금은 이제 임시 디렉터리 잠금 파일 대신 gateway_locks 범위 아래의 형식이 지정된 공유 SQLite state_leases 행을 사용합니다. Fly 및 OAuth 문제 해결 문서는 이제 오래된 파일 잠금 정리 대신 SQLite 임대/인증 갱신 잠금을 안내합니다.
• Gateway 재시작 센티널 상태는 이제 restart-sentinel.json 대신 형식이 지정된 공유 SQLite gateway_restart_sentinel 행을 사용하며, 런타임은 형식이 지정된 열에서 센티널 종류, 상태, 라우팅, 메시지, 계속 정보 및 통계를 읽습니다. payload_json은 재생/디버그 사본일 뿐입니다. 런타임 코드는 SQLite 행을 직접 지우며 더 이상 파일 정리 배관 코드를 포함하지 않습니다.
• Gateway 재시작 의도 및 슈퍼바이저 인계 상태는 이제 gateway-restart-intent.json 및 gateway-supervisor-restart-handoff.json 사이드카 대신 형식이 지정된 공유 SQLite gateway_restart_intent 및 gateway_restart_handoff 행을 사용합니다.
• Gateway 싱글턴 조정은 이제 gateway.<hash>.lock 파일을 기록하는 대신 gateway_locks 아래의 형식이 지정된 state_leases 행을 사용합니다. 임대 행은 잠금 소유자, 만료, Heartbeat 및 디버그 페이로드를 관리하며, SQLite가 원자적 획득/해제 경계를 관리합니다. 폐기된 파일 잠금 디렉터리 옵션은 제거되었으며, 테스트는 SQLite 행 ID를 직접 사용합니다.
• cron/runs/*.jsonl 파일을 검사하던 이전의 참조되지 않는 Cron 사용량 보고서 도우미는 삭제되었습니다. Cron 실행 기록 보고서는 형식이 지정된 cron_run_logs SQLite 행을 읽어야 합니다.
• 기본 세션 재시작 복구는 이제 agents/*/sessions 디렉터리를 검사하는 대신 SQLite agent_databases 레지스트리를 통해 후보 에이전트를 찾습니다.
• Gemini 세션 손상 복구는 이제 SQLite 세션 행만 삭제하며, 더 이상 레거시 storePath 게이트가 필요하지 않고 파생된 트랜스크립트 JSONL 경로의 연결을 해제하려고 시도하지 않습니다.
• 이제 경로 재정의 처리는 리터럴 undefined/null 환경 값을 설정되지 않은 것으로 취급하여 테스트 또는 셸 인계 중 실수로 저장소 루트에 undefined/state/*.sqlite 데이터베이스가 생성되는 것을 방지합니다.
• 구성 상태 지문은 이제 logs/config-health.json 대신 형식이 지정된 공유 SQLite config_health_entries 행을 사용하여 일반 구성 파일을 자격 증명이 아닌 유일한 구성 문서로 유지합니다. macOS 컴패니언은 프로세스 로컬 상태만 유지하며 이전 JSON 사이드카를 다시 생성하지 않습니다.
• 인증 프로필 런타임은 더 이상 자격 증명 JSON 파일을 가져오거나 기록하지 않습니다. 표준 자격 증명 저장소는 SQLite이며, auth-profiles.json, 에이전트별 auth.json 및 공유 credentials/oauth.json은 가져온 후 제거되는 Doctor 마이그레이션 입력입니다.
• 인증 프로필 저장/상태 테스트는 이제 형식이 지정된 SQLite 인증 테이블을 직접 단언하며, 레거시 인증 프로필 파일 이름은 Doctor 마이그레이션 입력에만 사용합니다.
• openclaw secrets apply는 구성 파일, 환경 파일 및 SQLite 인증 프로필 저장소만 정리합니다. 더 이상 폐기된 에이전트별 auth.json을 편집하는 호환성 로직을 포함하지 않으며, 해당 파일의 가져오기와 삭제는 Doctor가 담당합니다.
• Hermes 비밀 마이그레이션은 가져온 API 키 프로필을 SQLite 인증 프로필 저장소에 직접 계획하고 적용합니다. 더 이상 중간 대상으로 auth-profiles.json을 기록하거나 검증하지 않습니다.
• 사용자 대상 인증 문서는 이제 사용자에게 auth-profiles.json을 검사하거나 복사하도록 안내하는 대신 state/openclaw.sqlite#table/auth_profile_stores/<agentDir>를 설명하며, 레거시 OAuth/인증 JSON 이름은 Doctor 가져오기 입력으로만 문서화됩니다.
• 코어 상태 경로 도우미는 더 이상 폐기된 credentials/oauth.json 파일을 노출하지 않습니다. 레거시 파일 이름은 Doctor 인증 가져오기 경로에만 존재합니다.
• 설치, 보안, 온보딩, 모델 인증 및 SecretRef 문서는 이제 에이전트별 인증 프로필 JSON 파일 대신 SQLite 인증 프로필 행과 전체 상태 백업/마이그레이션을 설명합니다.
• PI 모델 검색은 이제 표준 자격 증명을 메모리 내 pi-coding-agent 인증 저장소에 전달합니다. 더 이상 검색 중 에이전트별 auth.json을 생성, 정리 또는 기록하지 않습니다.
• Voice Wake 트리거 및 라우팅 설정은 이제 settings/voicewake.json, settings/voicewake-routing.json 또는 불투명한 일반 행 대신 형식이 지정된 공유 SQLite 테이블을 사용하며, Doctor는 레거시 JSON 파일을 가져온 후 마이그레이션이 성공하면 제거합니다.
• 업데이트 확인 상태는 이제 update-check.json 또는 불투명한 일반 블롭 대신 형식이 지정된 공유 update_check_state 행을 사용하며, Doctor는 레거시 JSON 파일을 가져온 후 마이그레이션이 성공하면 제거합니다.
• 구성 상태는 이제 logs/config-health.json 또는 불투명한 일반 블롭 대신 형식이 지정된 공유 config_health_entries 행을 사용하며, Doctor는 레거시 JSON 파일을 가져온 후 마이그레이션이 성공하면 제거합니다.
• Plugin 대화 바인딩 승인은 이제 형식이 지정된 plugin_binding_approvals 행을 불투명한 공유 SQLite 상태 또는 plugin-binding-approvals.json 대신 사용합니다. 레거시 파일은 doctor 마이그레이션 입력입니다.
• 일반 현재 대화 바인딩은 이제 bindings/current-conversations.json을 다시 작성하는 대신 형식이 지정된 current_conversation_bindings 행을 저장합니다. doctor는 레거시 JSON 파일을 가져오고 마이그레이션에 성공한 후 이를 제거합니다.
• Memory Wiki의 가져온 소스 동기화 원장은 이제 .openclaw-wiki/source-sync.json을 다시 작성하는 대신 볼트/소스 키마다 하나의 SQLite Plugin 상태 행을 저장합니다. 마이그레이션 공급자는 레거시 JSON 원장을 가져온 후 제거합니다.
• Memory Wiki ChatGPT 가져오기 실행 레코드는 이제 .openclaw-wiki/import-runs/*.json에 쓰는 대신 볼트/실행 ID마다 하나의 SQLite Plugin 상태 행을 저장합니다. 롤백 스냅샷은 가져오기 실행 스냅샷 보관이 blob 저장소로 이동될 때까지 명시적인 볼트 파일로 유지됩니다.
• Memory Wiki 컴파일 다이제스트는 이제 .openclaw-wiki/cache/agent-digest.json 및 .openclaw-wiki/cache/claims.jsonl에 쓰는 대신 SQLite Plugin blob 행을 저장합니다. 마이그레이션 공급자는 이전 캐시 파일을 가져오고 캐시 디렉터리가 비면 제거합니다.
• ClawHub Skills 설치 추적은 이제 런타임에 .clawhub/lock.json 및 .clawhub/origin.json 사이드카를 쓰거나 읽는 대신 워크스페이스/Skills마다 하나의 SQLite Plugin 상태 행을 저장합니다. 런타임 코드는 파일 형태의 잠금 파일/출처 추상화 대신 추적된 설치 상태 객체를 사용합니다. Doctor는 구성된 에이전트 워크스페이스에서 레거시 사이드카를 가져오고 정상적으로 가져온 후 제거합니다.
• 설치된 Plugin 인덱스는 이제 plugins/installs.json 대신 형식이 지정된 공유 SQLite installed_plugin_index 싱글턴 행을 읽고 씁니다. 레거시 JSON 파일은 doctor 마이그레이션 입력으로만 사용되며 가져온 후 제거됩니다.
• 레거시 plugins/installs.json 경로 헬퍼는 이제 doctor 레거시 코드에 있습니다. 런타임 Plugin 인덱스 모듈은 JSON 파일 경로가 아니라 SQLite 기반 영속성 옵션만 노출합니다.
• Gateway 재시작 센티널, 재시작 의도 및 감독자 핸드오프 상태는 이제 일반적인 불투명 blob 대신 형식이 지정된 공유 SQLite 행(gateway_restart_sentinel, gateway_restart_intent, gateway_restart_handoff)을 사용합니다. 런타임 재시작 코드에는 파일 형태의 센티널/의도/핸드오프 계약이 없습니다.
• Matrix 동기화 캐시, 저장소 메타데이터, 스레드 바인딩, 인바운드 중복 제거 마커, 시작 검증 쿨다운 상태, SDK IndexedDB 암호화 스냅샷, 자격 증명 및 복구 키는 이제 공유 SQLite Plugin 상태/blob 테이블을 사용합니다. 런타임 경로 구조체는 더 이상 storage-meta.json 메타데이터 경로를 노출하지 않습니다. 해당 파일 이름은 레거시 마이그레이션 입력일 뿐입니다. 이들의 레거시 JSON 가져오기 계획은 Matrix Plugin 설정/doctor 마이그레이션 표면에 있습니다. 인바운드 중복 제거 마커는 코어의 획득 가능한 중복 제거 기능 (공유 상태 DB의 matrix.inbound-dedupe.* 네임스페이스)을 사용합니다. Matrix doctor 상태 마이그레이션은 폐기된 루트별 inbound-dedupe 행과 inbound-dedupe.json을 한 번 가져온 후, 런타임은 획득 가능한 중복 제거 저장소만 읽습니다.
• Matrix 시작 시 더 이상 레거시 Matrix 파일 상태를 스캔하거나 보고하거나 완료하지 않습니다. Matrix 파일 감지, 레거시 암호화 스냅샷 생성, 룸 키 복원 마이그레이션 상태, 가져오기 및 소스 제거는 모두 doctor가 소유합니다.
• Matrix 런타임 마이그레이션 배럴이 제거되었습니다. 레거시 상태/암호화 감지 및 변경 헬퍼는 런타임 API 표면의 일부가 아니라 Matrix doctor에서 직접 가져옵니다.
• Matrix 마이그레이션 스냅샷 재사용 마커는 이제 matrix/migration-snapshot.json 대신 SQLite Plugin 상태에 저장됩니다. doctor는 사이드카 상태 파일을 작성하지 않고도 검증된 동일한 마이그레이션 이전 아카이브를 계속 재사용할 수 있습니다.
• Nostr 버스 커서와 프로필 게시 상태는 이제 공유 SQLite Plugin 상태를 사용합니다. 이들의 레거시 JSON 가져오기 계획은 Nostr Plugin 설정/doctor 마이그레이션 표면에 있습니다.
• Active Memory 세션 토글은 이제 session-toggles.json 대신 공유 SQLite Plugin 상태를 사용합니다. 메모리를 다시 켜면 JSON 객체를 다시 작성하는 대신 해당 행을 삭제합니다.
• Skill Workshop 제안 및 검토 카운터는 이제 워크스페이스별 skill-workshop/<workspace>.json 저장소 대신 공유 SQLite Plugin 상태를 사용합니다. 각 제안은 skill-workshop/proposals 아래의 개별 행이며, 검토 카운터는 skill-workshop/reviews 아래의 개별 행입니다.
• Skill Workshop 검토자 하위 에이전트 실행은 이제 skill-workshop/<sessionId>.json 사이드카 세션 경로를 생성하는 대신 런타임 세션 트랜스크립트 리졸버를 사용합니다.
• ACPX 프로세스 임대는 이제 전체 파일 process-leases.json 레지스트리 대신 acpx/process-leases 아래의 공유 SQLite Plugin 상태를 사용합니다. 각 임대는 자체 행으로 저장되므로 런타임 JSON 재작성 경로 없이도 시작 시 오래된 프로세스를 정리하는 동작이 유지됩니다.
• ACPX 래퍼 스크립트와 격리된 Codex 홈은 OpenClaw 임시 루트에 생성됩니다. 필요할 때 다시 생성되며 백업 또는 마이그레이션 입력이 아닙니다.
• 하위 에이전트 실행 레지스트리 영속성은 형식이 지정된 공유 subagent_runs 행을 사용합니다. 이전 subagents/runs.json 경로는 이제 doctor 마이그레이션 입력일 뿐이며, 런타임 헬퍼 이름은 더 이상 상태 계층을 디스크 기반으로 설명하지 않습니다. 런타임 테스트는 레지스트리 동작을 입증하기 위해 더 이상 유효하지 않거나 비어 있는 runs.json 픽스처를 생성하지 않고 SQLite 행을 직접 시드하고 읽습니다.
• 백업은 보관 전에 상태 디렉터리를 스테이징하고, 데이터베이스가 아닌 파일을 복사하고, VACUUM INTO로 데이터베이스를 스냅샷하며, 활성 WAL/SHM 사이드카를 제외하고, 아카이브 매니페스트에 스냅샷 메타데이터를 기록하며, 완료된 백업 실행을 아카이브 매니페스트와 함께 SQLite에 기록합니다. openclaw backup create는 기본적으로 작성된 아카이브를 검증하며, --no-verify는 명시적인 빠른 경로입니다.
• openclaw backup restore는 압축 해제 전에 아카이브를 검증하고, 검증기의 정규화된 매니페스트를 재사용하며, 검증된 매니페스트 자산을 기록된 소스 경로로 복원합니다. 쓰기 작업에는 --yes가 필요하며 복원 계획을 위한 --dry-run을 지원합니다.
• 이전 백업 휘발성 경로 필터가 삭제되었습니다. 아카이브 생성 전에 SQLite 스냅샷이 스테이징되므로 백업에는 더 이상 레거시 세션 또는 Cron JSON/JSONL 파일을 위한 활성 tar 건너뛰기 목록이 필요하지 않습니다.
• 일반 설정 및 온보딩 워크스페이스 준비는 더 이상 agents/<agentId>/sessions/ 디렉터리를 생성하지 않습니다. 구성/워크스페이스만 생성하며, SQLite 세션 행과 트랜스크립트 행은 에이전트별 데이터베이스에 필요할 때 생성됩니다.
• 보안 권한 복구는 이제 sessions.json 및 트랜스크립트 JSONL 파일 대신 전역 및 에이전트별 SQLite 데이터베이스와 WAL/SHM 사이드카를 대상으로 합니다.
• 샌드박스 레지스트리 런타임 이름은 이제 활성 저장소에 레거시 JSON 레지스트리 용어를 유지하지 않고 SQLite 레지스트리 종류를 직접 설명합니다.
• openclaw reset --scope config+creds+sessions는 레거시 sessions/ 디렉터리뿐만 아니라 에이전트별 openclaw-agent.sqlite 데이터베이스와 WAL/SHM 사이드카도 제거합니다.
• Gateway 집계 세션 헬퍼는 이제 항목 중심 이름을 사용합니다. loadCombinedSessionEntriesForGateway는 { databasePath, entries }를 반환합니다. 이전 결합 저장소 명명은 런타임 호출자에서 제거되었습니다.
• Docker MCP 채널 시딩은 이제 sessions.json과 JSONL 트랜스크립트를 생성하는 대신 기본 세션 행과 트랜스크립트 이벤트를 에이전트별 SQLite 데이터베이스에 씁니다.
• 번들 세션 메모리 훅은 이제 {agentId, sessionId}를 사용해 SQLite에서 이전 세션 컨텍스트를 확인합니다. 더 이상 트랜스크립트 경로나 workspace/sessions 디렉터리를 스캔하거나 저장하거나 합성하지 않습니다.
• 번들 명령 로거 훅은 이제 logs/commands.log에 추가하는 대신 공유 SQLite command_log_entries 테이블에 명령 감사 행을 씁니다.
• 채널 페어링 허용 목록은 이제 런타임과 Plugin SDK에서 SQLite 기반 읽기/쓰기 헬퍼만 노출합니다. 이전 *-allowFrom.json 경로 리졸버와 파일 리더는 doctor 레거시 가져오기 코드 아래에만 있습니다.
• migration_runs는 상태, 타임스탬프 및 JSON 보고서와 함께 레거시 상태 마이그레이션 실행을 기록합니다.
• migration_sources는 가져온 각 레거시 파일 소스를 해시, 크기, 레코드 수, 대상 테이블, 실행 ID, 상태 및 소스 제거 상태와 함께 기록합니다.
• backup_runs는 백업 아카이브 경로, 상태 및 JSON 매니페스트를 기록합니다.
• 전역 스키마는 사용되지 않는 agents 레지스트리 테이블을 유지하지 않습니다. 런타임에 실제 에이전트 레코드 소유자가 생길 때까지 에이전트 데이터베이스 검색에는 agent_databases 레지스트리가 정식 기준입니다.
• 생성된 모델 카탈로그 구성은 에이전트 디렉터리를 키로 하는 형식이 지정된 전역 SQLite agent_model_catalogs 행에 저장됩니다. 런타임 호출자는 ensureOpenClawModelCatalog를 사용하며 런타임 코드에는 models.json 호환성 API가 없습니다. 구현은 SQLite에 쓰고, 내장 PI 레지스트리는 models.json 파일을 생성하지 않은 채 저장된 페이로드에서 하이드레이션됩니다.
• QMD 세션 트랜스크립트 마크다운 내보내기와 memory.qmd.sessions 구성이 제거되었습니다. QMD 트랜스크립트 컬렉션, qmd/sessions* 런타임 경로 및 파일 기반 세션 메모리 브리지가 존재하지 않습니다.
• memory-core 런타임은 QMD SDK 하위 경로가 아니라 openclaw/plugin-sdk/memory-core-host-engine-session-transcripts에서 SQLite 트랜스크립트 인덱싱 헬퍼를 가져옵니다. QMD 하위 경로는 주요 SDK 정리에서 제거할 수 있을 때까지 외부 호출자를 위한 호환성 재내보내기만 유지합니다.
• QMD 자체의 index.sqlite는 이제 기본 SQLite plugin_blob_entries 테이블이 뒷받침하는 임시 런타임 구체화입니다. 런타임은 더 이상 영구적인 ~/.openclaw/agents/<agentId>/qmd 사이드카를 생성하지 않습니다.
• 선택적 memory-lancedb Plugin은 더 이상 ~/.openclaw/memory/lancedb를 암시적인 OpenClaw 관리 저장소로 생성하지 않습니다. 이는 외부 LanceDB 백엔드이며 운영자가 명시적인 dbPath를 구성할 때까지 비활성화된 상태로 유지됩니다.
• check:database-first-legacy-stores는 레거시 저장소 이름을 쓰기 형태의 파일 시스템 API와 함께 사용하는 새로운 런타임 소스에 실패합니다. 또한 폐기된 트랜스크립트 브리지 마커 transcriptLocator 또는 sqlite-transcript://...를 다시 도입하는 런타임 소스에도 실패합니다. 마이그레이션, doctor, 가져오기 및 명시적인 비세션 내보내기 코드는 계속 허용됩니다. sessionFile, storePath 및 파일 시대의 이전 SessionManager 퍼사드와 같은 더 광범위한 레거시 계약 이름에는 여전히 현재 소유자가 있으며, 필수 사전 검사로 만들기 전에 별도의 마이그레이션 가드 작업이 필요합니다. 이제 이 가드는 런타임 cache/*.json 저장소, 일반 thread-bindings.json 사이드카, Cron 상태/실행 로그 JSON, 구성 상태 JSON, 재시작 및 잠금 사이드카, Voice Wake 설정, Plugin 바인딩 승인, 설치된 Plugin 인덱스 JSON, File Transfer 감사 JSONL, Memory Wiki 활동 로그, 이전 번들 command-logger 텍스트 로그 및 pi-mono 원시 스트림 JSONL 진단 설정도 포괄합니다. 또한 호환성 코드가 src/commands/doctor/ 아래에 유지되도록 이전 루트 수준 doctor 레거시 모듈 이름을 금지합니다. Android 디버그 핸들러도 camera_debug.log 또는 debug_logs.txt 캐시 파일을 스테이징하는 대신 logcat/인메모리 출력을 사용합니다.

대상 스키마 형태

스키마는 명시적으로 유지하십시오. 호스트 소유 런타임 상태에는 형식이 지정된 테이블을 사용합니다. Plugin 소유 불투명 상태에는 plugin_state_entries / plugin_blob_entries를 사용하며, 범용 호스트 kv 테이블은 없습니다.

전역 데이터베이스:

state_leases(scope, lease_key, owner, expires_at, heartbeat_at, payload_json, created_at, updated_at)exec_approvals_config(config_key, raw_json, socket_path, has_socket_token, default_security, default_ask, default_ask_fallback, auto_allow_skills, agent_count, allowlist_count, updated_at_ms)schema_meta(meta_key, role, schema_version, agent_id, app_version, created_at, updated_at)agent_databases(agent_id, path, schema_version, last_seen_at, size_bytes)task_runs(...)task_delivery_state(...)flow_runs(...)subagent_runs(run_id, child_session_key, requester_session_key, controller_session_key, created_at, ended_at, cleanup_handled, payload_json)current_conversation_bindings(binding_key, binding_id, target_agent_id, target_session_id, target_session_key, channel, account_id, conversation_kind, parent_conversation_id, conversation_id, target_kind, status, bound_at, expires_at, metadata_json, updated_at)plugin_binding_approvals(plugin_root, channel, account_id, plugin_id, plugin_name, approved_at)tui_last_sessions(scope_key, session_key, updated_at)plugin_state_entries(plugin_id, namespace, entry_key, value_json, created_at, expires_at)plugin_blob_entries(plugin_id, namespace, entry_key, metadata_json, blob, created_at, expires_at)media_blobs(subdir, id, content_type, size_bytes, blob, created_at, updated_at)skill_uploads(upload_id, kind, slug, force, size_bytes, sha256, actual_sha256, received_bytes, archive_blob, created_at, expires_at, committed, committed_at, idempotency_key_hash)web_push_subscriptions(endpoint_hash, subscription_id, endpoint, p256dh, auth, created_at_ms, updated_at_ms)web_push_vapid_keys(key_id, public_key, private_key, subject, updated_at_ms)apns_registrations(node_id, transport, token, relay_handle, send_grant, installation_id, topic, environment, distribution, token_debug_suffix, updated_at_ms)node_host_config(config_key, version, node_id, token, display_name, gateway_host, gateway_port, gateway_tls, gateway_tls_fingerprint, updated_at_ms)device_identities(identity_key, device_id, public_key_pem, private_key_pem, created_at_ms, updated_at_ms)device_auth_tokens(device_id, role, token, scopes_json, updated_at_ms)macos_port_guardian_records(pid, port, command, mode, timestamp)workspace_setup_state(workspace_key, workspace_path, version, bootstrap_seeded_at, setup_completed_at, updated_at)native_hook_relay_bridges(relay_id, pid, hostname, port, token, expires_at_ms, updated_at_ms)model_capability_cache(provider_id, model_id, name, input_text, input_image, reasoning, supports_tools, context_window, max_tokens, cost_input, cost_output, cost_cache_read, cost_cache_write, updated_at_ms)agent_model_catalogs(catalog_key, agent_dir, raw_json, updated_at)managed_outgoing_image_records(attachment_id, session_key, message_id, created_at, updated_at, retention_class, alt, original_media_id, original_media_subdir, original_content_type, original_width, original_height, original_size_bytes, original_filename, record_json)gateway_restart_sentinel(sentinel_key, version, kind, status, ts, session_key, thread_id, delivery_channel, delivery_to, delivery_account_id, message, continuation_json, doctor_hint, stats_json, payload_json, updated_at_ms)channel_pairing_requests(channel_key, account_id, request_id, code, created_at, last_seen_at, meta_json)channel_pairing_allow_entries(channel_key, account_id, entry, sort_order, updated_at)voicewake_triggers(config_key, position, trigger, updated_at_ms)voicewake_routing_config(config_key, version, default_target_mode, default_target_agent_id, default_target_session_key, updated_at_ms)voicewake_routing_routes(config_key, position, trigger, target_mode, target_agent_id, target_session_key, updated_at_ms)update_check_state(state_key, last_checked_at, last_notified_version, last_notified_tag, last_available_version, last_available_tag, auto_install_id, auto_first_seen_version, auto_first_seen_tag, auto_first_seen_at, auto_last_attempt_version, auto_last_attempt_at, auto_last_success_version, auto_last_success_at, updated_at_ms)config_health_entries(config_path, last_known_good_json, last_promoted_good_json, last_observed_suspicious_signature, updated_at_ms)sandbox_registry_entries(registry_kind, container_name, session_key, backend_id, runtime_label, image, created_at_ms, last_used_at_ms, config_label_kind, config_hash, cdp_port, no_vnc_port, entry_json, updated_at)cron_run_logs(store_key, job_id, seq, ts, status, error, summary, diagnostics_summary, delivery_status, delivery_error, delivered, session_id, session_key, run_id, run_at_ms, duration_ms, next_run_at_ms, model, provider, total_tokens, entry_json, created_at)cron_jobs(store_key, job_id, name, description, enabled, delete_after_run, created_at_ms, agent_id, session_key, schedule_kind, schedule_expr, schedule_tz, every_ms, anchor_ms, at, stagger_ms, session_target, wake_mode, payload_kind, payload_message, payload_model, payload_fallbacks_json, payload_thinking, payload_timeout_seconds, payload_allow_unsafe_external_content, payload_external_content_source_json, payload_light_context, payload_tools_allow_json, delivery_mode, delivery_channel, delivery_to, delivery_thread_id, delivery_account_id, delivery_best_effort, failure_delivery_mode, failure_delivery_channel, failure_delivery_to, failure_delivery_account_id, failure_alert_disabled, failure_alert_after, failure_alert_channel, failure_alert_to, failure_alert_cooldown_ms, failure_alert_include_skipped, failure_alert_mode, failure_alert_account_id, next_run_at_ms, running_at_ms, last_run_at_ms, last_run_status, last_error, last_duration_ms, consecutive_errors, consecutive_skipped, schedule_error_count, last_delivery_status, last_delivery_error, last_delivered, last_failure_alert_at_ms, job_json, state_json, runtime_updated_at_ms, schedule_identity, sort_order, updated_at)delivery_queue_entries(queue_name, id, status, entry_kind, session_key, channel, target, account_id, retry_count, last_attempt_at, last_error, recovery_state, platform_send_started_at, entry_json, enqueued_at, updated_at, failed_at)commitments(id, agent_id, session_key, channel, account_id, recipient_id, thread_id, sender_id, kind, sensitivity, source, status, reason, suggested_text, dedupe_key, confidence, due_earliest_ms, due_latest_ms, due_timezone, source_message_id, source_run_id, created_at_ms, updated_at_ms, attempts, last_attempt_at_ms, sent_at_ms, dismissed_at_ms, snoozed_until_ms, expired_at_ms, record_json)migration_runs(id, started_at, finished_at, status, report_json)migration_sources(source_key, migration_kind, source_path, target_table, source_sha256, source_size_bytes, source_record_count, last_run_id, status, imported_at, removed_source, report_json)backup_runs(id, created_at, archive_path, status, manifest_json)

에이전트 데이터베이스:

schema_meta(meta_key, role, schema_version, agent_id, app_version, created_at, updated_at)sessions(session_id, session_key, session_scope, created_at, updated_at, started_at, ended_at, status, chat_type, channel, account_id, primary_conversation_id, model_provider, model, agent_harness_id, parent_session_key, spawned_by, display_name)conversations(conversation_id, channel, account_id, kind, peer_id, parent_conversation_id, thread_id, native_channel_id, native_direct_user_id, label, metadata_json, created_at, updated_at)session_conversations(session_id, conversation_id, role, first_seen_at, last_seen_at)session_routes(session_key, session_id, updated_at)session_entries(session_id, session_key, entry_json, updated_at)transcript_events(session_id, seq, event_json, created_at)transcript_event_identities(session_id, event_id, seq, event_type, has_parent, parent_id, message_idempotency_key, created_at)transcript_snapshots(session_id, snapshot_id, reason, event_count, created_at, metadata_json)vfs_entries(namespace, path, kind, content_blob, metadata_json, updated_at)tool_artifacts(run_id, artifact_id, kind, metadata_json, blob, created_at)run_artifacts(run_id, path, kind, metadata_json, blob, created_at)trajectory_runtime_events(session_id, run_id, seq, event_json, created_at)memory_index_meta(key, value)memory_index_sources(id, path, source, hash, mtime, size)memory_index_chunks(id, path, source, start_line, end_line, hash, model, text, embedding, updated_at)memory_embedding_cache(provider, model, provider_key, hash, embedding, dims, updated_at)memory_index_state(id, revision)cache_entries(scope, key, value_json, blob, expires_at, updated_at)

memory_index_sources.id는 안정적인 정수 기본 키이며, (path, source)는 고유하게 유지됩니다.

향후 검색 기능은 정규 이벤트 테이블을 변경하지 않고 FTS 테이블을 추가할 수 있습니다.

transcript_events_fts(session_id, seq, text)vfs_entries_fts(namespace, path, text)

큰 값에는 JSON 문자열 인코딩이 아니라 blob 열을 사용해야 합니다. 일반 SQLite 도구로 검사할 수 있어야 하는 작은 구조화 데이터에는 value_json을 유지하십시오.

agent_databases는 이 브랜치의 정규 레지스트리입니다. 실제 에이전트 레코드 소유자가 생길 때까지 agents 테이블을 추가하지 마십시오. 에이전트 구성은 openclaw.json에 유지됩니다.

Doctor 마이그레이션 형태

Doctor는 보고할 수 있고 안전하게 재실행할 수 있는 하나의 명시적인 마이그레이션 단계를 호출해야 합니다.

openclaw doctor --fix

openclaw doctor --fix는 일반적인 구성 사전 점검 후 상태 마이그레이션 구현을 호출하고 가져오기 전에 검증된 백업을 생성합니다. 런타임 시작 및 openclaw migrate는 레거시 OpenClaw 상태 파일을 가져와서는 안 됩니다.

마이그레이션 속성:

• 하나의 마이그레이션 과정에서 모든 레거시 파일 소스를 검색하고, 변경을 수행하기 전에 계획을 생성합니다.
• Doctor는 레거시 파일을 가져오기 전에 검증된 마이그레이션 전 백업 아카이브를 생성합니다.
• 가져오기는 멱등성을 가지며 소스 경로, mtime, 크기, 해시 및 대상 테이블을 키로 사용합니다.
• 대상 데이터베이스의 커밋이 완료된 후 성공적으로 처리된 소스 파일을 제거하거나 보관합니다.
• 가져오기에 실패하면 소스를 그대로 두고 migration_runs에 경고를 기록합니다.
• 마이그레이션이 존재한 이후 런타임 코드는 SQLite만 읽습니다.
• 다운그레이드/런타임 파일로 내보내기 경로는 필요하지 않습니다.

마이그레이션 목록

다음을 전역 데이터베이스로 이동하십시오:

• 작업 레지스트리 런타임 쓰기는 이제 공유 데이터베이스를 사용하며, 출시되지 않은 tasks/runs.sqlite 사이드카 가져오기 도구는 삭제되었습니다. 스냅샷 저장은 작업 id를 기준으로 upsert하고 누락된 작업/전달 행만 삭제합니다.
• Task Flow 런타임 쓰기는 이제 공유 데이터베이스를 사용하며, 출시되지 않은 tasks/flows/registry.sqlite 사이드카 가져오기 도구는 삭제되었습니다. 스냅샷 저장은 흐름 id를 기준으로 upsert하고 누락된 흐름 행만 삭제합니다.
• Plugin 상태 런타임 쓰기는 이제 공유 데이터베이스를 사용하며, 출시되지 않은 plugin-state/state.sqlite 사이드카 가져오기 도구는 삭제되었습니다.
• 기본 제공 메모리 검색은 더 이상 memory/<agentId>.sqlite를 기본값으로 사용하지 않습니다. 해당 인덱스 테이블은 소유 에이전트 데이터베이스에 있으며, 명시적인 memorySearch.store.path 사이드카 선택 사용은 doctor 구성 마이그레이션으로 이전되었습니다.
• 기본 제공 메모리 재인덱싱은 에이전트 데이터베이스에서 메모리가 소유한 테이블만 재설정합니다. 동일한 데이터베이스가 세션, 트랜스크립트, VFS 행, 아티팩트 및 런타임 캐시를 소유하므로 전체 SQLite 파일을 교체해서는 안 됩니다.
• 단일 및 샤딩된 JSON의 샌드박스 컨테이너/브라우저 레지스트리입니다. 런타임 쓰기는 이제 공유 데이터베이스를 사용하며, 레거시 JSON 가져오기는 유지됩니다.
• Cron 작업 정의, 일정 상태 및 실행 기록은 이제 공유 SQLite를 사용하며, doctor는 레거시 jobs.json, jobs-state.json 및 cron/runs/*.jsonl 파일을 가져온 후 제거합니다.
• 기기 ID/인증, 푸시, 업데이트 확인, 커밋먼트, OpenRouter 모델 캐시, 설치된 Plugin 인덱스 및 앱 서버 바인딩
• 기기/Node 페어링 및 부트스트랩 레코드는 이제 형식화된 SQLite 테이블을 사용합니다.
• 기기 페어링 알림 구독자와 전달된 요청 마커는 이제 device-pair-notify.json 대신 공유 SQLite Plugin 상태 테이블을 사용합니다.
• 음성 통화 기록은 이제 calls.jsonl 대신 voice-call / calls 네임스페이스 아래의 공유 SQLite Plugin 상태 테이블을 사용하며, Plugin CLI는 SQLite 기반 통화 기록을 추적하고 요약합니다.
• QQBot Gateway 세션, 알려진 사용자 레코드 및 참조 인덱스 인용 캐시는 이제 session-*.json, known-users.json 및 ref-index.jsonl 대신 qqbot 네임스페이스(gateway-sessions, known-users, ref-index) 아래의 SQLite Plugin 상태를 사용합니다. 이러한 레거시 파일은 캐시이며 마이그레이션되지 않습니다.
• Discord 모델 선택기 기본 설정, 명령 배포 해시 및 스레드 바인딩은 이제 model-picker-preferences.json, command-deploy-cache.json 및 thread-bindings.json 대신 discord 네임스페이스 (model-picker-preferences, command-deploy-hashes, thread-bindings) 아래의 SQLite Plugin 상태를 사용하며, Discord doctor/설정 마이그레이션은 레거시 파일을 가져온 후 제거합니다.
• BlueBubbles 따라잡기 커서와 인바운드 중복 제거 마커는 이제 bluebubbles/catchup/*.json 및 bluebubbles/inbound-dedupe/*.json 대신 bluebubbles 네임스페이스 (catchup-cursors, inbound-dedupe) 아래의 SQLite Plugin 상태를 사용하며, BlueBubbles doctor/설정 마이그레이션은 레거시 파일을 가져온 후 제거합니다.
• Telegram 업데이트 오프셋, 스티커 캐시 항목, 응답 체인 메시지 캐시 항목, 전송된 메시지 캐시 항목, 주제 이름 캐시 항목 및 스레드 바인딩은 이제 update-offset-*.json, sticker-cache.json, *.telegram-messages.json, *.telegram-sent-messages.json, *.telegram-topic-names.json 및 thread-bindings-*.json 대신 telegram 네임스페이스 (update-offsets, sticker-cache, message-cache, sent-messages, topic-names, thread-bindings) 아래의 SQLite Plugin 상태를 사용하며, Telegram doctor/설정 마이그레이션은 레거시 파일을 가져온 후 제거합니다.
• iMessage 따라잡기 커서, 응답 단축 id 매핑 및 전송 에코 중복 제거 행은 이제 imessage/catchup/*.json, imessage/reply-cache.jsonl 및 imessage/sent-echoes.jsonl 대신 imessage 네임스페이스(catchup-cursors, reply-cache, sent-echoes) 아래의 SQLite Plugin 상태를 사용하며, iMessage doctor/설정 마이그레이션은 레거시 파일을 가져온 후 제거합니다.
• Microsoft Teams 대화, 설문, SSO 토큰 및 피드백 학습 내용은 이제 msteams-conversations.json, msteams-polls.json, msteams-sso-tokens.json 및 *.learnings.json 대신 SQLite Plugin 상태 네임스페이스(conversations, polls, sso-tokens, feedback-learnings)를 사용하며, Microsoft Teams doctor/설정 마이그레이션은 레거시 파일을 가져온 후 보관합니다. 보류 중인 업로드는 단기 SQLite 캐시이며 이전 JSON 캐시 파일은 마이그레이션되지 않습니다.
• Matrix 동기화 캐시, 스토리지 메타데이터, 스레드 바인딩, 인바운드 중복 제거 마커, 시작 검증 쿨다운 상태, 자격 증명, 복구 키 및 SDK IndexedDB 암호화 스냅샷은 이제 bot-storage.json, storage-meta.json, thread-bindings.json, inbound-dedupe.json, startup-verification.json, credentials.json, recovery-key.json 및 crypto-idb-snapshot.json 대신 matrix 아래의 SQLite Plugin 상태/블롭 네임스페이스 (sync-store, storage-meta, thread-bindings, 코어의 소유권 획득 가능 중복 제거를 통한 matrix.inbound-dedupe.*, startup-verification, credentials, recovery-key, idb-snapshots)를 사용하며, Matrix doctor/설정 마이그레이션은 계정 범위 Matrix 스토리지 루트에서 해당 레거시 파일과 사용이 중단된 루트별 inbound-dedupe SQLite 행을 가져온 후 제거합니다.
• Nostr 버스 커서와 프로필 게시 상태는 이제 bus-state-*.json 및 profile-state-*.json 대신 nostr 네임스페이스 (bus-state, profile-state) 아래의 SQLite Plugin 상태를 사용하며, Nostr doctor/설정 마이그레이션은 레거시 파일을 가져온 후 제거합니다.
• Active Memory 세션 토글은 이제 session-toggles.json 대신 active-memory/session-toggles 아래의 SQLite Plugin 상태를 사용합니다.
• Skill Workshop 제안 큐 및 검토 카운터는 이제 작업 공간별 skill-workshop/<workspace>.json 파일 대신 skill-workshop/proposals 및 skill-workshop/reviews 아래의 SQLite Plugin 상태를 사용합니다.
• 아웃바운드 전달 및 세션 전달 큐는 이제 영구 delivery-queue/*.json, delivery-queue/failed/*.json 및 session-delivery-queue/*.json 파일 대신 별도의 큐 이름 (outbound-delivery, session-delivery)으로 전역 SQLite delivery_queue_entries 테이블을 공유합니다. doctor 레거시 상태 단계는 보류 및 실패 행을 가져오고, 오래된 전달 완료 마커를 제거하며, 가져오기 후 이전 JSON 파일을 삭제합니다. 핫 라우팅 및 재시도 필드는 형식화된 열이며, JSON 페이로드는 재생/디버깅 용도로만 유지됩니다.
• ACPX 프로세스 임대는 이제 process-leases.json 대신 acpx/process-leases 아래의 SQLite Plugin 상태를 사용합니다.
• 백업 및 마이그레이션 실행 메타데이터

다음 항목을 에이전트 데이터베이스로 이동합니다.

• 에이전트 세션 루트 및 호환성 형식의 세션 항목 페이로드입니다. 런타임 쓰기에 대해 완료되었습니다. 핫 세션 메타데이터는 sessions에서 쿼리할 수 있으며, 레거시 형식의 전체 SessionEntry 페이로드는 session_entries에 유지됩니다.
• 에이전트 트랜스크립트 이벤트입니다. 런타임 쓰기에 대해 완료되었습니다.
• Compaction 체크포인트 및 트랜스크립트 스냅샷입니다. 런타임 쓰기에 대해 완료되었습니다. 체크포인트 트랜스크립트 복사본은 SQLite 트랜스크립트 행이며 체크포인트 메타데이터는 transcript_snapshots에 기록됩니다. Gateway 체크포인트 도우미는 이제 이러한 값을 소스 파일이 아닌 트랜스크립트 스냅샷으로 명명합니다.
• 에이전트 VFS 스크래치/작업 공간 네임스페이스입니다. 런타임 VFS 쓰기에 대해 완료되었습니다.
• 하위 에이전트 첨부 파일 페이로드입니다. 런타임 쓰기에 대해 완료되었습니다. 이는 SQLite VFS 시드 항목이며 영구 작업 공간 파일이 아닙니다.
• 도구 아티팩트입니다. 런타임 쓰기에 대해 완료되었습니다.
• 실행 아티팩트입니다. 에이전트별 run_artifacts 테이블을 통한 작업자 런타임 쓰기에 대해 완료되었습니다.
• 에이전트 로컬 런타임 캐시입니다. 에이전트별 cache_entries 테이블을 통한 작업자 런타임 범위 캐시 쓰기에 대해 완료되었습니다. Gateway 전체 모델 캐시는 에이전트별로 전환되지 않는 한 전역 데이터베이스에 유지됩니다.
• ACP 상위 스트림 로그입니다. 런타임 쓰기에 대해 완료되었습니다.
• ACP 재생 원장 세션입니다. acp_replay_sessions 및 acp_replay_events를 통한 런타임 쓰기에 대해 완료되었으며, 레거시 acp/event-ledger.json은 doctor 입력으로만 유지됩니다.
• ACP 세션 메타데이터입니다. acp_sessions를 통한 런타임 쓰기에 대해 완료되었으며, sessions.json의 레거시 entry.acp 블록은 doctor 마이그레이션 입력으로만 사용됩니다.
• 명시적 내보내기 파일이 아닌 궤적 사이드카입니다. 런타임 쓰기에 대해 완료되었습니다. 궤적 캡처는 에이전트 데이터베이스의 trajectory_runtime_events 행을 쓰고 실행 범위 아티팩트를 SQLite에 미러링합니다. 레거시 사이드카는 doctor 가져오기 입력으로만 사용됩니다. 내보내기는 새로운 JSONL 지원 번들 출력을 구체화할 수 있지만 런타임에서 이전 궤적/트랜스크립트 사이드카를 읽거나 마이그레이션하지 않습니다. 런타임 궤적 캡처는 SQLite 범위를 노출하며, JSONL 경로 도우미는 내보내기/디버그 지원으로 격리되고 런타임 모듈에서 다시 내보내지지 않습니다. 임베디드 러너 궤적 메타데이터는 트랜스크립트 로케이터를 유지하는 대신 {agentId, sessionId, sessionKey} ID를 기록합니다.

다음 항목은 현재 파일 기반으로 유지합니다.

• openclaw.json
• 공급자 또는 CLI 자격 증명 파일
• Plugin/패키지 매니페스트
• 디스크 모드가 선택된 경우 사용자 작업 공간 및 Git 리포지토리
• 특정 로그 영역을 이동하지 않는 한 운영자 추적용 로그

마이그레이션 계획

0단계: 경계 동결

더 많은 행을 이동하기 전에 영구 상태 경계를 명시적으로 지정합니다.

• 전역 데이터베이스에 migration_runs 테이블을 추가합니다. 레거시 상태 마이그레이션 실행 보고서에 대해 완료되었습니다.
• 파일에서 데이터베이스로 가져오기 위한 단일 doctor 소유 상태 마이그레이션 서비스를 추가합니다. 완료되었습니다. openclaw doctor --fix는 레거시 상태 마이그레이션 구현을 사용합니다.
• plan을 읽기 전용으로 만들고 apply가 백업을 생성하고 가져오고 검증한 다음 이전 파일을 삭제하거나 격리하도록 합니다. 완료되었습니다. doctor는 검증된 마이그레이션 전 백업을 생성하고, 백업 경로를 migration_runs에 전달하며, 가져오기 도구/제거 경로를 재사용합니다.
• 새 런타임 코드가 레거시 상태 파일에 쓸 수 없도록 정적 금지를 추가하면서 마이그레이션 코드와 테스트에서는 계속 해당 파일을 시드하고 읽을 수 있도록 합니다. 현재 마이그레이션된 레거시 저장소에 대해 완료되었습니다. 이 가드는 금지된 런타임 트랜스크립트 로케이터 계약을 찾기 위해 중첩된 테스트도 검사합니다.

1단계: 전역 제어 영역 완성

공유 조정 상태를 state/openclaw.sqlite에 유지합니다.

• 에이전트 및 에이전트 데이터베이스 레지스트리
• 작업 및 Task Flow 원장
• Plugin 상태
• 샌드박스 컨테이너/브라우저 레지스트리
• Cron/스케줄러 실행 기록
• 페어링, 기기, 푸시, 업데이트 확인, TUI, OpenRouter/모델 캐시 및 기타 소규모 Gateway 범위 런타임 상태
• 백업 및 마이그레이션 메타데이터
• Gateway 미디어 첨부 파일 바이트입니다. 런타임 쓰기에 대해 완료되었습니다. 직접 파일 경로는 채널 발신자 및 샌드박스 스테이징과의 호환성을 위한 임시 구체화입니다. 런타임 허용 목록은 레거시 상태/구성 미디어 루트가 아닌 SQLite 구체화 경로를 허용합니다. doctor는 레거시 미디어 파일을 media_blobs로 가져오고 행 쓰기가 성공한 후 소스 파일을 제거합니다.
• 디버그 프록시 캡처 세션, 이벤트 및 페이로드 블롭입니다. 완료되었습니다. 캡처는 공유 상태 DB에 있으며 공유 상태 DB 부트스트랩, 스키마, WAL 및 사용 중 시간 제한 설정을 통해 열립니다. 페이로드 바이트는 capture_blobs.data에서 gzip으로 압축됩니다. 디버그 프록시 런타임 사이드카 DB 재정의, 블롭 디렉터리 또는 프록시 캡처 전용 생성 스키마/코드 생성 대상은 없습니다. doctor/시작 마이그레이션은 활성 레거시 DB/블롭 환경 재정의를 포함하여 출시된 debug-proxy/capture.sqlite 행과 참조된 페이로드 블롭을 가져온 후, CA 인증서는 그대로 두고 해당 소스를 보관합니다.

이 단계에서는 해당 하위 시스템의 중복 사이드카 오프너, 권한 도우미, WAL 설정, 파일 시스템 정리 및 호환성 작성기도 삭제합니다.

2단계: 에이전트별 데이터베이스 도입

에이전트마다 하나의 데이터베이스를 만들고 전역 DB에서 등록합니다.

~/.openclaw/state/openclaw.sqlite~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite

전역 agent_databases 행은 경로, 스키마 버전, 마지막 확인 타임스탬프 및 기본 크기/무결성 메타데이터를 저장합니다. 런타임 코드는 파일 경로를 직접 파생하는 대신 레지스트리에 에이전트 DB를 요청합니다.

에이전트 DB의 소유 항목:

• sessions를 표준 세션 루트로 사용하고, session_entries를 해당 루트에 연결된 호환성 형태의 페이로드 테이블로 사용하며, session_routes를 고유한 활성 session_key 조회로 사용
• conversations 및 session_conversations를 세션에 연결된 정규화된 제공자 라우팅 ID로 사용
• transcript_events
• 트랜스크립트 스냅샷 및 Compaction 체크포인트. 런타임 쓰기에 대해 완료되었습니다.
• vfs_entries
• tool_artifacts 및 실행 아티팩트
• 에이전트 로컬 런타임/캐시 행. 워커 범위 캐시에 대해 완료되었습니다.
• ACP 상위 스트림 이벤트
• 명시적 내보내기 아티팩트가 아닌 경우의 궤적 런타임 이벤트

3단계: 세션 저장소 API 교체

런타임에 대해 완료되었습니다. 파일 형태의 세션 저장소 표면은 활성 런타임 계약이 아닙니다.

• 런타임은 더 이상 loadSessionStore(storePath)를 호출하거나 storePath를 세션 ID로 취급하지 않습니다.
• 런타임 행 작업은 getSessionEntry, upsertSessionEntry, patchSessionEntry, deleteSessionEntry, listSessionEntries입니다.
• 전체 저장소 재작성 도우미, 파일 작성기, 큐 테스트, 별칭 정리 및 레거시 키 삭제 매개변수가 런타임에서 제거되었습니다.
• 사용 중단된 루트 패키지 호환성 내보내기는 여전히 표준 sessions.json 경로를 SQLite 행 API에 맞게 조정합니다.
• sessions.json 구문 분석은 doctor 마이그레이션/가져오기 코드와 doctor 테스트에만 남아 있습니다.
• 런타임 수명 주기 폴백은 JSONL 첫 줄이 아니라 SQLite 트랜스크립트 헤더를 읽습니다.

파일 잠금 매개변수, 파일 유지 관리로서의 정리/잘라내기 용어, 저장소 경로 ID 또는 JSON 지속성만 검증하는 테스트를 다시 도입하는 항목은 계속 삭제하십시오.

4단계: 트랜스크립트, ACP 스트림, 궤적 및 VFS 이전

모든 에이전트 데이터 스트림을 데이터베이스 네이티브로 만드십시오.

• 트랜스크립트 추가 쓰기는 세션 헤더를 보장하고, 메시지 멱등성을 확인하며, 상위 꼬리를 선택하고, transcript_events에 삽입하고, 조회 가능한 ID 메타데이터를 transcript_event_identities에 기록하는 하나의 SQLite 트랜잭션을 통해 수행됩니다. 직접 트랜스크립트 메시지 추가 및 일반적으로 지속되는 TranscriptSessionManager 추가에 대해 완료되었습니다. 명시적 분기 작업은 명시적 상위 선택을 유지하며 파일 로케이터를 파생하지 않고도 SQLite 행을 계속 씁니다.
• ACP 상위 스트림 로그는 .acp-stream.jsonl 파일이 아니라 행이 됩니다. 완료되었습니다.
• ACP 생성 설정은 더 이상 트랜스크립트 JSONL 경로를 지속하지 않습니다. 완료되었습니다.
• 런타임 궤적 캡처는 이벤트 행/아티팩트를 직접 씁니다. 명시적 지원/내보내기 명령은 지원 번들 JSONL 아티팩트를 내보내기 형식으로 계속 생성할 수 있지만, 세션 내보내기는 세션 JSONL을 다시 생성하지 않습니다. 완료되었습니다.
• 디스크 모드로 구성된 경우 디스크 작업 공간은 디스크에 유지됩니다.
• VFS 스크래치 및 실험적 VFS 전용 작업 공간 모드는 에이전트 DB를 사용합니다.

마이그레이션은 기존 JSONL 파일을 한 번 가져오고, 개수/해시를 migration_runs에 기록하며, 무결성 검사 후 가져온 파일을 제거합니다.

5단계: 백업, 복원, Vacuum 및 검증

백업은 하나의 아카이브 파일로 유지됩니다.

• 모든 전역 및 에이전트 데이터베이스에 대해 체크포인트를 수행합니다.
• SQLite 백업 의미 체계 또는 VACUUM INTO를 사용하여 각 DB의 스냅샷을 생성합니다.
• 압축된 DB 스냅샷, 구성, 외부 자격 증명 및 요청된 작업 공간 내보내기를 아카이브합니다.
• 원시 라이브 *.sqlite-wal 및 *.sqlite-shm 파일을 제외합니다.
• 모든 DB 스냅샷을 열고 PRAGMA integrity_check를 실행하여 검증합니다. openclaw backup create는 기본적으로 이 아카이브 검증을 수행합니다. --no-verify는 스냅샷 생성 무결성 검사가 아니라 쓰기 후 아카이브 단계만 건너뜁니다.
• 복원은 스냅샷을 대상 경로로 다시 복사합니다. 복원된 전역 DB는 버전 1을 사용하고, 복원된 에이전트별 DB는 버전 2를 사용하며, 버전 1 스냅샷은 열릴 때 원자적으로 업그레이드됩니다.

6단계: 워커 런타임

데이터베이스 분리가 자리 잡는 동안 워커 모드를 실험적으로 유지하십시오.

• 워커는 에이전트 ID, 실행 ID, 파일 시스템 모드 및 DB 레지스트리 ID를 받습니다.
• 각 워커는 자체 SQLite 연결을 엽니다.
• 상위 프로세스는 채널 전달, 승인, 구성 및 취소 권한을 유지합니다.
• 활성 실행당 워커 하나로 시작하고, 수명 주기와 DB 연결 소유권이 안정된 후에만 풀링을 추가합니다.

7단계: 기존 체계 삭제

런타임 세션 관리에 대해 완료되었습니다. 기존 체계는 명시적 doctor 입력 또는 지원/내보내기 출력으로만 허용됩니다.

• 런타임에서 sessions.json, 트랜스크립트 JSONL, 샌드박스 레지스트리 JSON, 작업 사이드카 SQLite 또는 Plugin 상태 사이드카 SQLite를 쓰지 않습니다.
• JSON/세션 파일 정리, 파일 트랜스크립트 잘라내기, 세션 파일 잠금 또는 잠금 형태의 세션 테스트를 사용하지 않습니다.
• 기존 세션 파일을 최신 상태로 유지하기 위한 런타임 호환성 내보내기를 사용하지 않습니다.
• 명시적 지원 내보내기는 사용자가 요청한 아카이브/구체화 형식으로 유지되며, 파일 이름을 런타임 ID에 다시 반영해서는 안 됩니다.

백업 및 복원

백업은 하나의 아카이브 파일이어야 하지만, 데이터베이스 캡처는 SQLite 네이티브여야 합니다.

1. 장기 실행 쓰기 활동을 중지하거나 짧은 백업 배리어에 진입합니다.
2. 모든 전역 및 에이전트 데이터베이스에 대해 체크포인트를 실행합니다.
3. VACUUM INTO를 사용하여 임시 백업 디렉터리에 데이터베이스 스냅샷을 생성합니다. 소유자가 정의한 SQLite 기능이 필요한 Plugin 스키마는 소유자가 안전한 스냅샷 계약을 제공할 때까지 실패 시 닫힌 상태를 유지합니다.
4. 데이터베이스 스냅샷, 구성 파일, 자격 증명 디렉터리, 선택한 작업 공간 및 매니페스트를 아카이브합니다.
5. 모든 SQLite 스냅샷의 파일 형태를 검증한 다음, 표준 OpenClaw 데이터베이스를 열고 PRAGMA integrity_check와 역할 검증을 실행합니다. 전용 Plugin 스키마는 소유자가 검증기를 제공하지 않는 한 불투명하게 유지됩니다. openclaw backup create는 기본적으로 이를 수행하며, --no-verify는 의도적으로 쓰기 후 아카이브 단계를 건너뛸 때만 사용합니다.

원시 라이브 *.sqlite, *.sqlite-wal, *.sqlite-shm 복사본을 기본 백업 형식으로 사용하지 마십시오. 아카이브 매니페스트에는 데이터베이스 역할, 에이전트 ID, 스키마 버전, 소스 경로, 스냅샷 경로, 바이트 크기 및 무결성 상태를 기록해야 합니다.

복원은 아카이브 스냅샷에서 전역 데이터베이스와 에이전트 데이터베이스 파일을 다시 구성해야 합니다. 전역 스키마는 버전 1로 유지되며, 에이전트별 버전 1 스냅샷에는 버전 2로의 제한된 런타임 업그레이드가 적용됩니다. doctor만 파일에서 데이터베이스로 가져오기를 소유합니다. 복원 명령은 먼저 아카이브를 검증한 다음, 검증된 압축 해제 페이로드에서 각 매니페스트 자산을 교체합니다.

런타임 리팩터링 계획

1. 데이터베이스 레지스트리 API를 추가합니다.

   • 전역 DB 및 에이전트별 DB 경로를 확인합니다.
   • 전역 스키마를 user_version = 1로 유지합니다. 에이전트별 DB는 버전 2를 사용하며, 출시된 버전 1 메모리 소스 형태에서 한 번의 원자적 마이그레이션을 수행합니다.
   • 테스트, 백업 및 doctor에서 사용하는 닫기/체크포인트/무결성 도우미를 추가합니다.

2. 사이드카 SQLite 저장소를 통합합니다.

   • Plugin 상태 테이블을 전역 데이터베이스로 이동합니다. 런타임 쓰기에 대해 완료되었으며, 출시되지 않은 레거시 사이드카 가져오기 도구는 삭제되었습니다.
   • 작업 레지스트리 테이블을 전역 데이터베이스로 이동합니다. 런타임 쓰기에 대해 완료되었으며, 출시되지 않은 레거시 사이드카 가져오기 도구는 삭제되었습니다.
   • Task Flow 테이블을 전역 데이터베이스로 이동합니다. 런타임 쓰기에 대해 완료되었으며, 출시되지 않은 레거시 사이드카 가져오기 도구는 삭제되었습니다.
   • 내장 메모리 검색 테이블을 각 에이전트 데이터베이스로 이동합니다. 완료되었습니다. 명시적 사용자 지정 memorySearch.store.path는 이제 doctor 구성 마이그레이션으로 제거됩니다. 전체 재인덱싱은 메모리 테이블만 대상으로 제자리에서 실행됩니다. 기존 전체 파일 교체 경로와 사이드카 인덱스 교체 도우미는 삭제되었습니다.
   • 해당 하위 시스템에서 중복 데이터베이스 열기 함수, WAL 설정, 권한 도우미 및 닫기 경로를 삭제합니다.

3. 에이전트 소유 테이블을 에이전트별 데이터베이스로 이동합니다.

   • 전역 데이터베이스 레지스트리를 통해 필요할 때 에이전트 DB를 생성합니다. 완료되었습니다.
   • 런타임 세션 항목, 트랜스크립트 이벤트, VFS 행 및 도구 아티팩트를 에이전트 DB로 이동합니다. 완료되었습니다.
   • 브랜치 로컬 공유 DB 세션 항목, 트랜스크립트 이벤트, VFS 행 또는 도구 아티팩트는 마이그레이션하지 마십시오. 해당 레이아웃은 출시된 적이 없습니다. doctor에는 레거시 파일-데이터베이스 가져오기만 유지합니다.

4. 세션 저장소 API를 교체합니다.

   • 런타임 ID에서 storePath를 제거합니다. 런타임에 대해 완료되었으며 check:database-first-legacy-stores로 보호됩니다. 세션 메타데이터, 경로 업데이트, 명령 지속성, CLI 세션 정리, Feishu 추론 미리보기, 트랜스크립트 상태 지속성, 하위 에이전트 깊이, 인증 프로필 세션 재정의, 상위 포크 로직 및 QA-lab 검사는 이제 표준 에이전트/세션 키에서 데이터베이스를 확인합니다. Gateway/TUI/UI/macOS 세션 목록 응답은 이제 레거시 path 대신 databasePath를 노출합니다. macOS 디버그 표면은 session.store 구성을 쓰는 대신 에이전트별 데이터베이스를 읽기 전용 상태로 표시합니다. /status, 채팅 기반 궤적 내보내기 및 CLI 의존성 프록시는 더 이상 레거시 저장소 경로를 전파하지 않습니다. 트랜스크립트 사용량 폴백은 에이전트/세션 ID를 기준으로 SQLite를 읽습니다. 런타임 및 브리지 테스트는 더 이상 storePath를 노출하지 않으며, doctor/마이그레이션 입력이 해당 레거시 필드 이름을 소유합니다. Gateway 통합 세션 로딩에는 더 이상 템플릿이 아닌 session.store 값에 대한 특별한 런타임 분기가 없으며, 에이전트별 SQLite 행을 집계합니다. 레거시 세션 잠금 doctor 경로와 해당 .jsonl.lock 정리 도우미가 제거되었습니다. 이제 SQLite가 세션 동시성 경계입니다. 핫 런타임 호출 지점은 resolveSessionRowEntry와 같은 행 지향 도우미 이름을 사용합니다. 기존 resolveSessionStoreEntry 호환성 별칭은 런타임 및 Plugin SDK 내보내기에서 제거되었습니다.

• { agentId, sessionKey } 행 작업을 사용합니다. 완료되었습니다. getSessionEntry, upsertSessionEntry, deleteSessionEntry, patchSessionEntry, listSessionEntries는 세션 저장소 경로가 필요하지 않은 SQLite 우선 API입니다. 상태 요약, 로컬 에이전트 상태, 상태 점검 및 openclaw sessions 목록 명령은 이제 에이전트별 행을 직접 읽고 sessions.json 경로 대신 에이전트별 SQLite 데이터베이스 경로를 표시합니다.
• 전체 저장소 삭제/삽입을 upsertSessionEntry, deleteSessionEntry, listSessionEntries 및 SQL 정리 쿼리로 교체합니다. 런타임에 대해 완료되었습니다. 핫 경로는 이제 행 API와 충돌 시 재시도하는 행 패치를 사용합니다. 나머지 전체 저장소 가져오기/교체 도우미는 마이그레이션 가져오기 코드와 SQLite 백엔드 테스트로 제한됩니다.
  • store-writer.ts 및 작성기 큐 테스트를 삭제합니다. 완료되었습니다.
  • 세션 행 업서트/패치에서 런타임 레거시 키 정리 및 별칭 삭제 매개변수를 삭제합니다. 완료되었습니다.

5. 런타임 JSON 레지스트리 동작을 삭제합니다.
   • 샌드박스 레지스트리 읽기 및 쓰기를 SQLite 전용으로 만듭니다. 완료되었습니다.
   • 단일 및 샤딩된 JSON은 마이그레이션 단계에서만 가져옵니다. 완료되었습니다.
   • 샤딩된 레지스트리 잠금 및 JSON 쓰기를 제거합니다. 완료되었습니다.

• 형태가 핫 경로 운영 상태로 유지되는 경우 레지스트리 행을 일반적인 불투명 JSON으로 저장하는 대신 형식이 지정된 레지스트리 테이블 하나를 유지합니다. 완료되었습니다.

6. 파일 잠금 형태의 세션 변경을 삭제합니다.

   • 런타임 잠금 생성 및 런타임 잠금 API에 대해 완료되었습니다.
   • 독립형 레거시 .jsonl.lock doctor 정리 경로가 제거되었습니다.
   • session.writeLock은 형식이 지정된 런타임 설정이 아니라 doctor로 마이그레이션되는 레거시 구성입니다.
   • 상태 무결성에는 더 이상 별도의 고아 트랜스크립트 파일 정리 경로가 없습니다. doctor 마이그레이션은 레거시 JSONL 소스를 한곳에서 가져오고 제거합니다.
   • Gateway 싱글턴 조정은 gateway_locks 아래의 형식이 지정된 SQLite state_leases 행을 사용하며 더 이상 파일 잠금 디렉터리 접점을 노출하지 않습니다.
   • 일반 Plugin SDK 중복 제거 지속성은 더 이상 파일 잠금이나 JSON 파일을 사용하지 않고, 공유 SQLite Plugin 상태 행을 씁니다. 완료되었습니다.
   • QMD 임베딩 조정은 qmd/embed.lock 대신 SQLite 상태 임대를 사용합니다. 완료되었습니다.

7. 워커가 데이터베이스를 인식하도록 만듭니다.

   • 워커는 자체 SQLite 연결을 엽니다.
   • 상위 프로세스는 전달, 채널 콜백 및 구성을 소유합니다.
   • 워커는 라이브 핸들이 아니라 에이전트 ID, 실행 ID, 파일 시스템 모드 및 DB 레지스트리 ID를 받습니다.
   • vfs-only는 실험적 상태로 유지되며 에이전트 데이터베이스를 저장소 루트로 사용합니다.
   • 먼저 활성 실행당 워커 하나를 유지합니다. DB 연결 수명과 취소 동작이 안정될 때까지 풀링은 미룰 수 있습니다.

8. 백업 통합.

   • 백업이 전역, 에이전트 및 Plugin 데이터베이스를 VACUUM INTO로 스냅샷하도록 합니다. 상태 자산 아래에서 검색된 *.sqlite 파일에 대해 완료했으며, 사용할 수 없는 소유자 기능이 필요한 Plugin 스키마는 실패 시 차단됩니다.
   • 정식 SQLite 무결성과 스키마 ID에 대한 백업 검증 및 전용 Plugin 스냅샷에 대한 일반 파일 형식 검증을 추가합니다. 백업 생성 및 기본 아카이브 검증에 대해 완료했습니다.
   • 백업 실행 메타데이터를 SQLite에 기록합니다. 아카이브 경로, 상태 및 매니페스트 JSON이 포함된 공유 backup_runs 테이블을 통해 완료했습니다.
   • 검증된 아카이브 스냅샷으로부터 복원을 추가합니다. 완료: openclaw backup restore는 추출 전에 검증하고, 검증기의 정규화된 매니페스트를 사용하며, --dry-run을 지원하고, 기록된 소스 경로를 교체하기 전에 --yes를 요구합니다.
   • 요청된 경우에만 VFS/작업 공간 내보내기를 포함하고, 세션 내부 데이터를 JSON 또는 JSONL로 내보내지 않습니다.

9. 더 이상 사용되지 않는 테스트와 코드를 삭제합니다. 알려진 런타임 세션 표면에 대해 완료했습니다.

• 런타임에서 sessions.json 또는 트랜스크립트 JSONL 파일을 생성한다고 단언하는 테스트를 제거합니다. 코어 세션 저장소, 채팅, Gateway 트랜스크립트 이벤트, 미리 보기, 수명 주기, 명령 세션 항목 업데이트, 자동 응답 재설정/추적 및 memory-core Dreaming 픽스처, 승인 대상 라우팅, 세션 트랜스크립트 복구, 보안 권한 복구, 궤적 내보내기 및 세션 내보내기에 대해 완료했습니다. 이제 Active-memory 트랜스크립트 테스트는 SQLite 범위 및 임시 또는 영구 JSONL 파일이 생성되지 않음을 단언합니다. 런타임이 더 이상 JSONL 트랜스크립트를 잘라내지 않으므로 기존 Heartbeat 트랜스크립트 정리 회귀 테스트를 제거했습니다. 에이전트 세션 목록 도구 테스트는 더 이상 기존 sessions.json 경로를 Gateway 응답 형식으로 모델링하지 않으며, 앱/UI/macOS 테스트는 databasePath를 사용합니다. 이제 /status 트랜스크립트 사용량 테스트는 JSONL 파일을 작성하는 대신 SQLite 트랜스크립트 행을 직접 시드합니다. 이제 Gateway 세션 수명 주기 테스트는 SQLite 트랜스크립트 시드 도우미를 직접 사용하며, 기존 단일 행 세션 파일 픽스처 형식은 재설정 및 삭제 범위에서 제거되었습니다. sessions.delete는 더 이상 파일 시대의 archived: [] 필드를 반환하지 않으며, 삭제는 행 변경 결과만 보고합니다. 기존 deleteTranscript 옵션도 제거되었습니다. 세션을 삭제하면 정식 sessions 루트가 제거되고 SQLite가 세션 소유 트랜스크립트, 스냅샷 및 궤적 행을 연쇄 삭제하므로 어떤 호출자도 트랜스크립트 고아를 남기거나 정리 분기를 누락할 수 없습니다. 이제 컨텍스트 엔진 궤적 캡처 테스트는 session.trajectory.jsonl을 읽는 대신 격리된 에이전트 데이터베이스의 trajectory_runtime_events 행을 읽습니다. 이제 Docker MCP 채널 시드 스크립트는 SQLite 행을 직접 시드합니다. 직접적인 sessions.json 쓰기는 doctor 픽스처로 제한됩니다. Tool Search Gateway E2E는 agents/<agentId>/sessions/*.jsonl 파일을 검색하는 대신 SQLite 트랜스크립트 행에서 도구 호출 증거를 읽습니다. 이제 Memory-core 호스트 이벤트 및 세션 코퍼스 스크래치 행은 공유 SQLite Plugin 상태에 저장되며, events.jsonl 및 session-corpus/*.txt는 기존 doctor 마이그레이션 입력으로만 사용됩니다. 활성 행은 .dreams/session-corpus가 아니라 memory/session-ingestion/ 가상 경로를 사용합니다. 런타임이 더 이상 해당 코퍼스의 파일 아카이브 복구를 소유하지 않으므로 기존 memory-core Dreaming 복구 모듈과 해당 CLI/Gateway 테스트를 제거했습니다. Memory-core 브리지/공개 아티팩트 테스트는 더 이상 .dreams/events.jsonl을 노출하지 않으며, SQLite 기반 가상 JSON 아티팩트 이름을 사용합니다. 이제 공개 SDK/Codex 테스트 문서는 세션 파일 대신 SQLite 세션 상태라고 설명하며, 채널 전환 예제는 더 이상 storePath 인수를 노출하지 않습니다. 이제 Matrix 동기화 상태는 SQLite Plugin 상태 저장소를 직접 사용합니다. 활성 클라이언트/런타임 계약은 bot-storage.json 경로가 아니라 계정 저장소 루트를 전달하며, doctor는 소스를 삭제하기 전에 기존 bot-storage.json을 SQLite로 가져옵니다. 이제 QA Matrix 재시작/파괴적 시나리오는 가짜 bot-storage.json 파일을 생성하거나 삭제하는 대신 SQLite 동기화 행을 직접 변경하며, E2EE 기반 계층은 가짜 sync-store.json 경로가 아니라 동기화 저장소 루트를 전달합니다. Matrix 저장소 루트 선택은 더 이상 기존 동기화/스레드 JSON 파일을 기준으로 루트의 점수를 매기지 않으며, 영구 루트 메타데이터와 실제 암호화 상태를 사용합니다. 런타임 SQLite 세션 백엔드 테스트 스위트는 더 이상 sessions.json을 만들어내지 않으며, 기존 소스 픽스처는 이를 가져오는 doctor 테스트에만 존재합니다. Gateway 세션 테스트는 더 이상 createSessionStoreDir 도우미 또는 사용되지 않는 임시 세션 저장소 경로 설정을 노출하지 않습니다. 픽스처 디렉터리는 명시적이며, 직접적인 행 설정은 SQLite 세션 행 명명을 사용합니다. doctor 전용 JSON5 세션 저장소 파서 범위는 인프라 테스트에서 doctor 마이그레이션 테스트로 이동했으므로 런타임 테스트 스위트는 더 이상 기존 세션 파일 구문 분석을 소유하지 않습니다. Microsoft Teams 런타임 SSO/보류 중 업로드 테스트는 더 이상 JSON 사이드카 픽스처 또는 파서를 포함하지 않으며, 기존 SSO 토큰 구문 분석은 Plugin 마이그레이션 모듈에만 존재합니다. Telegram 테스트는 더 이상 가짜 /tmp/*.json 저장소 경로를 시드하지 않으며, SQLite 기반 메시지 캐시를 직접 재설정합니다. 일반 OpenClaw 테스트 상태 도우미는 더 이상 기존 auth-profiles.json 작성기를 노출하지 않으며, doctor 인증 마이그레이션 테스트가 해당 픽스처를 로컬에서 소유합니다. TUI 마지막 세션 포인터, 실행 승인, Active-memory 토글, Matrix 중복 제거/시작 검증, Memory Wiki 소스 동기화, 현재 대화 바인딩, 온보딩 인증 및 Hermes 비밀 정보 가져오기에 대한 런타임 테스트는 더 이상 이전 사이드카 파일을 생성하거나 이전 파일 이름이 없음을 단언하지 않습니다. 이러한 테스트는 SQLite 행과 공개 저장소 API를 통해 동작을 입증하며, doctor/마이그레이션 테스트만이 기존 소스 파일 이름을 포함합니다. 기기/Node 페어링, 채널 allowFrom, 재시작 의도, 재시작 인계, 세션 전송 큐 항목, 구성 상태, iMessage 캐시, Cron 작업, PI 트랜스크립트 헤더, 하위 에이전트 레지스트리 및 관리형 이미지 첨부 파일에 대한 런타임 테스트도 더 이상 폐기된 JSON/JSONL 파일이 무시되거나 존재하지 않음을 입증하기 위해 생성하지 않습니다. PI 오버플로 복구에는 더 이상 SessionManager 재작성/잘라내기 대체 동작이 없습니다. 도구 결과 잘라내기 및 컨텍스트 엔진 트랜스크립트 재작성은 SQLite 트랜스크립트 행을 변경한 다음 데이터베이스에서 활성 프롬프트 상태를 새로 고칩니다. 영구 SessionManager 메시지 추가는 부모 선택 및 멱등성을 위해 원자적 SQLite 트랜스크립트 추가 도우미에 위임합니다. 일반 메타데이터/사용자 지정 항목 추가도 SQLite 내부에서 현재 부모를 선택하므로 오래된 관리자 인스턴스가 SQLite 이전의 부모 체인 경쟁 상태를 되살리지 않습니다. 턴 중간 사전 검사 및 sessions_yield를 위한 합성 PI 꼬리 정리는 이제 SQLite 트랜스크립트 상태를 직접 정리하며, 기존 SessionManager 꼬리 제거 브리지와 해당 테스트는 삭제되었습니다. Compaction 체크포인트 캡처도 SQLite에서만 스냅샷하며, 호출자는 더 이상 실시간 SessionManager를 대체 트랜스크립트 소스로 전달하지 않습니다.

• 마이그레이션에만 기존 파일을 시드하는 테스트를 유지합니다.

• 활성 런타임 표면에서는 JSON 파일 증명이 SQL 행 증명으로 대체되었습니다.

• 기존 세션/캐시 JSON 경로에 대한 런타임 쓰기를 정적으로 금지합니다. 저장소 가드에 대해 완료했습니다.

10. 마이그레이션 보고서를 감사할 수 있게 합니다.
    • 시작/완료 타임스탬프, 소스 경로, 소스 해시, 개수, 경고 및 백업 경로와 함께 마이그레이션 실행을 SQLite에 기록합니다. 완료: 이제 기존 상태 마이그레이션 실행은 소스 경로/테이블 인벤토리, 소스 파일 SHA-256, 크기, 레코드 수, 경고 및 백업 경로가 포함된 migration_runs 보고서를 영구 저장합니다. 완료: 기존 상태 마이그레이션 실행은 소스 수준 감사 및 향후 건너뛰기/백필 결정을 위해 migration_sources 행도 영구 저장합니다.
    • 적용을 멱등적으로 만듭니다. 부분 가져오기 후 다시 실행하면 이미 가져온 소스를 건너뛰거나 안정적인 키로 병합해야 합니다. 완료: 세션 인덱스, 트랜스크립트, 전송 큐, Plugin 상태, 작업 원장 및 에이전트 소유 전역 SQLite 행은 안정적인 키 또는 upsert/교체 의미 체계를 통해 가져오므로 재실행 시 영구 행을 중복하지 않고 병합합니다.
    • 가져오기에 실패하면 원본 소스 파일을 제자리에 유지해야 합니다. 완료: 실패한 트랜스크립트 가져오기는 이제 원본 JSONL 소스를 감지된 경로에 남기며, migration_sources는 다음 doctor 실행을 위해 소스를 warning, removed_source=0으로 기록합니다.

성능 규칙

• 스레드/프로세스당 연결 하나는 괜찮지만, 작업자 간에 핸들을 공유하지 않습니다.
• WAL, foreign_keys=ON, 5s 사용 중 시간 제한 및 짧은 BEGIN IMMEDIATE 쓰기 트랜잭션을 사용합니다. SQLite의 단일 사용 중 대기 위에 동기식 잠금 재시도를 계층화하지 않습니다.
• 명시적인 뮤텍스/배압 의미 체계를 추가하는 비동기 트랜잭션 API가 도입되기 전까지 쓰기 트랜잭션 도우미를 동기식으로 유지합니다.
• 상위 전송 쓰기를 작고 트랜잭션 방식으로 유지합니다.
• 전체 저장소 재작성을 피하고 행 수준 upsert/delete를 사용합니다.
• 핫 코드를 이동하기 전에 에이전트별 목록, 세션별 목록, 업데이트 시간, 실행 ID 및 만료 경로에 대한 인덱스를 추가합니다.
• 대형 아티팩트, 미디어 및 벡터는 base64 또는 숫자 배열 JSON이 아닌 BLOB 또는 청크형 BLOB 행으로 저장합니다.
• 불투명한 Plugin 상태 항목을 작고 범위가 제한되게 유지합니다.
• 파일 시스템 정리 대신 TTL/만료를 위한 SQL 정리를 추가합니다. 데이터베이스 소유 런타임 저장소에 대해 완료했습니다. 미디어, Plugin 상태, Plugin Blob, 영구 중복 제거 및 에이전트 캐시는 모두 SQLite 행을 통해 만료됩니다. 남아 있는 파일 시스템 정리는 임시 구체화 또는 명시적인 제거 명령으로 제한됩니다.

정적 금지 사항

기존 상태 경로에 대한 새로운 런타임 쓰기를 실패 처리하는 저장소 검사를 추가합니다:

• sessions.json
• 구체화된 지원 번들 출력을 제외한 *.trajectory.jsonl
• .acp-stream.jsonl
• acp/event-ledger.json
• cache/*.json 런타임 캐시 파일
• agents/<agentId>/agent/auth.json
• agents/<agentId>/agent/models.json
• credentials/oauth.json
• github-copilot.token.json
• openrouter-models.json
• auth-profiles.json
• auth-state.json
• exec-approvals.json
• workspace-state.json
• Matrix credentials*.json 및 recovery-key.json
• cron/runs/*.jsonl
• cron/jobs.json
• jobs-state.json
• device-pair-notify.json
• devices/pending.json / devices/paired.json / devices/bootstrap.json (2026.7에 폐기됨: 런타임 저장소는 공유 상태 DB의 device_pairing_* / device_bootstrap_tokens이며, 페어링된 레코드는 Gateway 시작 시 가져오고 일시적인 대기/부트스트랩 행은 삭제함)
• nodes/pending.json / nodes/paired.json (2026.7에 폐기됨: Gateway 시작 시 페어링된 기기 레코드에 통합됨)
• identity/device.json
• identity/device-auth.json
• push/web-push-subscriptions.json
• push/vapid-keys.json
• push/apns-registrations.json
• process-leases.json
• gateway-instance-id
• session-toggles.json
• Memory-core .dreams/events.jsonl
• Memory-core .dreams/session-corpus/
• Memory-core .dreams/daily-ingestion.json
• Memory-core .dreams/session-ingestion.json
• Memory-core .dreams/short-term-recall.json
• Memory-core .dreams/phase-signals.json
• Memory-core .dreams/short-term-promotion.lock
• Skill Workshop skill-workshop/<workspace>.json
• Skill Workshop skill-workshop/skill-workshop-review-*.json
• Nostr bus-state-*.json
• Nostr profile-state-*.json
• calls.jsonl
• known-users.json
• ref-index.jsonl
• QQBot session-*.json
• BlueBubbles bluebubbles/catchup/*.json
• BlueBubbles bluebubbles/inbound-dedupe/*.json
• Telegram update-offset-*.json
• Telegram sticker-cache.json
• Telegram *.telegram-messages.json
• Telegram *.telegram-sent-messages.json
• Telegram *.telegram-topic-names.json
• Telegram thread-bindings-*.json
• iMessage catchup/*.json
• iMessage reply-cache.jsonl
• iMessage sent-echoes.jsonl
• Microsoft Teams msteams-conversations.json
• Microsoft Teams msteams-polls.json
• Microsoft Teams msteams-sso-tokens.json
• Microsoft Teams *.learnings.json
• Matrix bot-storage.json
• Matrix sync-store.json
• Matrix thread-bindings.json
• Matrix inbound-dedupe.json
• Matrix startup-verification.json
• Matrix storage-meta.json
• Matrix crypto-idb-snapshot.json
• Discord model-picker-preferences.json
• Discord command-deploy-cache.json
• 샌드박스 레지스트리 샤드 JSON 파일
• 네이티브 훅 릴레이 /tmp 브리지 JSON 파일
• plugin-state/state.sqlite
• 임시 openclaw-state.sqlite 런타임 사이드카
• tasks/runs.sqlite
• tasks/flows/registry.sqlite
• bindings/current-conversations.json
• restart-sentinel.json
• gateway-restart-intent.json
• gateway-supervisor-restart-handoff.json
• gateway.<hash>.lock
• qmd/embed.lock
• commands.log
• config-health.json
• port-guard.json
• settings/voicewake.json
• settings/voicewake-routing.json
• plugin-binding-approvals.json
• plugins/installs.json
• audit/file-transfer.jsonl
• audit/crestodian.jsonl
• crestodian/rescue-pending/*.json
• plugins/phone-control/armed.json
• Memory Wiki .openclaw-wiki/log.jsonl
• Memory Wiki .openclaw-wiki/state.json
• Memory Wiki .openclaw-wiki/locks/
• Memory Wiki .openclaw-wiki/source-sync.json
• Memory Wiki .openclaw-wiki/import-runs/*.json
• Memory Wiki .openclaw-wiki/cache/agent-digest.json
• Memory Wiki .openclaw-wiki/cache/claims.jsonl
• ClawHub .clawhub/lock.json
• ClawHub .clawhub/origin.json
• 브라우저 프로필 데코레이션 .openclaw-profile-decorated
• SessionManager.open(...) 파일 기반 세션 오프너
• SessionManager.listAll(...) 및 TranscriptSessionManager.listAll(...) 트랜스크립트 목록 퍼사드
• SessionManager.forkFromSession(...) 및 TranscriptSessionManager.forkFromSession(...) 트랜스크립트 포크 퍼사드
• SessionManager.newSession(...) 및 TranscriptSessionManager.newSession(...) 변경 가능한 세션 교체 퍼사드
• SessionManager.createBranchedSession(...) 및 TranscriptSessionManager.createBranchedSession(...) 브랜치 세션 퍼사드

이 금지 규칙은 테스트에서 레거시 픽스처를 생성하도록 허용하고, 마이그레이션 코드가 레거시 파일 소스를 읽고/가져오고/제거하도록 허용해야 합니다. 출시되지 않은 SQLite 사이드카는 계속 금지되며 doctor 가져오기 허용 대상이 아닙니다.

완료 기준

• 런타임 데이터 및 캐시 쓰기는 전역 또는 에이전트 SQLite 데이터베이스로 이동합니다.
• 런타임은 더 이상 세션 인덱스, 트랜스크립트 JSONL, 샌드박스 레지스트리 JSON, 작업 사이드카 SQLite 또는 Plugin 상태 사이드카 SQLite를 쓰지 않습니다. 출시되지 않은 작업 및 Plugin 상태 사이드카 SQLite 가져오기 도구는 삭제됩니다.
• 레거시 파일 가져오기는 doctor에서만 수행됩니다.
• 백업은 압축된 SQLite 스냅샷과 무결성 증명이 포함된 단일 아카이브를 생성합니다.
• 에이전트 워커는 디스크, VFS 스크래치 또는 실험적 VFS 전용 스토리지로 실행할 수 있습니다.
• 구성 및 명시적 자격 증명 파일만 예상되는 영구 비데이터베이스 제어 파일로 유지됩니다.
• 저장소 검사는 레거시 런타임 파일 저장소가 다시 도입되는 것을 방지합니다.