(우분투 - 미니PC) OpenClaw 사용하기

설치 (링크)

설치 명령은 굉장히 심플하다. 

# 설치 스크립트
$ curl -fsSL https://openclaw.ai/install.sh | bash

# 중간에 잘못된 선택을 하면 그냥 아래 명령으로 처음부터 다시 할 수 있다.
$ openclaw onboard

 

보안 어쩌고 저쩌고 무서운 이야기가 나온다. yes를 해야 넘어감.

 

기본 LLM 모델을 선택해야한다. 나는 코파일럿 계정이 있어서 코파일럿으로..

 

코파일럿 모델 중에 무료 LLM을 선택하면 추가비용없이 사용가능하다.

맥미니를 로컬 LLM을 셋팅해서 사용하는 가이드가 많던데 생각보다 성능이 나오지 않는다는 평이많다.

반대로 API를 연결해서 사용하면 비용을 감당하지 못하는 사태가 발생한다고.

 

채널은 개인의 선택...

텔레그램 access token을 얻는 방법은 많이 정리되어 있다. (https://youtu.be/3XhbI597gm8?t=259)

 

skills을 설정하는 화면이다.

여기서는 그냥 넘어가자. 인스톨시, blew 명령어를 사용하는데 해당 명령어는 맥OS에서 사용가능해서 여기서는 어짜피 안된다.

어떻게 blew 명령어를 강제로 빌드해서 인스톨하는 방법이 있는 것 같은데 정신건강에 해로운 방향인 것 같다.

 

몇 개의 스텝을 지나서 아래와 같은 메시지를 만난다.

 

아래처럼 서비스가 수행중임을 알 수 있다.

 

이제 거의 마지막 메시지.

 

빨간색은 GATEWAY 토큰과 관련된 정보이다. 크롬 브라우저 연동을 위해서 나중에 필요하게 되니 알아두자.

노란색은 openclaw에게 페르소나를 지정하기 위해서 Start TUI를 해달라는 요청이다.

시키는데로 하자.

 

여기까지 진행하고 ./openclaw/workspace/IDENTITY.md 파일을 살펴보면 아래와 같이 수정된 것을 알 수 있다.

나중에 수정을 원할때는 직접 수정해도 될 듯.

 

최초 설치라면, 터미널을 다시 띄워야 명령어를 사용할 수 있다.

~/.bashrc을 실행해야하기 때문이다. npm을 통해 인스톨된 openclaw를 확인할 수 있다.

 

아래는 설치 후, 제대로 설치가 되었는지 확인하기 위한 명령어들이다.

# 설치 후, 상태확인
$ openclaw doctor         # check for config issues
$ openclaw status         # gateway status
$ openclaw dashboard      # open the browser UI

 

나 같은 경우는 `openclaw docker`에서 아래와 같은 이슈를 만났다.

 

대화가 계속 쌓이다 보면 별도의 DB에 저장을 해야하고 나중에 과거 이력을 조회하기 위해서는 'Semantic Recall'을 해야한다.

저장하고 찾기 위해서는 'embedding' 이라는 기술이 필요한데. 이거를 제공해줄 서비스 KEY를 달라는 의미다.

 

선택가능 옵션 중에 하나를 취하면 된다. disable을 해도 되고. 나는 GEMINA_API_KEY가 있어서 그거를 넣어줬다.

아래는 GEMINI API KEY를 얻는 방법. (https://youtu.be/KH_FFtGIaUM?t=392)

# 아래 파일에 키를 넣어줍니다.
$ vi ~/.openclaw/.env

# gateway를 재시작 시킵니다.
$ openclaw gateway restart

# 경고가 사라졌는지 확인합니다.
$ openclaw doctor

 

업데이트 (링크)

주목받고 있는 프로젝트라서 빠르게 발전하고 있다. 그리고 보안관련된 대응도 있으니 자주 해주면 좋을 것 같다.

# 설치명령과 동일하다.
$ curl -fsSL https://openclaw.ai/install.sh | bash

 

위 명령어로 업데이트 하는 것을 권장하고 있지만 아래 처럼 UI를 통해서 자동 업데이를 걸어둘 수도 있다.

Dashboard에서 Config --> Updates로 이동하면 '자동 업데이트'를 지정할 수 있다.

 

 

제거 (링크)

수작업도 있는 것 같은데 이게 제일 깔끔하다. 명령어 실행 후, 디렉토리가 깔끔히 사려졌다. 조심해서 사용해야할 듯.

$ openclaw uninstall

$ ls ~/.openclaw
ls: '/home/kkangeva/.openclaw'에 접근할 수 없음: 그런 파일이나 디렉터리가 없습니다

 

 

명령어 실행시, 아래와 같은 화면을 볼 수 있다.

지울 범위를 선택가능하다.

 

openclaw 자체를 제거되지 않는다. npm을 통해서 별도 제거해야한다.