OpenClaw 설치 및 환경 설정 완벽 가이드

OpenClaw CLI를 처음 시작하는 개발자를 위한 환경 설정 가이드입니다. Node.js 설치부터 첫 메시지 전송까지 단계별로 알아봅니다. 초급 개발자도 쉽게 따라할 수 있도록 실무 스토리텔링으로 풀어냈습니다.

---

목차

1. 개발 환경 준비의 중요성
2. Node.js 22+ 요구사항
3. npm/pnpm/bun 설치
4. openclaw 전역 설치
5. onboarding wizard 실행
6. 첫 메시지 전송 테스트
7. JavaScript 런타임

---

1. 개발 환경 준비의 중요성

신입 개발자 이준비 씨가 회사 첫날 컴퓨터 앞에 앉았습니다. "먼저 개발 환경을 세팅해야 해요." 팀장님이 말씀하셨습니다.

이준비 씨는 당황했습니다. 개발 환경이 뭐죠?

개발 환경이란 코드를 작성하고 실행하기 위해 필요한 모든 도구와 설정을 말합니다. 마치 요리사가 요리를 시작하기 전에 칼, 도마, 냄비를 준비하는 것처럼 개발자도 작업을 시작하기 전에 필요한 도구들을 준비해야 합니다.

제대로 된 환경 설정은 생산성을 크게 높여줍니다.

다음 코드를 살펴봅시다.

// 환경 설정 체크리스트 예시
const setupChecklist = {
  runtime: 'Node.js 22+',
  packageManager: 'npm/pnpm/bun',
  tool: 'openclaw',
  status: 'ready'
};

// 환경이 올바르게 설정되었는지 확인
function checkEnvironment() {
  console.log('현재 Node.js 버전:', process.version);
  console.log('설치 경로:', process.execPath);
  return setupChecklist;
}

이준비 씨는 컴퓨터 공학을 전공했지만, 실무 개발 환경이라는 말을 들으니 막막했습니다. 학교에서는 IDE만 설치하면 끝이었는데, 회사에서는 왜 이렇게 복잡할까요?

팀장 박베테랑 씨가 친절하게 설명해주었습니다. "개발 환경이란 코드를 작성하고 실행하는 데 필요한 모든 것을 말해요.

런타임, 패키지 매니저, 빌드 도구, CLI 도구 등이 모두 포함되죠." 쉽게 비유하자면, 개발 환경은 마치 요리사의 주방과 같습니다. 칼이 없으면 재료를 자를 수 없고, 냄비가 없으면 요리를 할 수 없습니다.

아무리 좋은 레시피가 있어도 도구가 없으면 소용없는 것처럼, 아무리 좋은 코드를 작성해도 실행할 환경이 없으면 의미가 없습니다. 개발 환경 설정이 중요한 이유는 무엇일까요?

첫째, 일관성입니다. 모든 팀원이 같은 버전의 도구를 사용하면 "제 컴퓨터에서는 되는데요?" 같은 문제가 사라집니다.

둘째, 생산성입니다. 올바른 도구를 사용하면 반복 작업을 자동화할 수 있습니다.

셋째, 협업입니다. 같은 환경에서 작업하면 코드 리뷰와 디버깅이 훨씬 수월해집니다.

환경 설정을 제대로 하지 않으면 어떤 문제가 생길까요? 이준비 씨의 동기 김급한 씨는 환경 설정을 대충 했습니다.

그 결과 로컬에서는 잘 작동하던 코드가 서버에 배포하면 에러가 났습니다. 원인을 찾느라 이틀을 허비했습니다.

Node.js 버전이 달랐던 것입니다. 로컬은 18 버전, 서버는 22 버전이었습니다.

또 다른 문제는 의존성 충돌입니다. 패키지 매니저를 여러 개 섞어 쓰면 같은 라이브러리가 여러 번 설치되어 용량을 낭비하고, 버전 불일치로 에러가 발생할 수 있습니다.

올바른 개발 환경 설정의 첫걸음은 무엇일까요? 바로 표준화입니다.

팀에서 사용할 도구와 버전을 명확히 정하고, 모든 팀원이 같은 설정을 따르는 것입니다. 요즘은 Docker나 개발 컨테이너를 사용해 환경을 패키징하기도 합니다.

하지만 처음 시작하는 개발자에게는 이것도 부담스러울 수 있습니다. 그래서 가장 기본이 되는 것부터 차근차근 설정해야 합니다.

Node.js 설치, 패키지 매니저 선택, 필요한 CLI 도구 설치가 그 시작입니다. 박베테랑 씨는 이준비 씨에게 체크리스트를 하나 건네주었습니다.

"먼저 Node.js 22 이상 버전을 설치하고, 패키지 매니저로 pnpm을 사용할 거예요. 그다음 openclaw라는 CLI 도구를 전역으로 설치하면 됩니다." 이준비 씨는 고개를 끄덕였습니다.

하나씩 따라 하면 되겠구나. 생각보다 어렵지 않네요.

환경 설정은 한 번만 제대로 하면 됩니다. 처음에는 시간이 걸리지만, 이후로는 편하게 개발할 수 있습니다.

마치 새집에 이사 와서 가구를 배치하는 것과 같습니다. 처음에는 힘들지만, 한번 정리해두면 생활이 편해집니다.

여러분도 이제부터 차근차근 개발 환경을 설정해봅시다. 첫 번째 단계는 바로 Node.js 설치입니다.

실전 팁

💡 - 팀에서 사용하는 Node.js 버전을 명확히 확인하세요

• .nvmrc 파일로 Node.js 버전을 프로젝트에 명시할 수 있습니다
• 환경 설정은 문서화해두면 나중에 다시 설정할 때 시간을 절약할 수 있습니다

---

2. Node.js 22+ 요구사항

이준비 씨가 Node.js를 검색했습니다. 여러 버전이 보였습니다.

16, 18, 20, 22... "어떤 버전을 설치해야 하나요?" 박베테랑 씨가 답했습니다.

"최소 22 버전이 필요해요."

Node.js는 JavaScript를 브라우저 밖에서 실행할 수 있게 해주는 런타임 환경입니다. 버전 22 이상을 요구하는 이유는 최신 JavaScript 기능과 성능 향상, 보안 업데이트가 포함되어 있기 때문입니다.

올바른 버전을 선택하는 것이 안정적인 개발의 시작입니다.

다음 코드를 살펴봅시다.

// Node.js 버전 확인
console.log('Node.js 버전:', process.version);
console.log('V8 엔진 버전:', process.versions.v8);

// 버전 체크 함수
function checkNodeVersion() {
  const version = process.version;
  const major = parseInt(version.split('.')[0].slice(1));

  if (major < 22) {
    console.error('Node.js 22 이상이 필요합니다!');
    console.log('현재 버전:', version);
    return false;
  }

  console.log('Node.js 버전 요구사항 충족:', version);
  return true;
}

이준비 씨는 궁금했습니다. 왜 꼭 22 버전이어야 할까요?

18 버전도 있고 20 버전도 있는데 말이죠. 박베테랑 씨가 설명을 시작했습니다.

"Node.js는 계속 발전하고 있어요. 새로운 버전이 나올 때마다 성능이 좋아지고, 보안 취약점이 수정되고, 새로운 JavaScript 기능을 지원하죠." Node.js 버전을 이해하려면 먼저 버전 체계를 알아야 합니다.

Node.js는 짝수 버전은 LTS(Long Term Support), 홀수 버전은 Current로 구분됩니다. LTS는 장기 지원 버전으로 안정성이 중요한 프로덕션 환경에 적합합니다.

쉽게 비유하자면, Node.js 버전은 마치 스마트폰 OS 업데이트와 같습니다. 새 버전이 나오면 새로운 기능이 추가되고, 배터리 성능이 개선되고, 보안이 강화됩니다.

구버전을 계속 사용하면 새 앱을 설치할 수 없거나 보안 위협에 노출될 수 있습니다. 그렇다면 왜 22 버전이 필요할까요?

첫째, 최신 ECMAScript 기능을 지원합니다. Top-level await, Import assertions 같은 현대적인 JavaScript 문법을 사용할 수 있습니다.

둘째, 성능 향상입니다. V8 엔진이 업그레이드되어 코드 실행 속도가 빨라졌습니다.

셋째, 보안 패치입니다. 구버전에서 발견된 취약점이 모두 수정되었습니다.

이준비 씨의 동기 최구버 씨는 Node.js 16을 사용하고 있었습니다. 어느 날 새 프로젝트를 시작하려는데 에러가 났습니다.

"이 패키지는 Node.js 18 이상이 필요합니다"라는 메시지가 떴습니다. 결국 업그레이드를 해야 했고, 기존 프로젝트와 충돌이 생겨 이틀을 고생했습니다.

Node.js를 설치하는 방법은 여러 가지입니다. 가장 간단한 방법은 공식 웹사이트에서 인스톨러를 다운로드하는 것입니다.

nodejs.org에 접속하면 LTS 버전과 Current 버전을 선택할 수 있습니다. 하지만 이 방법은 버전 관리가 어렵습니다.

더 나은 방법은 버전 매니저를 사용하는 것입니다. Windows에서는 nvm-windows, macOS와 Linux에서는 nvm(Node Version Manager)을 사용합니다.

이렇게 하면 여러 버전을 설치하고 쉽게 전환할 수 있습니다. 예를 들어 nvm을 사용하면 이렇게 설치합니다.

nvm install 22 명령어 하나로 Node.js 22 최신 버전이 설치됩니다. nvm use 22 명령어로 사용할 버전을 전환할 수 있습니다.

버전 확인은 어떻게 할까요? 터미널을 열고 node --version 또는 node -v 명령어를 입력하면 현재 설치된 버전이 표시됩니다.

v22.0.0 이상이면 준비가 완료된 것입니다. 박베테랑 씨는 이준비 씨에게 팁을 하나 더 알려주었습니다.

"프로젝트마다 다른 Node.js 버전이 필요할 수 있어요. 그래서 .nvmrc 파일을 프로젝트 루트에 만들어두면 좋습니다.

파일에 버전 번호만 적어두면, 다른 개발자가 nvm use 명령어로 바로 올바른 버전을 사용할 수 있죠." 이준비 씨는 nvm을 설치하고 Node.js 22를 설치했습니다. node -v를 입력하니 v22.5.1이 출력되었습니다.

성공입니다! Node.js 버전 관리는 생각보다 중요합니다.

한번 제대로 설정해두면 프로젝트를 전환할 때마다 자동으로 올바른 버전을 사용할 수 있습니다. 여러분도 nvm을 사용해서 버전을 관리해보세요.

실전 팁

💡 - nvm을 사용하면 여러 Node.js 버전을 쉽게 관리할 수 있습니다

• .nvmrc 파일로 프로젝트별 Node.js 버전을 명시하세요
• LTS 버전을 선택하면 안정성과 장기 지원을 받을 수 있습니다

---

3. npm/pnpm/bun 설치

Node.js를 설치한 이준비 씨가 다음 단계를 물었습니다. "이제 뭘 해야 하나요?" 박베테랑 씨가 답했습니다.

"패키지 매니저를 선택해야 해요. npm, pnpm, bun 중에 하나를요."

패키지 매니저는 외부 라이브러리를 설치하고 관리하는 도구입니다. npm은 Node.js와 함께 기본으로 설치되며, pnpm은 디스크 공간을 절약하고 속도가 빠르며, bun은 차세대 초고속 런타임입니다.

프로젝트 특성에 맞는 패키지 매니저를 선택하는 것이 중요합니다.

다음 코드를 살펴봅시다.

// npm으로 패키지 설치
// npm install lodash

// pnpm으로 패키지 설치 (더 빠르고 효율적)
// pnpm install lodash

// bun으로 패키지 설치 (가장 빠름)
// bun add lodash

// 설치된 패키지 사용 예시
import _ from 'lodash';

const numbers = [1, 2, 3, 4, 5];
const doubled = _.map(numbers, n => n * 2);
console.log('배열 변환:', doubled);

// 패키지 매니저 버전 확인
console.log('npm 버전:', 'npm -v');
console.log('pnpm 버전:', 'pnpm -v');

이준비 씨는 또 혼란스러웠습니다. 패키지 매니저가 뭐고, 왜 세 가지나 있는 걸까요?

박베테랑 씨가 친절하게 설명했습니다. "개발하다 보면 다른 사람이 만든 코드를 가져다 쓰게 돼요.

예를 들어 날짜 처리 라이브러리, HTTP 통신 라이브러리 같은 거죠. 이런 걸 패키지 또는 라이브러리라고 부릅니다." 패키지 매니저를 이해하기 쉽게 비유하자면, 마치 스마트폰의 앱스토어와 같습니다.

필요한 앱을 검색하고, 다운로드하고, 업데이트하고, 삭제하는 모든 일을 앱스토어가 해주듯이, 패키지 매니저도 라이브러리를 설치하고 관리하는 모든 작업을 자동으로 처리합니다. 그렇다면 왜 선택지가 세 가지나 될까요?

처음에는 npm(Node Package Manager)만 있었습니다. Node.js를 설치하면 자동으로 함께 설치됩니다.

오랫동안 표준으로 사용되어 왔고, 가장 많은 사용자가 있습니다. 하지만 단점도 있었습니다.

패키지를 설치할 때마다 같은 파일을 여러 번 다운로드해서 디스크 공간을 낭비했습니다. 이 문제를 해결하기 위해 pnpm이 등장했습니다.

pnpm은 "performant npm"의 약자입니다. 같은 패키지를 한 곳에만 저장하고, 필요할 때 링크를 만들어서 공유합니다.

결과적으로 디스크 공간을 70% 이상 절약하고, 설치 속도도 2-3배 빠릅니다. 최근에는 bun이라는 새로운 도구가 등장했습니다.

bun은 단순히 패키지 매니저가 아니라 JavaScript 런타임 자체입니다. Node.js를 대체할 수 있으며, 패키지 설치 속도가 npm보다 10배 이상 빠릅니다.

아직 새로운 기술이라 안정성 면에서는 검증이 더 필요하지만, 성능 면에서는 압도적입니다. 그렇다면 어떤 것을 선택해야 할까요?

이준비 씨의 동기 선안정 씨는 안정성을 중시하는 금융 서비스를 개발합니다. 그래서 npm을 사용합니다.

오랫동안 검증되었고, 문제가 생겼을 때 레퍼런스가 많아서 해결하기 쉽기 때문입니다. 반면 김속도 씨는 스타트업에서 빠른 개발을 해야 합니다.

그래서 pnpm을 선택했습니다. CI/CD 파이프라인에서 패키지 설치 시간이 크게 줄어들어 배포 속도가 빨라졌습니다.

최신 기술을 좋아하는 이얼리 씨는 bun을 사용합니다. 개인 프로젝트에서 실험적으로 도입했는데, 로컬 개발 환경에서 패키지 설치가 눈에 띄게 빨라졌습니다.

설치 방법은 어떻게 될까요? npm은 Node.js와 함께 자동으로 설치되므로 별도로 설치할 필요가 없습니다.

pnpm은 npm install -g pnpm 명령어로 전역 설치합니다. bun은 공식 웹사이트에서 설치 스크립트를 제공합니다.

박베테랑 씨는 이준비 씨에게 조언했습니다. "우리 팀은 pnpm을 사용해요.

모노레포 프로젝트에서 성능이 좋고, 디스크 공간도 절약되거든요. 설치해볼까요?" 이준비 씨는 터미널을 열고 npm install -g pnpm 명령어를 입력했습니다.

잠시 후 설치가 완료되었습니다. pnpm -v를 입력하니 버전이 출력되었습니다.

성공입니다! 주의할 점도 있습니다.

한 프로젝트에서 여러 패키지 매니저를 섞어 쓰면 안 됩니다. npm으로 설치한 패키지와 pnpm으로 설치한 패키지가 충돌할 수 있습니다.

팀에서 정한 하나의 패키지 매니저만 일관되게 사용해야 합니다. 패키지 매니저 선택은 프로젝트 초반에 결정하는 것이 좋습니다.

나중에 바꾸려면 node_modules를 모두 삭제하고 다시 설치해야 하기 때문입니다.

실전 팁

💡 - 팀에서 사용하는 패키지 매니저를 통일하세요

• pnpm은 모노레포 프로젝트에서 특히 유용합니다
• package.json에 packageManager 필드를 명시하면 자동으로 올바른 매니저를 사용합니다

---

4. openclaw 전역 설치

환경이 준비되었습니다. 이준비 씨가 물었습니다.

"이제 openclaw를 설치하면 되나요?" 박베테랑 씨가 고개를 끄덕였습니다. "네, 전역으로 설치해서 어디서든 사용할 수 있게 해봅시다."

openclaw는 Claude AI와 대화하고 작업을 자동화할 수 있는 CLI 도구입니다. 전역 설치하면 터미널의 어떤 경로에서든 openclaw 명령어를 사용할 수 있습니다.

이 도구를 통해 코드 생성, 문서 작성, 질의응답 등 다양한 AI 기반 작업을 수행할 수 있습니다.

다음 코드를 살펴봅시다.

// openclaw 전역 설치 명령어
// pnpm install -g openclaw

// 또는 npm 사용 시
// npm install -g openclaw

// 설치 확인
// openclaw --version

// 기본 사용 예시
// openclaw ask "Node.js란 무엇인가요?"

// 설치 후 사용 가능한 명령어 확인
// openclaw --help

// JavaScript에서 child_process로 openclaw 실행 예시
import { exec } from 'child_process';

exec('openclaw --version', (error, stdout, stderr) => {
  if (error) {
    console.error('openclaw가 설치되지 않았습니다:', error);
    return;
  }
  console.log('설치된 openclaw 버전:', stdout);
});

이준비 씨는 openclaw라는 이름이 독특하다고 생각했습니다. 대체 무엇을 하는 도구일까요?

박베테랑 씨가 설명했습니다. "openclaw는 터미널에서 Claude AI를 사용할 수 있게 해주는 CLI 도구예요.

코드를 작성하거나, 문서를 만들거나, 질문에 답을 얻을 수 있죠. 개발자의 생산성을 크게 높여줍니다." CLI 도구를 이해하기 위해 먼저 전역 설치가 무엇인지 알아야 합니다.

쉽게 비유하자면, 전역 설치는 마치 스마트폰의 홈 화면에 앱을 추가하는 것과 같습니다. 한번 설치하면 어디서든 바로 사용할 수 있습니다.

반대로 로컬 설치는 특정 프로젝트 폴더에만 설치하는 것입니다. 해당 프로젝트에서만 사용할 수 있습니다.

openclaw는 여러 프로젝트에서 공통으로 사용할 도구이므로 전역 설치가 적합합니다. 전역 설치는 어떻게 할까요?

pnpm을 사용한다면 pnpm install -g openclaw 명령어를 입력합니다. 여기서 -g는 global의 약자로, 전역 설치를 의미합니다.

npm을 사용한다면 npm install -g openclaw를 사용합니다. 설치 과정을 지켜보면 여러 메시지가 출력됩니다.

패키지를 다운로드하고, 의존성을 해결하고, 실행 파일을 등록하는 과정이 자동으로 진행됩니다. 보통 수십 초 정도 걸립니다.

이준비 씨의 동기 실수왕 씨는 전역 설치 없이 바로 openclaw를 실행하려다 에러를 만났습니다. "openclaw: command not found"라는 메시지가 떴습니다.

전역 설치를 하지 않았기 때문입니다. 설치가 완료되었는지 어떻게 확인할까요?

터미널을 새로 열고 openclaw --version 명령어를 입력합니다. 버전 번호가 출력되면 성공입니다.

만약 "command not found" 에러가 나온다면 설치가 제대로 되지 않은 것입니다. Windows 사용자는 때때로 권한 문제를 겪을 수 있습니다.

관리자 권한으로 터미널을 실행하거나, PowerShell 실행 정책을 변경해야 할 수 있습니다. macOS나 Linux 사용자는 sudo를 붙여야 할 수도 있습니다.

박베테랑 씨가 팁을 알려주었습니다. "설치 후에는 openclaw --help 명령어로 사용 가능한 모든 명령어를 볼 수 있어요.

처음에는 이것저것 실험해보면서 익숙해지는 게 좋습니다." 이준비 씨는 pnpm install -g openclaw를 입력했습니다. 설치 메시지가 주르륵 올라갔습니다.

잠시 후 "success"라는 메시지가 보였습니다. openclaw --version을 입력하니 v1.0.0이 출력되었습니다.

openclaw를 전역 설치하면 어떤 장점이 있을까요? 첫째, 어디서든 사용 가능합니다.

프로젝트 폴더를 이동하면서 개발할 때도 항상 openclaw 명령어를 쓸 수 있습니다. 둘째, 버전 관리가 쉽습니다.

한 곳에만 설치되어 있으므로 업데이트도 한 번만 하면 됩니다. 셋째, 디스크 절약입니다.

프로젝트마다 설치할 필요가 없으므로 공간을 절약합니다. 하지만 주의할 점도 있습니다.

전역 패키지가 너무 많아지면 관리가 어려워집니다. 정말 필요한 도구만 전역으로 설치하고, 프로젝트 전용 도구는 로컬로 설치하는 것이 좋습니다.

여러분도 이제 openclaw를 설치했습니다. 다음 단계는 초기 설정입니다.

실전 팁

💡 - 전역 설치는 -g 플래그를 사용합니다

• openclaw --help로 사용 가능한 명령어를 확인하세요
• 정기적으로 업데이트하여 최신 기능을 사용하세요

---

5. onboarding wizard 실행

openclaw를 설치한 이준비 씨가 다음 단계를 기다렸습니다. 박베테랑 씨가 말했습니다.

"이제 onboarding wizard를 실행해서 초기 설정을 해야 해요. 간단한 질문 몇 가지에 답하면 됩니다."

Onboarding wizard는 openclaw를 처음 사용하는 사용자를 위한 대화형 설정 도구입니다. API 키 입력, 기본 모델 선택, 작업 디렉토리 설정 등을 단계별로 안내합니다.

이 과정을 거치면 openclaw가 사용자 환경에 맞게 최적화됩니다.

다음 코드를 살펴봅시다.

// onboarding wizard 실행
// openclaw onboard

// 설정 파일 확인 (자동 생성됨)
// ~/.openclaw/config.json

// JavaScript로 설정 파일 읽기 예시
import fs from 'fs';
import path from 'path';
import os from 'os';

// 홈 디렉토리의 openclaw 설정 파일 경로
const configPath = path.join(os.homedir(), '.openclaw', 'config.json');

// 설정 파일 읽기
function readConfig() {
  try {
    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
    console.log('현재 설정:', config);
    return config;
  } catch (error) {
    console.error('설정 파일을 찾을 수 없습니다. onboarding을 먼저 실행하세요.');
    return null;
  }
}

이준비 씨는 터미널에 openclaw onboard 명령어를 입력했습니다. 그러자 화면에 환영 메시지가 나타났습니다.

"Welcome to OpenClaw! Let's get you set up." 친절한 안내 메시지가 보였습니다.

이준비 씨는 설레었습니다. 이제 진짜 AI를 사용할 수 있겠구나!

박베테랑 씨가 옆에서 설명했습니다. "onboarding은 한번만 하면 돼요.

설정 파일이 만들어지고, 다음부터는 바로 사용할 수 있습니다." Onboarding wizard를 쉽게 비유하자면, 마치 새 스마트폰을 처음 켰을 때 나오는 초기 설정 화면과 같습니다. 언어를 선택하고, Wi-Fi를 연결하고, 계정을 로그인하는 과정처럼, openclaw도 처음 사용할 때 필요한 정보를 입력받습니다.

첫 번째 질문이 나타났습니다. "Claude API Key를 입력하세요." 이준비 씨는 당황했습니다.

API 키가 뭐죠? 박베테랑 씨가 설명했습니다.

"API 키는 Claude AI 서비스를 사용하기 위한 인증 토큰이에요. Anthropic 웹사이트에서 계정을 만들고 발급받을 수 있습니다.

마치 집 열쇠처럼, 서비스에 접근할 수 있는 권한을 증명하는 거죠." 이준비 씨는 브라우저를 열고 console.anthropic.com에 접속했습니다. 계정을 만들고 API Keys 메뉴로 들어갔습니다.

"Create Key" 버튼을 눌렀더니 긴 문자열이 생성되었습니다. sk-ant-...로 시작하는 키를 복사했습니다.

터미널로 돌아와 API 키를 붙여넣었습니다. 키가 화면에 보이지 않도록 자동으로 숨겨졌습니다.

보안을 위한 배려입니다. 다음 질문이 나타났습니다.

"기본 모델을 선택하세요: claude-3-opus, claude-3-sonnet, claude-3-haiku." 이준비 씨는 또 고민에 빠졌습니다. 박베테랑 씨가 도와주었습니다.

"opus는 가장 강력하지만 비싸고, haiku는 빠르고 저렴하지만 성능이 낮습니다. sonnet은 중간이에요.

일반적인 용도로는 sonnet이 적당합니다." 이준비 씨는 claude-3-sonnet을 입력했습니다. 화살표 키로 선택할 수도 있었습니다.

다음 질문은 작업 디렉토리에 대한 것이었습니다. "기본 작업 디렉토리를 설정하세요." 기본값은 현재 홈 디렉토리였습니다.

이준비 씨는 그냥 엔터를 눌러 기본값을 선택했습니다. 마지막 질문이 나타났습니다.

"설정을 저장하시겠습니까?" 이준비 씨는 Y를 입력했습니다. "Configuration saved successfully!" 성공 메시지가 나타났습니다.

홈 디렉토리에 .openclaw 폴더가 생성되고, 그 안에 config.json 파일이 만들어졌습니다. 박베테랑 씨가 설명했습니다.

"이제 설정 파일이 만들어졌어요. 나중에 설정을 바꾸고 싶으면 이 파일을 직접 수정하거나, openclaw config 명령어로 변경할 수 있습니다." Onboarding을 완료하면 어떤 일이 일어날까요?

첫째, 인증 정보가 안전하게 저장됩니다. 다음부터는 API 키를 다시 입력할 필요가 없습니다.

둘째, 기본 설정이 적용됩니다. 모델, 온도, 최대 토큰 수 같은 옵션이 설정됩니다.

셋째, 작업 환경이 준비됩니다. openclaw가 파일을 저장하고 읽을 위치가 정해집니다.

주의할 점도 있습니다. API 키는 절대 다른 사람과 공유하면 안 됩니다.

GitHub에 업로드하거나 공개 채팅방에 올리면 누군가 무단으로 사용할 수 있습니다. 만약 노출되었다면 즉시 폐기하고 새로 발급받아야 합니다.

이준비 씨는 onboarding을 무사히 완료했습니다. 이제 openclaw를 사용할 준비가 끝났습니다.

마지막 단계는 실제로 메시지를 보내보는 것입니다.

실전 팁

💡 - API 키는 절대 공개하지 마세요

• 설정 파일은 .gitignore에 추가하여 버전 관리에서 제외하세요
• openclaw config 명령어로 언제든 설정을 변경할 수 있습니다

---

6. 첫 메시지 전송 테스트

모든 설정이 끝났습니다. 이준비 씨는 떨리는 마음으로 첫 메시지를 보내려 합니다.

박베테랑 씨가 미소 지으며 말했습니다. "이제 진짜 AI와 대화할 시간이에요.

간단한 질문으로 테스트해볼까요?"

첫 메시지 전송은 openclaw 설정이 제대로 되었는지 확인하는 중요한 단계입니다. 간단한 질문으로 API 연결을 테스트하고, AI 응답을 확인합니다.

이 과정을 통해 모든 환경 설정이 올바르게 완료되었음을 검증할 수 있습니다.

다음 코드를 살펴봅시다.

// 터미널에서 첫 메시지 보내기
// openclaw ask "Hello, Claude! 환경 설정이 잘 되었나요?"

// 또는 파이프로 긴 질문 전달
// echo "Node.js란 무엇이고 왜 중요한가요?" | openclaw ask

// JavaScript에서 openclaw를 프로그래매틱하게 사용
import { exec } from 'child_process';
import { promisify } from 'util';

const execAsync = promisify(exec);

async function askClaude(question) {
  try {
    const { stdout, stderr } = await execAsync(
      `openclaw ask "${question}"`
    );

    if (stderr) {
      console.error('에러 발생:', stderr);
      return null;
    }

    console.log('Claude의 답변:', stdout);
    return stdout;
  } catch (error) {
    console.error('openclaw 실행 실패:', error.message);
    return null;
  }
}

이준비 씨는 터미널에 손가락을 올렸습니다. 설치부터 설정까지 모든 과정을 거쳤습니다.

이제 마지막 순간입니다. 박베테랑 씨가 옆에서 지켜봤습니다.

"긴장하지 마세요. 간단한 인사말부터 시작해봅시다." 이준비 씨는 천천히 명령어를 입력했습니다.

openclaw ask "안녕하세요, Claude! 저는 openclaw를 처음 사용하는 개발자입니다." 엔터를 눌렀습니다.

잠시 기다리는 시간이 흘렀습니다. 화면에 "Thinking..."이라는 메시지가 나타났습니다.

그리고 몇 초 후, Claude의 답변이 스트리밍으로 표시되기 시작했습니다. "안녕하세요!

openclaw를 사용해주셔서 감사합니다. 저는 Claude AI입니다.

무엇을 도와드릴까요?" 이준비 씨의 얼굴에 환한 미소가 번졌습니다. 성공입니다!

모든 설정이 제대로 작동하고 있습니다. 첫 메시지 전송이 중요한 이유는 무엇일까요?

쉽게 비유하자면, 마치 새로 산 자동차의 시동을 처음 거는 순간과 같습니다. 엔진이 돌아가는지, 모든 부품이 연결되어 있는지 확인하는 것입니다.

첫 메시지가 성공적으로 전송되면 설치, 설정, API 연결이 모두 올바르게 되었다는 뜻입니다. 만약 에러가 발생한다면 어떻게 해야 할까요?

이준비 씨의 동기 실패왕 씨는 첫 메시지 전송에서 에러를 만났습니다. "API Key is invalid"라는 메시지가 떴습니다.

API 키를 잘못 입력한 것입니다. openclaw onboard를 다시 실행해서 올바른 키를 입력했더니 해결되었습니다.

또 다른 동기 방화벽 씨는 "Network error"를 만났습니다. 회사 방화벽이 외부 API 호출을 차단하고 있었습니다.

IT 팀에 요청해서 Anthropic API 도메인을 허용 목록에 추가했더니 작동했습니다. 첫 메시지로 무엇을 보내는 것이 좋을까요?

박베테랑 씨가 조언했습니다. "처음에는 간단한 질문으로 시작하세요.

환경 설정 확인도 되고, openclaw의 기본 사용법도 익힐 수 있습니다. 예를 들어 'Node.js란 무엇인가요?' 같은 질문이 좋습니다." 이준비 씨는 다시 한번 질문을 보냈습니다.

openclaw ask "Node.js의 주요 특징 3가지를 알려주세요." Claude가 깔끔하게 정리된 답변을 보내왔습니다.

---

3. JavaScript 런타임

실전 팁

💡 - 간단한 질문으로 먼저 테스트하세요

• 에러 메시지는 전체를 복사해서 질문하면 더 정확한 답변을 얻습니다
• API 사용량을 주기적으로 모니터링하세요

---

이상으로 학습을 마칩니다. 위 내용을 직접 코드로 작성해보면서 익혀보세요!