OpenClaw 튜토리얼, 초보자 설치부터 텔레그램 연결과 보안 점검까지

OpenClaw 튜토리얼을 빈 기기 하나에서 시작해 처음 며칠 운영하는 법까지 96단계로 정리했습니다. 설치 명령, 온보딩 설정값, OpenRouter API 키, 텔레그램 봇과 허용 목록, 설치 직후 돌리는 보안 프롬프트, Brave 웹 검색, 첫 일일 작업까지 순서대로 따라 하면 됩니다. 영어 영상이라 프롬프트는 원문과 한국어를 함께 싣고, 영상에서 화면으로만 지나간 명령은 공식 안내 기준으로 채웠습니다.

OpenClaw 튜토리얼에서 다루는 범위

발표자 Bart Slodyczka가 OpenClaw(오픈클로, 내 기기에서 돌아가며 메신저로 대화하고 일을 처리하는 AI 에이전트 프로그램)를 빈 기기에 처음부터 끝까지 설치하는 실습입니다. 기기 선택, 설치 명령 실행, 온보딩(처음 실행할 때 설정을 묻는 대화형 과정) 설정값, OpenRouter API 키, 텔레그램 봇 연결, 허용 목록, 보안 프롬프트, Brave 웹 검색, 첫 며칠 운영법까지 한 번에 다룹니다.

이 튜토리얼을 찾는 사람은 두 부류로 갈립니다. 무서워서, 또는 방법을 몰라서 설치를 못 하는 쪽. 그리고 설치는 했는데 들떠서 한꺼번에 너무 많은 걸 시도하다 시간과 토큰만 쓰고 의욕을 잃는 쪽.

그래서 이 튜토리얼이 미는 방식이 "MVP"(최소 기능 제품, 꼭 필요한 것만 갖춘 첫 버전)입니다. 최소한만 설정해서 일단 써 본다. 뭘 하고 싶은지 감이 잡히면 그때 지우고 다시 설치하면서 설정과 보안을 제대로 잡는다. 아래 96단계도 그 최소 구성입니다.

시작 전 준비물

• 메인 컴퓨터가 아닌 전용 기기 1대. 낡은 노트북, 구형 컴퓨터, 맥 미니, 라즈베리 파이, VPS(월 사용료를 내고 빌려 쓰는 원격 서버) 중 하나입니다. 발표자 본인은 라즈베리 파이를 쓰고 데모도 그 기기로 진행합니다.
• 그 기기의 터미널 접근 권한. 터미널은 글자로 명령을 내리는 검은 창입니다.
• 오픈라우터(OpenRouter) 계정. 여러 회사의 AI 모델을 API 키 하나로 쓰게 해 주는 중개 서비스입니다.
• 텔레그램 계정.
• 브레이브(Brave) 계정. 13장 웹 검색에 필요합니다.
• 비용: OpenRouter 크레딧 5~10달러 충전이 권장치입니다. Brave 무료 플랜은 충전이 필요 없습니다. 요금은 바뀔 수 있으니 각 서비스의 공식 안내를 확인해야 합니다.

시작하기 전에 짚어 둘 오픈클로 보안 문서의 한 대목이 있습니다. "완벽하게 안전한 설정은 없다." 목표는 세 가지를 의도적으로 정하는 것입니다. 누가 내 봇에게 말을 걸 수 있는가, 봇이 어디서 행동할 수 있는가, 봇이 무엇을 건드릴 수 있는가.

1장. 설치할 기기를 고른다 (1~3단계)

1. 메인 컴퓨터를 후보에서 뺀다.

   • 이유: 오픈클로가 침해되면 그 컴퓨터의 파일, 문서, 비밀번호에 접근할 수 있다.
   • 확인: 지금 정한 기기에 내 은행, 이메일, 업무 계정이 로그인돼 있지 않다.

2. 전용 기기 하나를 정한다.

   • 후보: 낡은 노트북 / 구형 컴퓨터 / 맥 미니 / 라즈베리 파이 / VPS 중 택1.
   • 확인: 그 기기의 전원이 켜지고 터미널을 열 수 있다.

3. VPS를 골랐다면 "원클릭 이미지"는 쓰지 않기로 한다.

   • 예: 디지털오션(Digital Ocean)의 배포 버튼, 호스팅어(Hostinger)의 원클릭 배포 버튼 같은 것.
   • 주의: 남이 미리 구성해 둔 버전이라 나중에 설정 변경이 어렵거나 아예 불가능할 수 있다. 오픈클로 측도 서드파티 원클릭 이미지를 권하지 않는다.
   • 대안: 빈 서버에서 직접 설치한다.
   • 확인: 아무것도 설치 안 된 깨끗한 상태의 기기가 준비됐다.

2장. OpenClaw 설치 명령을 실행한다 (4~8단계)

순서 고정 구간입니다.

4. 오픈클로 안내 페이지에서 설치 명령어를 복사한다.
   • 찾는 법: 영상은 명령 문자열을 읽어 주지 않는다. 브라우저에서 openclaw.ai에 들어가면 첫 화면에 한 줄 설치 명령이 있다. 맥, 리눅스, 라즈베리 파이 기준으로는 보통 아래 형태이며, 페이지에 적힌 것과 다르면 페이지를 따른다.
   • 확인: 클립보드에 명령어 한 줄이 들어 있다.

curl -fsSL https://openclaw.ai/install.sh | bash

5. 1장에서 정한 기기의 터미널을 연다.

   • 위치: 라즈베리 파이라면 라즈베리 파이에서 직접 터미널 앱을 연다. 맥이라면 Cmd+Space를 누르고 terminal을 입력한다. VPS라면 내 컴퓨터 터미널에서 ssh 사용자명@서버IP로 접속한다.
   • 확인: 커서가 깜빡이는 검은 창이 떴다.

6. 복사한 명령어를 터미널에 붙여 넣는다.

   • 확인: 터미널 한 줄에 명령어가 표시된다.

7. 엔터를 눌러 실행한다.

   • 확인: 설치가 시작되고 세 가지가 차례로 진행된다. 사전 요구사항(prerequisites, Node.js 같은 필수 프로그램) 확인과 자동 다운로드, 오픈클로 다운로드와 설치, 설치 마무리 후 온보딩 화면 자동 실행.

8. 온보딩 화면이 뜰 때까지 기다린다.

   • 확인: 설정을 묻는 대화형 질문 화면이 나타난다.

3장. 온보딩 기본 설정을 고른다 (9~14단계)

순서 고정 구간입니다. 원칙은 하나입니다. 설정 하나하나에 발목 잡히지 말고 최소한만 고르고 넘어간다. 항목 이동은 방향키, 선택은 엔터입니다.

9. "보안 위험을 이해했는가" 질문에 예(yes)를 고른다.

   • 확인: 다음 질문으로 넘어간다.

10. 온보딩 방식에서 manual onboarding(수동 온보딩)을 고른다.

    • 확인: 수동 설정 항목들이 이어서 나온다.

11. 게이트웨이 항목은 local gateway(로컬 게이트웨이) 그대로 둔다.

    • 참고: 게이트웨이는 AI 모델과 메신저 사이에서 메시지를 주고받는 오픈클로의 중심 프로그램이다. local이면 이 기기 안에서 돈다.
    • 확인: 값이 local로 유지된 채 다음으로 넘어간다.

12. 설치 디렉터리는 제시된 기본값을 수락한다.

    • 확인: 디렉터리 경로가 확정된다.

13. AI 공급자 목록에서 OpenRouter(오픈라우터)를 고른다.

    • 이유: "적어도 처음에는" OpenRouter가 권장된다. API 키 하나로 OpenAI, Google, Anthropic 계열과 오픈소스 모델 전부에 접근할 수 있기 때문이다.
    • 확인: 선택 항목이 OpenRouter로 표시된다.

14. 엔터를 눌러 OpenRouter를 확정한다.

    • 확인: API 키를 입력하라는 화면이 나온다.

발표자가 제시한 모델 가격 비교

아래 가격과 평가는 모두 발표자의 주장입니다.

• 오픈소스 모델: 입력 100만 토큰당 30센트, 출력 100만 토큰당 1달러 10센트. 이 모델이 Claude Opus 4.6 급이라고 "그렇다고들 한다"는 전언 형태로 말합니다.
• Claude Opus 4.6: 입력 100만 토큰당 5달러, 출력 100만 토큰당 25달러.
• 미니맥스(MiniMax)는 직접 써 봤고 "시작용, 데일리 드라이버로 아주 좋다"고 평가합니다.

토큰은 AI가 글을 읽고 쓰는 단위로, 대략 글자 조각이라고 보면 됩니다. 실제 가격은 수시로 바뀌니 OpenRouter의 모델 페이지에서 확인해야 합니다.

4장. OpenRouter API 키를 만든다 (15~24단계)

15. 브라우저에서 OpenRouter 계정을 만든다.

    • 확인: OpenRouter에 로그인된 상태가 된다.

16. credits(크레딧) 탭으로 들어간다.

    • 확인: 잔액과 충전 화면이 보인다.

17. 5~10달러를 충전한다.

    • 참고: 결제 정보 입력은 본인이 직접 한다.
    • 확인: 크레딧 잔액이 0이 아니게 표시된다.

18. API keys(API 키) 탭으로 이동한다.

    • 확인: 키 목록 화면이 보인다.

19. create a new API key(새 API 키 만들기)를 클릭한다.

    • 확인: 이름을 입력하는 창이 뜬다.

20. 키에 이름을 입력한다.

    • 참고: 알아볼 수 있으면 아무 이름이나 된다. 예를 들어 "openclaw-pi"처럼 기기 이름을 붙이면 나중에 관리하기 쉽다.
    • 확인: 이름 칸이 채워졌다.

21. create(만들기)를 클릭한다.

    • 확인: 키 문자열이 화면에 표시된다.

22. 그 키를 복사한다.

    • 주의: API 키는 남에게 보이면 안 되는 비밀값이다. 키를 만들 때 사용 한도(credit limit)를 걸 수 있다면 걸어 두는 편이 안전하다.
    • 확인: 클립보드에 키가 들어갔다.

23. 터미널의 온보딩 화면으로 돌아가 키를 붙여 넣는다.

    • 확인: 입력란에 키가 들어갔다.

24. 엔터를 누른다.

    • 확인: 모델 선택 목록으로 넘어간다.

5장. 모델, 포트, 게이트웨이를 설정한다 (25~32단계)

25. 모델 목록에서 아래로 내려가 Claude Sonnet 4.6을 고른다.

    • 확인: 선택 커서가 Claude Sonnet 4.6에 있다.

26. 엔터를 눌러 모델을 확정한다.

    • 확인: 포트를 묻는 화면이 나온다.

27. 제시된 포트를 그대로 수락한다.

    • 참고: 포트는 프로그램이 통신에 쓰는 번호다. 같은 기기에서 이미 다른 오픈클로 인스턴스가 그 포트를 쓰고 있다면 다른 번호로 바꾼다. 발표자는 이 경우여서 직접 변경했다.
    • 확인: 포트가 확정된다.

28. 엔터를 누른다.

    • 확인: gateway bind 설정으로 넘어간다.

29. gateway bind를 loopback으로 유지한다.

    • 참고: loopback은 이 기기 안에서 오는 접속만 받는다는 뜻이다. 바깥에서 게이트웨이에 직접 들어올 수 없어 안전하다.
    • 확인: 값이 loopback이다.

30. 토큰 항목에서 recommended(권장) 토큰을 고른다.

    • 확인: 권장 옵션이 선택돼 있다.

31. Tailscale(테일스케일, 바깥에서 내 기기에 안전하게 접속하게 해 주는 사설망 서비스)은 off 상태로 둔다.

    • 확인: Tailscale이 off로 표시된다.

32. 엔터를 눌러 토큰을 생성한다.

    • 확인: 토큰이 만들어졌다는 표시가 나온다.

6장. 첫 채널로 텔레그램 봇을 만든다 (33~44단계)

순서 고정 구간입니다.

33. 채널 선택에서 Telegram bot(텔레그램 봇)을 고른다.

    • 확인: 봇 토큰을 요구하는 화면이 나온다.

34. 텔레그램 앱이나 웹에 로그인한다.

    • 확인: 내 대화 목록이 보인다.

35. BotFather(봇파더)와 새 대화를 시작한다.

    • 위치: 텔레그램 검색창에서 BotFather를 찾는다. 이름 옆에 파란 인증 표시가 있는 공식 계정을 고른다.
    • 확인: 봇파더와의 대화창이 열렸다.

36. 대화창에 명령어를 입력한다.

    • 확인: 입력창에 명령어가 보인다.

/newbot

37. 엔터를 눌러 전송한다.

    • 확인: 봇파더가 봇 이름을 물어본다.

38. 봇의 설명적인 이름(descriptive name)을 입력한다.

    • 확인: 봇파더가 두 번째 이름(username)을 물어본다.

39. 두 번째 이름(username)을 입력한다.

    • 주의: 반드시 bot으로 끝나야 하고, 하이픈(-)은 쓸 수 없으며, 띄어쓰기 대신 언더스코어(_)를 쓴다.
    • 확인: 입력창에 조건을 만족하는 이름이 들어 있다.

40. 엔터를 눌러 전송한다.

    • 확인: "봇이 만들어졌다"는 메시지와 함께 토큰이 표시된다.

41. 봇 토큰(API key)을 복사한다.

    • 주의: 이 토큰이 있으면 누구나 내 봇을 조종할 수 있다. 다른 사람에게 보여 주지 않는다.
    • 확인: 클립보드에 토큰이 들어갔다.

42. 터미널 온보딩 화면에 봇 토큰을 붙여 넣는다.

    • 확인: 입력란에 토큰이 들어갔다.

43. 목록에서 맨 아래 finished(완료)까지 내려간다.

    • 확인: 커서가 finished에 있다.

44. 엔터를 누른다.

    • 확인: DM 접근 정책(DM access policies) 설정으로 넘어간다.

7장. 누가 봇과 대화할 수 있는지 정한다 (45~52단계)

45. DM 접근 정책에서 allow list(허용 목록)를 고른다.

    • 이유: 여기 넣은 사용자만 봇과 대화할 수 있다. 발표자가 선호하는 방식이다.
    • 확인: 사용자 ID 또는 사용자명을 입력하라는 화면이 나온다.

46. 텔레그램으로 돌아간다.

    • 확인: 텔레그램 화면이 앞에 있다.

47. 햄버거 메뉴(≡)를 클릭한다.

    • 확인: 메뉴가 펼쳐진다.

48. 내 프로필을 클릭한다.

    • 확인: 프로필 화면이 열린다.

49. 그 페이지의 주소창(URL)을 본다.

    • 이유: 사용자명(username)을 복사하는 방식은 이 설정에서 잘 안 되는 경우가 있다. URL에서 숫자로 된 사용자 ID를 찾는 쪽이 확실하다.
    • 대안: 텔레그램 웹이 아니라 휴대폰 앱이라 주소창이 없다면, 사용자 ID를 알려 주는 봇(예: userinfobot)에게 말을 걸어 숫자 ID를 받는 방법도 있다.
    • 확인: URL 안에 숫자로 된 사용자 ID가 보인다.

50. 숫자만 복사한다. 다른 문자는 포함하지 않는다.

    • 주의: "숫자만, 다른 건 아무것도 복사하지 말라"는 것이 이 단계의 핵심이다.
    • 확인: 클립보드에 숫자만 들어 있다.

51. 터미널 입력란에 붙여 넣는다.

    • 확인: 숫자가 입력란에 표시된다.

52. 엔터를 누른다.

    • 확인: 스킬(skills) 선택 화면으로 넘어간다.

8장. 남은 온보딩을 마무리한다 (53~61단계)

53. 스킬(skills) 목록을 눈으로 한 번 훑어본다.

    • 참고: 스킬은 에이전트에 꽂아 쓸 수 있는 사전 제작 도구들이다. 처음엔 아무것도 설정하지 말고 구경만 한다.
    • 확인: 여러 도구 이름이 나열된 걸 확인했다.

54. 스페이스바를 눌러 skip(건너뛰기)을 선택한다.

    • 확인: skip에 선택 표시가 생겼다.

55. 엔터를 누른다.

    • 확인: 추가 API 키를 묻는 질문이 나온다.

56. 추가 API 키 질문에 no로 답한다. 이어지는 같은 질문에도 계속 no를 고른다.

    • 참고: 영상에서는 no를 여러 번 고른다(자막 나열 기준 4회로 읽힌다).
    • 확인: 질문이 끝나고 훅(hooks) 설정 화면이 나온다.

57. 훅(hooks)을 전부 활성화한다.

    • 참고: 훅은 시작할 때나 명령을 실행할 때 같은 특정 순간에 자동으로 돌아가는 동작이다. 스페이스바로 하나씩 켠다.
    • 확인: 목록의 모든 훅에 활성 표시가 들어갔다.

58. 엔터를 누른다.

    • 확인: 게이트웨이 서비스 설치 여부를 묻는다.

59. yes를 고르고 엔터를 눌러 게이트웨이 서비스를 설치한다.

    • 참고: 게이트웨이를 백그라운드 서비스로 설치하면 기기를 켤 때마다 자동으로 돈다.
    • 확인: 게이트웨이 서비스 설치가 진행된다.

60. node(노드) 설치 질문에 yes를 고른다.

    • 확인: node 설치가 진행된다.

61. 엔터를 눌러 bash를 활성화한다.

    • 확인: 온보딩이 완료됐다는 표시가 나오고, 화면 위쪽에 "dashboard is ready"가 보인다.

9장. 대시보드를 열고 첫 메시지를 보낸다 (62~64단계)

대시보드는 브라우저에서 에이전트와 대화하고 설정을 보는 웹 화면입니다.

62. 화면 위쪽에 표시된 토큰 포함 대시보드 URL 링크를 복사한다.

    • 확인: 클립보드에 링크가 들어갔다.

63. 그 링크를 붙여 넣어 대시보드를 연다.

    • 주의: 자막은 "터미널에 붙여 넣으라"고 하지만 대시보드는 웹 화면이라 브라우저 주소창에 붙여 넣는 것이 맞을 가능성이 크다. 브라우저에서 먼저 시도한다. 링크를 잃어버렸다면 터미널에서 openclaw dashboard를 실행하면 대시보드를 다시 열 수 있다.
    • 확인: 오픈클로 대시보드 화면이 뜬다.

64. 대시보드 입력창에 테스트 메시지를 보낸다.

    • 확인: 에이전트의 답장이 돌아온다.

Hi there

10장. 첫 대화로 에이전트를 세팅한다 (65~67단계)

65. 에이전트가 던지는 질문에 답하며 5~10분 대화한다.
    • 위치: 대시보드 대화창.
    • 내용: 질문은 에이전트가 누구인지, 내가 누구인지, 우리 목표가 뭔지다. 새 에이전트를 배포할 때마다 같은 방식의 첫 대화가 열린다.
    • 주의: 완벽하게 하려 들지 말 것. 목적은 "일단 첫 대화를 끝내는 것"이다.
    • 확인: 내 이름, 에이전트의 정체, 목표를 대화로 전달했다.

첫 대화에서 무슨 말을 할지 막막하다면 이렇게 한 번에 던져도 됩니다.

내 이름은 OO이고 서울에 살아. 평일에는 회사 일, 주말에는 블로그를 해.
너는 내 개인 비서로, 매일 아침 필요한 소식을 정리하고 할 일을 챙겨 주면 돼.
답은 한국어로, 짧고 핵심만 말해 줘.

66. 에이전트 탭의 files로 들어가 MD 파일들이 생겼는지 확인한다.
    • 위치: 대시보드의 agents 탭 → files.
    • 확인: 아래 파일들이 보인다.

• agents.md: 대화할 때 쓰이는 에이전트의 지시문 세트.
• bootstrap.md: 최초 1회 실행 시 쓰이는 온보딩 대화 프롬프트. "네가 누구인지, 누구와 일하는지, 목표가 뭔지 파악하라"고 지시한다.
• soul.md: 성격과 캐릭터.
• identity.md: 에이전트의 정체성. 어떻게 동작할지 알려 주면 채워진다.
• user.md: 에이전트가 보는 "나". 이름, 시간대, 소통 시 특이사항, 프로젝트 맥락.
• research.md 같은 확장 파일: 리서치 에이전트를 만들면 직접 만들게 할 수 있다.

MD 파일은 마크다운(# 제목과 - 목록으로 쓰는 단순한 텍스트 형식) 파일입니다. 에이전트는 이 파일들을 직접 고칠 수 있습니다. 며칠 뒤 소통 방식을 바꾸고 싶으면 "네 설정 파일을 업데이트하라"고 시키면 됩니다.

67. 대화가 끝나면 세션을 리셋한다.
    • 방법: 리셋 버튼의 정확한 위치는 영상에 나오지 않는다. 대화창에 /new 또는 /reset을 입력하면 새 세션이 시작된다.
    • 확인: 새 세션에서 대화가 시작된다.

11장. 텔레그램 연결을 테스트한다 (68~69단계)

68. 텔레그램에서 봇파더 대화로 돌아가, 봇이 만들어졌다는 메시지 속 내 봇 링크(t.me/로 시작)를 눌러 봇 대화창을 연다.

    • 확인: 내 봇과의 대화창이 열렸다.

69. 첫 대화이므로 시작(Start) 버튼을 누르거나 인사말을 보내 대화를 시작한다.

    • 확인: 에이전트가 보낸 메시지가 도착한다.
    • 참고: 대시보드보다 텔레그램으로 주고받는 쪽이 편하다. 휴대폰에 있어 어디서든 접근할 수 있으니까.

12장. OpenClaw 보안 프롬프트를 실행한다 (70~74단계)

순서 고정 구간이며 이 튜토리얼의 핵심입니다. 에이전트에게 실제 업무를 맡기기 전에 이 프롬프트들을 먼저 돌립니다.

70. 에이전트에게 보안 감사를 요청한다.
    • 원리: 에이전트는 오픈클로가 어떻게 설치됐는지 알고 있고 security audit, health check 같은 명령에 접근할 수 있어서 점검과 권고가 가능하다.
    • 확인: 에이전트가 점검 결과와 개선 권고 목록을 답한다.

Hey, can you please run a security audit of our setup, of our device and our
deployment of Open Claw, and let me know if we have any issues that we should fix?

한국어: 우리 설정, 그러니까 이 기기와 오픈클로 배포 상태에 대해 보안 감사를 돌리고,
고쳐야 할 문제가 있으면 알려줘.

터미널에서 직접 점검하고 싶다면 오픈클로에 내장된 보안 점검 명령을 쓸 수 있습니다. 버전에 따라 옵션이 다를 수 있으니 openclaw --help로 먼저 확인합니다.

openclaw security audit

71. 그 답변을 읽고 무슨 말인지 이해한다.

    • 주의: 특히 강조되는 단계다. 그냥 넘기지 않는다. 모르는 용어가 있으면 "이 권고를 초보자도 알게 쉽게 설명해 줘"라고 되묻는다.
    • 확인: 어떤 문제를 무엇으로 고치겠다는 것인지 파악했다.

72. 모두 동의하면 수정을 지시한다.

    • 확인: 에이전트가 수정을 수행한다.

Can you please fix everything?

한국어: 전부 고쳐 줄 수 있어?

73. 로그 민감정보 마스킹(redaction) 기능을 켜 달라고 요청한다.
    • 원리: 대화 메타데이터에 API 키나 특정 사용자 ID가 섞여 바깥으로 새어 나갈 수 있는데, 오픈클로 백엔드에 이를 가리는 기능이 있다.
    • 주의: 영상 속 기기에서는 기본 상태에서 일부 토큰이 평문(plain text, 암호화나 가림 없이 그대로 읽히는 글자)으로 공유되고 있었다.
    • 확인: 에이전트가 해당 기능과 추가 권고 사항을 답한다.

오픈클로의 민감정보 마스킹 기능을 켜서, 로그로 민감한 정보가 새지 않게 해 줘.

(영어 원문은 영상에서 읽어주지 않았습니다. 화자가 설명한 요청 내용을 옮긴 것입니다.)

74. 권고에 동의한다고 답한다.
    • 확인: 에이전트가 전부 고쳐 준다.

Yes, I agree with all your recommendations. Let's do it.

한국어: 네 권고 전부 동의해. 진행하자.

이 기본 프롬프트 두 번만으로 "인스턴스의 보안이 두 배가 됐다"는 것이 발표자의 표현입니다. 두 배라는 수치의 근거는 영상에 없습니다.

13장. 웹 검색을 붙인다, Brave (75~90단계)

기본 선택지는 브레이브 서치(Brave Search)와 퍼플렉시티(Perplexity) 두 가지입니다. 이미 OpenRouter를 쓰고 있으니 OpenRouter로 Perplexity 웹 검색을 쓸 수도 있습니다. 시작은 무료 크레딧이 있는 Brave가 권장됩니다.

75. 브라우저에서 Brave 계정을 만든다.

    • 참고: 검색창에 "Brave Search API"를 치면 개발자용 가입 페이지가 나온다. 크레딧 충전이 필요 없고, 이 플랜은 초당 1요청 / 월 2,000요청이다.
    • 확인: Brave API 화면에 로그인됐다.

76. add an API key(API 키 추가)를 클릭한다.

    • 확인: 이름 입력 창이 뜬다.

77. 키 이름을 입력한다.

    • 확인: 이름 칸이 채워졌다.

78. add(추가)를 클릭한다.

    • 확인: 키가 생성돼 화면에 표시된다.

79. 그 키를 복사한다.

    • 확인: 클립보드에 Brave API 키가 들어갔다.

방법 A, 에이전트에게 시키기 (쉬움)

80. 에이전트 대화창에 Brave API 키를 붙여 넣는다.

    • 확인: 키가 메시지 입력창에 있다.

81. Brave 웹 검색을 설정해 달라고 요청한다.

    • 확인: 에이전트가 설정을 수행한다.

Hey, can you please set up Brave web search?

한국어: Brave 웹 검색 좀 설정해 줄래?

방법 B, 터미널에서 직접 설정하기

82. 안내 문서의 설정 명령어를 복사한다.
    • 참고: 이 명령어 문자열도 영상에 나오지 않는다. 오픈클로 공식 문서의 웹 검색 설정 안내에 있으며, 보통 아래처럼 웹 설정 구획만 다시 여는 명령이다. 버전에 따라 다를 수 있으니 openclaw configure --help로 확인한다.
    • 확인: 클립보드에 명령어가 들어갔다.

openclaw configure --section web

83. 터미널을 연다.

    • 참고: 앞서 쓰던 세션을 이어 써도 되고 새 세션을 열어도 된다.
    • 확인: 터미널 창이 앞에 있다.

84. 명령어를 붙여 넣고 엔터를 누른다.

    • 확인: 설정 질문이 시작된다.

85. 배포 위치 질문은 local 그대로 둔다.

    • 확인: 값이 local이다.

86. 웹 검색을 Brave로 활성화한다.

    • 확인: Brave가 선택됐다.

87. Brave API 키를 다시 복사해 붙여 넣는다.

    • 확인: 입력란에 키가 있다.

88. 엔터를 누른다.

    • 확인: 다음 질문으로 넘어간다.

89. web fetch(웹 페이지 내용을 직접 가져오는 기능)를 활성화한다.

    • 확인: 설정이 complete(완료)로 표시된다.

웹 검색 검증

90. 에이전트에게 Brave API를 실제로 호출하고 성공 여부를 알려 달라고 시킨다.
    • 확인: 에이전트가 "성공"이라고 답한다.

Brave 웹 검색으로 오늘 AI 관련 뉴스를 하나 찾아보고, 검색이 성공했는지 알려 줘.

14장. 첫 일일 작업을 등록한다 (91~93단계)

91. 에이전트에게 평이한 말로 일일 작업을 요청한다.
    • 원칙: 작게 시작한다.
    • 확인: 에이전트가 일정 작업을 등록했다고 답한다.

Hey, can every day at 8:00 a.m. you send me the latest AI news?

한국어: 매일 아침 8시에 최신 AI 뉴스를 보내줄 수 있어?

92. 그 작업을 며칠 그대로 돌려 본다.

    • 확인: 매일 정해진 시각에 메시지가 도착한다. 시각이 어긋나면 user.md에 내 시간대가 맞게 적혔는지 에이전트에게 물어본다.

93. 익숙해지면 에이전트에게 작업 범위를 넓혀 달라고 말한다.

    • 예: "AI 뉴스 줬으니 날씨도 알려 줘", "리서치 리포트도 줘", "유튜브 영상 아이디어도 줘".
    • 확인: 에이전트가 스스로 작업 범위(scope of work)를 수정한다.

15장. 처음 며칠 운영법, MD 파일 쌓기 (94~96단계)

가장 흔한 실수는 신나서 에이전트를 두세 개 더 배포하고 일을 시키는 것이라는 경고가 이 장의 출발점입니다. 아직 오픈클로로 뭘 할 수 있는지 모르는 상태라 토큰과 시간만 나갑니다.

94. 며칠간 에이전트에게 음성 메모를 여러 개 보낸다.

    • 위치: 텔레그램 대화창. 입력창 옆 마이크 버튼을 누른 채 말하면 음성 메모가 된다.
    • 내용: 지금 생각 중인 것들, 머릿속에 있는 것, 이루고 싶은 목표를 쏟아내는 brain dump(머릿속 생각을 정리 없이 쏟아내기)다.
    • 확인: 에이전트가 음성 메모를 받아 응답한다.

95. 에이전트에게 주제별 MD 파일을 만들게 한다.

    • 예: research.md(리서치 작업), travel.md(여행 관련 이야기).
    • 확인: files 목록에 새 MD 파일이 생긴다.

지금까지 내가 보낸 음성 메모를 주제별로 나눠서 MD 파일로 정리해 줘.
리서치 관련은 research.md, 여행 관련은 travel.md에 모아 줘.

96. 며칠 뒤, 기본 에이전트에게 팀 구성을 요청한다.
    • 확인: 에이전트 여러 개가 만들어지고 각자 할 일을 받는다.

Hey, based on the MD files that we have, can you spin up multiple agents?

한국어: 우리가 갖고 있는 MD 파일들을 근거로 에이전트 여러 개를 만들어 줄래?

OpenClaw 튜토리얼 최종 체크리스트

• 메인 컴퓨터가 아닌 전용 기기에 설치했다
• 설치 명령 실행 후 온보딩이 자동으로 떴다
• OpenRouter API 키를 넣었고 크레딧 5~10달러를 충전했다
• 모델이 Claude Sonnet 4.6으로 설정돼 있다
• gateway bind가 loopback이고 Tailscale은 off다
• 텔레그램 봇 username이 bot으로 끝나고 하이픈 대신 언더스코어를 썼다
• allow list에 내 텔레그램 숫자 사용자 ID만 들어 있다
• 대시보드에서 "Hi there"에 답장이 왔다
• 텔레그램에서도 에이전트 메시지를 받았다
• 보안 감사 프롬프트를 돌리고 수정을 적용했다
• 로그 마스킹(redaction)을 켰다
• Brave 웹 검색이 실제 호출 테스트에서 성공했다
• 첫 일일 작업이 등록됐다

자주 막히는 곳

• 온보딩 중 포트 충돌: 같은 기기에서 다른 오픈클로 인스턴스가 그 포트를 쓰고 있다. 기본 포트를 다른 번호로 바꾼다. 발표자도 이 방법을 썼다.
• 텔레그램 봇 생성 실패: username이 bot으로 끝나지 않거나 하이픈을 썼다. bot으로 끝내고 띄어쓰기 자리는 언더스코어로 바꾼다.
• allow list에 넣었는데 봇이 반응하지 않음: 사용자명 복사 방식이 이 설정에서 잘 동작하지 않는 경우가 있다. 프로필 페이지 URL에서 숫자 사용자 ID만 복사해 넣는다.
• 토큰이 로그에 그대로 노출됨: 기본 상태에서 일부 토큰이 평문으로 공유된다. 에이전트에게 마스킹 기능을 켜 달라고 요청한다.
• 나중에 설정을 바꿀 수 없음: VPS 원클릭 이미지를 썼기 때문이다. 빈 서버에서 직접 설치한다.
• 토큰과 시간만 쓰고 의욕을 잃음: 처음부터 에이전트를 여러 개 만들고 전부 시도했다. 첫 며칠은 하나로 감을 잡고, 음성 메모로 brain dump, MD 파일 축적, 그다음 다중 에이전트 순서로 간다.
• Brave 검색 속도 제한에 걸림: 무료 플랜이 초당 1요청 / 월 2,000요청이다. 에이전트에게 인터넷 요청 속도를 늦추라고 알려 준다.
• 대시보드 링크를 잃어버림: 터미널에서 openclaw dashboard를 실행해 다시 연다.

지우고 다시 설치하는 법

오픈클로를 기기에서 지우고 온보딩을 처음부터 다시 하는 것은 이 튜토리얼에서 정상적인 과정으로 봅니다. 며칠 써 보고 용도를 파악한 뒤 설정과 보안을 더 신중하게 다시 고르라는 뜻입니다. 영상에는 "wipe Open Claw from your computer"라는 표현만 나오고 구체적 명령은 나오지 않습니다.

• 지우기: 공식 문서의 제거(uninstall) 안내를 따른다. 터미널에서 openclaw --help를 쳐서 제거 관련 명령이 있는지 먼저 확인한다.
• 다시 설치: 2장의 설치 명령부터 다시 실행하면 온보딩이 처음부터 뜬다.
• 키 정리: 다시 설치할 때 OpenRouter, 텔레그램 봇, Brave 키를 새로 발급받고 옛 키는 각 서비스에서 삭제하면 더 깔끔하다.

에이전트의 소통 스타일 정도만 바꾸고 싶다면 다시 설치할 필요가 없습니다. "네 설정 파일을 업데이트해 줘"라고 시키면 됩니다.

설치보다 중요한 세 가지

96단계라고 하면 많아 보이지만, 실제로 손이 많이 가는 곳은 셋입니다. OpenRouter 키 만들기, 텔레그램 봇 만들고 숫자 ID 넣기, 그리고 보안 프롬프트 돌리기. 나머지는 대부분 엔터입니다.

가장 힘주어 말하는 것은 설치가 아니라 그 뒤입니다. 전용 기기에 깔 것, 설치 직후 보안 프롬프트부터 돌릴 것, 첫 며칠은 에이전트 하나로 버틸 것. 세 가지가 전부입니다.

다음 편은 에이전트 팀 구성과 여러 팀원에게 작업과 프로젝트를 넘기는 커맨드 센터 구축이라고 예고됐습니다.

이 글은 Bart Slodyczka의 영어 영상(15분 30초)을 자동 자막으로 옮겨 한국어로 정리했고, 화면은 대조하지 못했습니다. 설치 명령, Brave 설정 명령, 보안 점검 명령, 대시보드 다시 열기, 세션 리셋, 제거 안내, 첫 대화와 검증 프롬프트 예시는 영상에 없는 내용을 공식 안내 기준으로 보충한 것이라 버전에 따라 다를 수 있습니다. 기본 포트 번호와 기본 설치 경로는 영상에 나오지 않아 싣지 않았습니다. 자막에는 BotFather가 "Bot Father", OpenClaw가 "Open Claw"로 적혀 있습니다.

출처: youtu.be/…