# 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 입주