AAiCON2026 오픈클로 튜토리얼
01.오픈클로 설치부터 텔레그램까지(1-2).pdf1.24MB
오픈클로 응용부터 활용까지(하네스 엔지니어링과 루프 엔지니어링).pdf5.28MB
설치
윈도우는 이거 받아서 설치하세요
*윈도우 설치에러날때 패치 사용해보세요
#패치설치하기
npm install -g jkf87/openclaw-patch
npm install -g jkf87/openclaw-patch
#셋업하기
openclaw-patch setup
맥에서 설치
•
홈브류를 설치 요구하기도 합니다
•
node.js 버전이 24여야 합니다 (25에서 일부 오류가 발생하는 경우가 있습니다)
•
인스톨 명령어 붙여넣기
•
붙여넣고 엔터(오른쪽 마우스를 누르면 복사한게 붙여넣기가 됩니다)
•
비밀번호 요구하면 입력했던 4자리
•
이런 메세지가 나오면 성공입니다
•
설치하면 자동으로 온보딩을 합니다 (openclaw onboard)
•
차례대로 골라주세요
•
"이것이 기본적으로 개인용이며, 공유/다중 사용자 환경에서 사용하려면 잠금 설정이 필요하다는 것을 이해합니다. 계속하시겠습니까?"
◦
● 예 / ○ 아니오
•
온보딩 모드
◦
● QuickStart
◦
●Use existing values
•
OpenAI Oauth를 연결합니다
◦
● OpenAI / ● OpenAI Codex
◦
로그인을 거쳐 연동해주세요(맥은 자동으로 넘어가는데 윈도우는 주소창에 아래 주소를 복사해서 들어가주세요)
◦
이후 구글로 로그인과정을 거치면 됩니다
•
모델을 선택합니다
◦
● gpt-5.4(gpt-5.5) 등 최신모델로 설정
•
채널은 설치이후 독립에이전트를 만들어서 연결할겁니다
●Skip for now
•
웹 서치를 도와주는 도구를 설정
(빠른 설정을 위해 스킵을 권장합니다. 다만 덕덕고와 searxng는 api키가 필요없어서 설정이 편한 편입니다)
(빠른 설정을 위해 스킵을 권장합니다. 다만 덕덕고와 searxng는 api키가 필요없어서 설정이 편한 편입니다)
◦
●Skip for now
•
스킬 설치
◦
권장 스킬 : obsidian, gog(구글 이메일,캘린더)
◦
추후에도 설치가능하니 빠른 설치를 위해서 ●No 를 권장합니다
•
API키를 설정하는 부분입니다.
◦
역시 추후 설정에서 추가하거나, 오픈클로에게 직접 셋팅해달라고 할 수 있어서 넘어가겠습니다.
•
Enable hooks? 말그대로 훅인데요, boot-md, session-memory는 키시고 나머지는 선택하시면 됩니다.
◦
◦
bootstrap-extra-files : 에이전트 세션 시작시에 자동으로 읽어들일 추가 파일 지정하는 훅
◦
command-logger : 에이전트가 내부적으로 수행한 툴 콜링 명령어를 기록해 디버깅을 도와줌
◦
session-memory: 새 세션을 시작할때나 리셋할때, 기존 세션 내용을 메모리에 저장함
[Q&A] 오픈클로에 연결한 chatgpt 사용량을 알고 싶어요
https://chatgpt.com/codex/settings/usage 여기서 사용량 확인가능합니다.
•
게이트웨이 설치 ( 저는 이미 설치되어 있어서 이렇게 나온겁니다)
◦
Restart / Reinstall / Skip 상관없습니다
•
봇을 어떻게 실행시킬건지 물어봅니다
◦
저는 open the web UI를 권장드려요
직원 추가하기
•
텔레그램 봇 만들기
◦
봇파더 검색(@botfather)
◦
/newbot 이용해서 봇 만들기
•
-봇이름(내화면에서 보이는)
'윈도우테스트봇'
'윈도우테스트봇'
-실제 봇아이디(텔레그램에서 사용하는) 'test0306clawbot'
-발급받은 토큰(http api)
'8634006604~~'
'8634006604~~'
•
오픈클로 에이전트 추가하기
◦
openclaw agents add 봇이름
◦
openclaw agents add paperbot
•
처음에 워크스페이스-봇이름 형태로 폴더를 만들어줍니다.
•
메인 봇의 정보를 가져다 쓸건지 물어봅니다. 이건 상황에 맞게 선택해주세요
•
모델/어스 설정을 할거냐라고 물어봅니다. 기존에 Chatgpt oauth를 사용중이라면 별도 설정이 필요없습니다.
◦
다른 모델을 테스트하고 싶다면 yes를 눌러서 설정할수 있어요
•
채널설정을 할건지 물어봅니다. 텔레그램 연결해야하니 yes를 눌러주세요
•
텔레그램을 선택합니다
•
●modify settings 선택
•
●add a new account 선택
•
new Telegram account id에 실제 봇아이디를 넣어주세요
•
봇 토큰을 입력합니다
•
종료가 되지 않고 다시 설정화면으로 넘어오는데 당황하지 마세요
◦
●finished를 선택하여 빠져나옵니다
•
이제 DM 을 설정합니다
◦
●yes
◦
●pairing을 추천
•
오픈클로 에이전트와 바인딩을 위해 yes를 선택해주세요
◦
●yes
•
봇 연동 완료
•
텔레그램에 들어가서 인사를 나눠봅시다
•
페어링을 해야해요, 아래 명령어를 복사해서 넣어주세요
•
이제 연결이 완전히 됐습니다. 한국어로 편하게 이야기해보세요
에이전트 권한 설정, 풀백 지정
텔레그램연결, 기능추가
/think : 추론강도 설정
/models : 모델, 프로바이더 변경
/verbose on : 툴콜링 내부 호출 로그 활성화
/setthreads : 봇 내에 주제별로 쓰레드를 관리해주는 기능 활성화
:/trace on : 메모리 로그 활성화
메모리 기능 활성화
메모리 상태 확인
openclaw memory status
임베딩 모델 다운
ollama pull bge-m3
임베딩 프로바이더를 올라마로 지정
openclaw config set agents.defaults.memorySearch.provider ollama
모델을 bge-m3로 지정
openclaw config set agents.defaults.memorySearch.model bge-m3
메모리 인덱싱 하기
openclaw memory index --force
이메일 연결하기(gog 스킬을 사용)
설치하기
맥: brew install gogcli
윈도우:
접속하기(구글 로그인)
gmail api 신청하기
gog auth add 이메일주소 --services gmail
또는
상용 하네스 활용, 제작, 루프 만들기
가장 쉬운 방법 : codex app의 녹화 기능 활용하기 (스킬 녹화 , mac only)
두번째 방법: 일을 시키고 완료 후에 '회고해줘'라고 하기
세번째 방법: 스킬 크리에이터로 스킬을 만들어달라고 하거나 스킬 워크샵에 올라온걸 승인하기
