OpenClaw 키움증권 주식 자동매매 프로젝트 1일차 [오픈클로 설치, API 연결]

안녕하세요~!

AI 를 공부하는 학생으로써, 새로운 기술을 보면 도전해보고 싶은 욕구가 마구마구 생깁니다.

오늘 소개할 친구는 실리콘밸리에서부터 굉장히 핫하다고 알려진 “OPENCLAW”입니다!!

오픈 클로 사용법에 대해서는 소개해주신 분들이 많기 때문에, 생략하겠습니다. 간단하게 말한다면 이 오픈클로는 “AI가 우리의 컴퓨터에 접근할 수 있도록 하는 뼈대” 라고 생각하시면 좋을 것 같아요.

랍스터를 먹어보면 머리가 대부분 빈 공간인 것을 알 수 있는데요

이러한 랍스터 머리에 우리가 일반적으로 아는 GPT, GEMINI 등의 LLM을 두뇌로 끼워 넣으면 나만의 AI 비서가 완성되는 느낌입니다. 저는 평소에 주식에 관심이 많기 때문에 이러한 OPENCLAW의 첫 활용은 “주식 자동매매 프로젝트”로 정했습니다.

자동매매 프로젝트를 시작하면 보통 전략부터 짜고 싶어지지만 실제로는 전략 이전에 연결이 먼저다. 데이터가 안정적으로 들어오고, 기록이 남고, 외부 이벤트를 붙일 수 있어야 전략이 의미를 가지기 때문에 1일차인 오늘은 그 바닥공사에 집중했습니다.. ㅎㅎ

오늘 목표 : 인프라 구축!!

1. OpenClaw 설치 및 기본 구동
2. 외부 API 키를 OpenClaw 환경변수로 통합
3. Supabase DB 접속 및 테이블 생성
4. OpenDART 인증 + 공시 조회 확인
5. 키움 REST 인증 + 현재가 조회 확인

하나하나 자세히 설명해드릴 테니 따라오세요~~

1) OpenClaw 세팅: 키 관리부터 정리

가장 먼저 한 건 API 호출이 아니라 환경변수를 체계화 해서 저장해야 하는 것입니다. 이 과정을 대충 하면 이후 디버깅 비용이 커지게 되는데요,,,,

핵심 과정은 아래의 흐름을 따릅니다.

1. OpenClaw env.vars에 키/접속정보 등록
2. shell env 활성화
3. gateway restart 후 반영 확인

등록한 주요 값은 Supabase URL/Service Key, DB 접속 정보, OpenDART 키, Kiwoom App Key/App Secret인데 각각을 추후 설명드리겠습니다.

위 그림과 같이 설정하고 싶은 API 키들을 대화 형식으로 넣어주면, LLM이 알아서 등록해줍니다. 저 같은 경우는 codex-5.3 모델을 사용했어요.

API 키들을 넣어줄때는 session memory 등이 아닌 환경변수에 넣어주셔야 하는데요,

이런식으로 넣어주신 후 gateway restart 해주시면 됩니다. codex가 스스로 판단하고 전부 해주니 걱정하지마세요!

2) Supabase 연결: 로그와 상태를 저장할 집 만들기

자동매매에서 DB는 선택이 아니라 필수라는 것 아시죠? 신호, 주문, 체결, 에러, 재시도 이력을 남겨야 원인 추적이 가능하고 AI는 이를 기반으로 학습을 진행합니다. DB를 만드는 방법은 csv 파일 등으로 로컬에 엑셀파일 형태로 만들 수 있지만 저는 관리가 편한 supabase를 활용했어요.

2개까지는 무료고 project url 기반으로 API 연동을 할 수 있으니 간편합니다.

중간에 direct DB 연결 이슈가 있었지만, 최종적으로 session pooler 경로로 안정화했습니다. 혹시나 direct DB를 기반으로 하시는 윈도우 유저분들은 이 방법을 활용해주세요. 이 해답은 단테랩스 유투브에서 찾았답니다!

이렇게 예시 포트폴리오도 만들어주고 추후 키움증권 API로 매매한다면 계속적으로 부여해줄거에요!

3) OpenDART 연동: 공시 데이터 파이프라인 테스트

오픈다트는 금융감독원에서 운영하는 공시데이터를 조회할 수 있는 플랫폼입니다. 간단하게 회원가입 하시고 API 키 발급 해주시면 되는데요, 마찬가지로 키 등록 후 실제 API 호출로 인증/조회까지 검증했습니다!!

1. 인증 확인: 정상(status=000)
2. 공시목록 조회: 기간 필터 적용 시 정상
3. 회사개황 조회: 삼성전자 기준 정상

으로 이어지는 과정으로 확인을 진행했구요 opendart 기준으로 공시정보를 받아서 이를 자동 매매에 반영할 수 있습니다.

4) 키움 REST API 연동: 현재가 수신까지 확인

자동매매의 또 다른 핵심은 시장 데이터를 실제로 받을 수 있냐 그리고 수수료가 얼마나 저렴하냐에 갈릴 것 같은데요 이 모든것을 해결해준 것이 바로 키움증권 REST API 입니다!!

제가 알기로 한투와 키움 두개만 윈도우/맥 환경에서 전부 가능하기 때문에 이 점 참고해주세요.

마찬가지로 모의투자 → 신청 → API 발급으로 해서 위 그림과 같이 key 값을 openclaw에게 넘겨주면 됩니다!

이런식으로 현재 가격 포함해서 재무재표 및 거래량 등도 확인할 수 있습니다.

5) 2일차 계획

내일은 좀 더 깊게 rest API 기반 자동매매를 진행해보려고 해요!! 셋팅이 완료되어 너무 기쁘고 다음 포스팅에서 더 유익한 정보로 찾아오겠습니다.

AI 개발자분들은 공감하시겠지만 초기 셋팅이 정말 중요합니다. 바닥 공사를 야무지게 해놔야 하거든요… 이 과정은 귀찮고 화려하지 않지만 가장 중요한 것을 명심해주시고!!

지금까지 삶은 AI 였습니다 감사합니다!