본 글은 내삶자동화 스터디장 님의 '사례글 자동화 스킬'을 활용해서 올렸습니다.
(제 문체가 아닙니다 ㅎㅎ)
easyclaw부터 토큰 연결까지, OpenClaw 온보딩 시행착오 기록
초보 사용자 관점에서 정리한 명령어 혼선·환경설정·권한 이슈 해결 메모
이번 OpenClaw 세팅에서 가장 크게 느낀 점은, 기능 자체보다 초기 연결 구조를 이해하는 과정이 더 어렵다는 것이었다.
에러가 뜰 때마다 원인을 바로 특정하기보다는, 캡처를 공유하고 Claude/텔레그램 봇에 계속 물어보며 하나씩 풀어갔다.
심지어 한 번은 재시동만으로 해결된 이슈도 있었다.
───
1) easyclaw와 openclaw 명령어 혼선
처음에는 easyclaw가 OpenClaw 설치를 쉽게 도와주는 사이트라는 개념 자체를 몰랐다.
그래서 자연스럽게 명령어도 easyclaw라고 부르는 혼선이 생겼다.
초보자 입장에서는 “브랜드/사이트 이름”과 “실제 CLI 명령어”가 다를 수 있다는 점이 생각보다 큰 진입장벽이었다.
이후에는 설명보다 복붙 가능한 정확한 명령어를 먼저 확인하는 습관이 훨씬 도움이 됐다.
───
2) 설치 후에도 막히는 환경 이슈 (원인 단정보다 대응 중심)
설치가 된 것 같은데도 명령이 안 먹거나, 환경 설정 문제처럼 보이는 상황이 반복됐다.
다만 당시에는 원인을 정확히 규명했다기보다,
• 캡처해서 질문하기
• 제안된 조치 실행하기
• 안 되면 다른 경로로 다시 시도하기
이 흐름으로 해결해 나갔다.
결국 느낀 건 “설치 성공”과 “실행 가능한 상태”는 다를 수 있다는 점이었다.
특히 PATH 반영 같은 기본 환경 설정은 초반에 반드시 체크해야 한다.
───
3) 권한/세션 꼬임처럼 보이는 문제와 재시동 해결
일부 문제는 논리적으로 원인을 끝까지 특정하지 못했지만, 실제로는 재시동 후 정상화되는 경우가 있었다.
초기 세팅에서는 완벽한 원인 분석도 중요하지만,
재시동·셸 재시작·경로 재적용 같은 빠른 복구 루틴이 시간 절약에 더 효과적일 때가 있었다.
───
가장 어려웠던 지점: 토큰/OAuth/API 연결 이해
내 체감상 가장 어려운 구간은 토큰 연결이었다.
대시보드 페이지는 열리는데, 실제 인증이 완료된 상태가 아니라서 계속 막히는 경험이 있었다.
또 OAuth 연결, API 연결의 차이를 처음부터 명확히 이해하지 못해 시행착오가 생겼다.
처음엔 Codex로 연결했었지만 ChatGPT API 연결이 필요하다고 생각해서 10달러를 미리 구매했고,
연결 자체는 성공했지만 API 비용 부담도 체감했다.
이후 오프라인에서 버디님 피드백을 통해
“지금 방식보다 저렴하게 운영할 수 있는 방법이 있을 수 있다”는 점을 알게 됐다.
즉, 온보딩에서는 단순 설치 가이드뿐 아니라 아래가 함께 필요하다고 느꼈다.
• 어떤 연결 방식이 필요한지
• 어떤 경우에 비용이 커지는지
• 비용 절감 옵션이 무엇인지
───
설치 경로별 체감 차이
easyclaw 경로에서는 터미널 깊이 들어가지 않아도 API 연결 단계까지 비교적 자연스럽게 이어졌는데,
다른 경로에서는 원하는 모델(Codex 5.4) 선택지가 바로 보이지 않았다.
설치 경로나 환경에 따라 보이는 모델/옵션 리스트가 달라질 수 있다는 점도 혼란 포인트였다.
Codex 5.4를 쓰고 싶었던 이유는 토큰 효율 대비 비용 때문이었다.
Claude 구독 연결도 고려했지만, 계정/정책 리스크 가능성도 함께 알게 됐다.
그래서 맥 미니가 도착하면, 다음 세팅은 OpenClaw 공식 경로 기준으로 다시 정리해볼 계획이다.
───
미래의 나를 위한 메모
• 터미널에서 /status를 입력한 뒤, /models에서 모델을 클릭해 바꿀 수 있다.
• 터미널에서 openclaw dashboard를 입력하면 대시보드 접속 URL을 확인할 수 있다.
• 보안 이슈의 본질은 OpenClaw에 어디까지 권한을 열어두는가에 있다.
텔레그램 계정 노출 시, 허용된 범위 안에서 파일 조작/삭제 위험까지 이어질 수 있다.
• 네이버/구글 메일은 가능하면 부계정 분리로 운영하는 것이 안전하다.
• 정기님 출연 영상은 아직 안 봤다. 추천을 받았고, 찾아볼 예정이다.
• 다혜님의 AI 토크와 뽀짝이와 연재하신 노트를 통해 OpenClaw의 큰 그림을 먼저 잡고 스터디에 들어온 것이, 실제 시행착오를 줄이는 데 도움이 됐다.
───
마무리
이번 경험을 한 줄로 정리하면,
OpenClaw 온보딩의 병목은 기능이 아니라 연결(토큰/인증) 이해와 환경·권한 세팅이었다.
그래도 캡처 기반으로 질문하고 하나씩 해결해 나가면,
초반 장벽은 충분히 넘을 수 있다는 확신을 얻었다.
P.S. 제 봇 이름은 부모님 댁 강아지 이름인 ‘젤로’로 정했어요!
