Initial commit: OpenClaw 워크스페이스 버전관리 시작

설정·스크립트·스킬·문서·큐레이션 메모리 추적.
시크릿(credentials/identity)·런타임 상태(state/logs/sessions/sqlite)·
백업(clobbered/bak)·dream 캐시는 .gitignore로 제외.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs/README.md

@@ -0,0 +1,35 @@
+# OpenClaw 외부 문서 보관소
+
+OpenClaw 워크스페이스에서 참조하는 외부 공급사·서비스·플랫폼 공식 문서를 모아두는 곳. 모든 에이전트(클로·레이·골디·코디)가 공유하는 단일 진실 공급원.
+
+## 운영 원칙
+
+- **하위 폴더 만들지 않는다.** 모든 문서는 `docs/` 직속에 둔다. 분류는 이 README.md 의 카탈로그로.
+- **새 문서 추가 시 이 README.md 의 "카탈로그" 섹션에 한 줄 등록.** 제목·용도·관련 에이전트·관련 코드 위치.
+- **외부에서 받은 PDF/문서를 그대로 보관.** 가공·요약본은 별도 메모리 파일로 정리하고, 원본은 그대로.
+- **버전 갱신 시 파일명에 날짜 suffix 또는 그대로 덮어쓰기.** 큰 변화면 옛 버전을 `archive/` 같은 폴더 대신 `이름_YYYY-MM-DD.pdf` 처럼 명시.
+
+## 카탈로그
+
+### `키움 REST API 문서.pdf`
+
+- **공급사:** 키움증권
+- **용도:** 키움 OpenAPI(REST) 명세서. TR_ID 별 endpoint URL, request body·response field, 예시.
+- **관련 에이전트:** 레이(stock) — 매매·조회 모든 키움 호출의 단일 진실 공급원
+- **관련 코드:**
+  - `agents/stock/workspace/scripts/kiwoom_client.py` — 조회 전용 (kt00001/kt00004/kt00007/kt00018/ka10001/ka10099/ka10170)
+  - `agents/stock/workspace/scripts/orders/kiwoom_order.py` — 매수/매도 (kt10000/kt10001)
+  - `agents/stock/workspace/scripts/orders/datasource.py` — 호가(ka10004)
+- **관련 메모리:**
+  - 코디: `~/.claude/projects/-Users-snowoyh--openclaw/memory/reference_kiwoom_endpoints.md`
+  - 레이: `agents/stock/workspace/memory/orders_module.md`, `2026-05-07-kiwoom-api-audit.md`
+- **새 TR 추가 절차:**
+  1. PDF 목차에서 TR_ID 페이지 번호 확인
+  2. 해당 페이지에서 "URL" 필드 확인 → endpoint 결정 (`acnt`/`stkinfo`/`mrkcond`/`ordr`)
+  3. 응답 필드명 그대로 매핑 (suffix 패턴 추측 금지 — 2026-05-07 ka10004 사고)
+  4. 가격·수량 필드는 `+/-` 부호 가능 — `abs()` 처리 검토
+- **마지막 검증:** 2026-05-07 — 10개 TR 코드 ↔ 명세 1:1 대조 완료
+
+## 변경 이력
+
+- 2026-05-07 — `docs/` 폴더 신규, 키움 REST API PDF 입주