# AAiCON2026 오픈클로 튜토리얼

01.오픈클로 설치부터 텔레그램까지(1-2).pdf

오픈클로 응용부터 활용까지(하네스 엔지니어링과 루프 엔지니어링).pdf

상태 확인을 위해 padlet을 이용합니다 (스크린샷 복사해서 붙여넣기 → 질문 → 답변) 
[https://padlet.com/jjoongoo/as-enwz640wf1i60su0](https://padlet.com/jjoongoo/as-enwz640wf1i60su0) 

코난쌤 톡방: [https://open.kakao.com/o/gXxFpUnh](https://open.kakao.com/o/gXxFpUnh)

### 설치

윈도우는 이거 받아서 설치하세요

[https://github.com/openclaw/openclaw-windows-node/releases/download/v0.6.3/OpenClawCompanion-Setup-x64.exe](https://github.com/openclaw/openclaw-windows-node/releases/download/v0.6.3/OpenClawCompanion-Setup-x64.exe)

*윈도우 설치에러날때 패치 사용해보세요

> #패치설치하기
npm install -g jkf87/openclaw-patch

#셋업하기

openclaw-patch setup

### 맥에서 설치

- [ 홈브류](https://brew.sh/)를 설치 요구하기도 합니다

> /bin/bash -c "$(curl -fsSL [https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh](https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh))"[https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"](https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)%22)

- [node.js](https://node.jsrk) 버전이 24여야 합니다 (25에서 일부 오류가 발생하는 경우가 있습니다)

- 인스톨 명령어 붙여넣기 

> curl -fsSL [https://openclaw.ai/install.sh](https://openclaw.ai/install.sh) | bash

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/085549_r39YS9Kfo2TiimOEYh?q=80&s=1280x180&t=outside&f=webp)

- 붙여넣고 엔터(오른쪽 마우스를 누르면 복사한게 붙여넣기가 됩니다) 

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/085718_oOLhlUhv3ckbmxXBty?q=80&s=1280x180&t=outside&f=webp)

- 비밀번호 요구하면 입력했던 **4자리**

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/085752_OhARIbol3oTUpsJeVp?q=80&s=1280x180&t=outside&f=webp)

- 이런 메세지가 나오면  성공입니다

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/090021_tTy2E8oifyDPEmPbRs?q=80&s=1280x180&t=outside&f=webp)

- 설치하면 자동으로 온보딩을 합니다 (openclaw onboard)

- 차례대로 골라주세요

- "이것이 기본적으로 개인용이며, 공유/다중 사용자 환경에서 사용하려면 잠금 설정이 필요하다는 것을 이해합니다. 계속하시겠습니까?"

    - ● 예 /  ○ 아니오

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/090126_B1MkCaqZG366CEzq7I?q=80&s=1280x180&t=outside&f=webp)

- 온보딩 모드 

    - ● QuickStart

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/090103_HYayIfLBY8RrlI5LWT?q=80&s=1280x180&t=outside&f=webp)

    - ●Use existing values

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/103113_Htt1MRABmvL2jVyvZu?q=80&s=1280x180&t=outside&f=webp)

- OpenAI Oauth를 연결합니다

    - ● OpenAI / ● OpenAI Codex 

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/090620_LBCPq0nNcaYa5g57ew?q=80&s=1280x180&t=outside&f=webp)

    - 로그인을 거쳐 연동해주세요(맥은 자동으로 넘어가는데 윈도우는 주소창에 아래 주소를 복사해서 들어가주세요)

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/090734_fdcPezx3sC6q63nNbB?q=80&s=1280x180&t=outside&f=webp)

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/090830_UupUR1HL4gxxBP3MRc?q=80&s=1280x180&t=outside&f=webp)

    - 이후 구글로 로그인과정을 거치면 됩니다

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/090932_I2EKqwCDhs7lYfnG3L?q=80&s=1280x180&t=outside&f=webp)

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/091002_vWmNYK05LUrcITwQjz?q=80&s=1280x180&t=outside&f=webp)

- 모델을 선택합니다 

    - ● gpt-5.4(gpt-5.5) 등 최신모델로 설정

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/090634_2g5QqAAXz61jT7k2zU?q=80&s=1280x180&t=outside&f=webp)

- 채널은 설치이후 독립에이전트를 만들어서 연결할겁니다

●Skip for now

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/091205_D2z94l82ww84Q7ZdRY?q=80&s=1280x180&t=outside&f=webp)

- 웹 서치를 도와주는 도구를 설정
- (빠른 설정을 위해 스킵을 권장합니다. 다만 덕덕고와 searxng는 api키가 필요없어서 설정이 편한 편입니다)

    - ●Skip for now

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/103407_JvGIvBHjQIT6cHFBuv?q=80&s=1280x180&t=outside&f=webp)

- 스킬 설치

    - 권장 스킬 : obsidian, gog(구글 이메일,캘린더)

    - 추후에도 설치가능하니 빠른 설치를 위해서 `●No` 를 권장합니다

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/103509_Dg2IultjqPWijrlw8h?q=80&s=1280x180&t=outside&f=webp)

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/103532_5XjBiWgS6pLOIWC8Bf?q=80&s=1280x180&t=outside&f=webp)

- API키를 설정하는 부분입니다.

    - 역시  추후 설정에서 추가하거나, 오픈클로에게 직접 셋팅해달라고 할 수 있어서 넘어가겠습니다.

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/103823_JcLDv43FRUiAwNYW2t?q=80&s=1280x180&t=outside&f=webp)

- Enable hooks? 말그대로 훅인데요, boot-md, session-memory는 키시고 나머지는 선택하시면 됩니다. 

    - boot-md : 게이트웨이 시작하면 [boot.md](https://boot.md) 를 실행하는 훅

    - bootstrap-extra-files : 에이전트 세션 시작시에 자동으로 읽어들일 추가 파일 지정하는 훅

    - command-logger : 에이전트가 내부적으로 수행한 툴 콜링 명령어를 기록해 디버깅을 도와줌 

    - session-memory: 새 세션을 시작할때나 리셋할때, 기존 세션 내용을 메모리에 저장함

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/104141_vwN4GQGM2GrH2bpeJ5?q=80&s=1280x180&t=outside&f=webp)

### [Q&A] 오픈클로에 연결한 chatgpt 사용량을 알고 싶어요

[https://chatgpt.com/codex/settings/usage](https://chatgpt.com/codex/settings/usage) 여기서 사용량 확인가능합니다.

![Image](https://upload.cafenono.com/image/slashpageHome/20260312/233633_hcHecdcNKv9zqtdLyd?q=80&s=1280x180&t=outside&f=webp)

- 게이트웨이 설치 ( 저는 이미 설치되어 있어서 이렇게 나온겁니다)

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/123602_kFMJLiU2SQO79w5CCx?q=80&s=1280x180&t=outside&f=webp)

    - Restart / Reinstall / Skip 상관없습니다

- 봇을 어떻게 실행시킬건지 물어봅니다

    - 저는 open the web UI를 권장드려요

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/123645_GgcTT78hIbUMOwHFK9?q=80&s=1280x180&t=outside&f=webp)

## 직원 추가하기

- 텔레그램 봇 만들기

    - 봇파더 검색(@botfather) 

    -  /newbot 이용해서 봇 만들기

- 

![Image](https://upload.cafenono.com/image/slashpageHome/20260312/233808_NjRD1bwTxTvUGBT60H?q=80&s=1280x180&t=outside&f=webp)

-봇이름(내화면에서 보이는) 
'윈도우테스트봇'

-실제 봇아이디(텔레그램에서 사용하는) 'test0306clawbot'

-발급받은 토큰(http api) 
'8634006604~~'

- 오픈클로 에이전트 추가하기

    - `openclaw agents add 봇이름` 

    - `openclaw agents add paperbot` 

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/124905_pFkxTtGunhiH9ulVys?q=80&s=1280x180&t=outside&f=webp)

- 처음에 워크스페이스-봇이름 형태로 폴더를 만들어줍니다.

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/124947_kpbEZn7G2H6Xw8FDtF?q=80&s=1280x180&t=outside&f=webp)

- 메인 봇의 정보를 가져다 쓸건지 물어봅니다. 이건 상황에 맞게 선택해주세요

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/125031_E5wgEUgFZkQLJkhmZe?q=80&s=1280x180&t=outside&f=webp)

- 모델/어스 설정을 할거냐라고 물어봅니다. 기존에 Chatgpt oauth를 사용중이라면 별도 설정이 필요없습니다. 

    - 다른 모델을 테스트하고 싶다면 yes를 눌러서 설정할수 있어요

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/125220_IwCHSCtMbt5JHYJkDq?q=80&s=1280x180&t=outside&f=webp)

- 채널설정을 할건지 물어봅니다. 텔레그램 연결해야하니 yes를 눌러주세요

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/125258_4ESiLlf1hugYsP2nGG?q=80&s=1280x180&t=outside&f=webp)

- 텔레그램을 선택합니다

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/125330_H99vA2SihNnWgyQUcW?q=80&s=1280x180&t=outside&f=webp)

- ●modify settings 선택

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/125354_47R6VlY5rDA9VJg0y3?q=80&s=1280x180&t=outside&f=webp)

- ●add a new account 선택

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/125421_BHFtYnMuP885urPvyU?q=80&s=1280x180&t=outside&f=webp)

- new Telegram account id에 ** 실제 봇아이디**를 넣어주세요

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/125447_s5waYArKfwLFu9T0uH?q=80&s=1280x180&t=outside&f=webp)

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/125710_zmjjK9kdHK4QLQCTBx?q=80&s=1280x180&t=outside&f=webp)

- 봇 토큰을 입력합니다

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/130021_ju53ciHQFMFQQWtTpt?q=80&s=1280x180&t=outside&f=webp)

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/130043_Yb5YLzsv7QspYPQEge?q=80&s=1280x180&t=outside&f=webp)

- 종료가 되지 않고 다시 설정화면으로 넘어오는데 당황하지 마세요

    - ●finished를 선택하여 빠져나옵니다

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/130113_rEVFqtb4RmYvBR1ICq?q=80&s=1280x180&t=outside&f=webp)

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/130139_EopYR93H13bJNXXo4y?q=80&s=1280x180&t=outside&f=webp)

- 이제 DM 을 설정합니다 

    - ●yes

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/130242_N0h61uMfog9DLsETNN?q=80&s=1280x180&t=outside&f=webp)

    - ●pairing을 추천

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/130302_XqoV7RvTbYRVtAR4TF?q=80&s=1280x180&t=outside&f=webp)

- 오픈클로 에이전트와 바인딩을 위해 yes를 선택해주세요

    - ●yes

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/130334_TMcN42Fux4AWBKdWH5?q=80&s=1280x180&t=outside&f=webp)

- 봇 연동 완료 

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/130449_EzS9D0E2q95boEraQd?q=80&s=1280x180&t=outside&f=webp)

- 텔레그램에 들어가서 인사를 나눠봅시다

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/130520_3iBANLNjcuq0LmQgoE?q=80&s=1280x180&t=outside&f=webp)

- 페어링을 해야해요, 아래 명령어를 복사해서 넣어주세요

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/130541_8d7SBO43h6xYZbqDpB?q=80&s=1280x180&t=outside&f=webp)

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/130621_ezNwEFs30neT9v58FS?q=80&s=1280x180&t=outside&f=webp)

- 이제 연결이 완전히 됐습니다. 한국어로 편하게 이야기해보세요

![Image](https://upload.cafenono.com/image/slashpageHome/20260404/130707_kQzZJiXgQGMU230hph?q=80&s=1280x180&t=outside&f=webp)

### 에이전트 권한 설정, 풀백 지정

![Image](https://upload.cafenono.com/image/slashpageHome/20260626/113438_YtdlXQsYq3BFER9e4a?q=80&s=1280x180&t=outside&f=webp)

### 텔레그램연결, 기능추가

/think : 추론강도 설정

/models : 모델, 프로바이더 변경

/verbose on : 툴콜링 내부 호출 로그 활성화

/setthreads : 봇 내에 주제별로 쓰레드를 관리해주는 기능 활성화

![Image](https://upload.cafenono.com/image/slashpageHome/20260626/112947_MuuKRU8cCj3QEif2Qq?q=80&s=1280x180&t=outside&f=webp)

:/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

윈도우: 

접속하기(구글 로그인)

Google Cloud Platform

gmail api 신청하기

![Image](https://upload.cafenono.com/image/slashpageHome/20260626/122456_idsYjJyD7U6haRY8YL?q=80&s=1280x180&t=outside&f=webp)

![Image](https://upload.cafenono.com/image/slashpageHome/20260626/122534_T8fVysYKMBLtulCZk7?q=80&s=1280x180&t=outside&f=webp)

gog auth add 이메일주소 --services gmail 

또는 

![Image](https://upload.cafenono.com/image/slashpageHome/20260626/122640_8JYEdolamGYRxybpwP?q=80&s=1280x180&t=outside&f=webp)

### 상용 하네스 활용, 제작, 루프 만들기

가장 쉬운 방법 : codex app의 녹화 기능 활용하기 (스킬 녹화 , mac only)

![Image](https://upload.cafenono.com/image/slashpageHome/20260626/113231_zUdumXnWAnZeFbxYn7?q=80&s=1280x180&t=outside&f=webp)

두번째 방법: 일을 시키고 완료 후에 '회고해줘'라고 하기

세번째 방법: 스킬 크리에이터로 스킬을 만들어달라고 하거나 스킬 워크샵에 올라온걸 승인하기

![Image](https://upload.cafenono.com/image/slashpageHome/20260626/113404_9iKmlQdBLx2pzn9o9D?q=80&s=1280x180&t=outside&f=webp)

### 논문 자동화 하네스 도구 소개

For the site tree, see the [root Markdown](https://slashpage.com/conanssam.md).