OpenClaw 다운로드 및 테스트 후기

2026년 5월 29일 직접 테스트

OpenClaw 다운로드 및 테스트 후기

GitHub 소스 클론, npm 배포판 설치, CLI 스모크 테스트, Gateway 상태 확인까지 실제로 돌려 보고 정리했습니다.

▲ OpenClaw 공식 저장소에 포함된 로고. 이번 테스트는 공식 저장소와 npm 배포판을 기준으로 진행했다. 출처

목차

1. 테스트 요약
2. 다운로드와 버전 확인
3. npm 배포판 스모크 테스트
4. Gateway 상태와 온보딩 해석
5. 보안 관점에서 봐야 할 것
6. 추천 설치 흐름
7. 상세 테스트 노트
8. FAQ
9. 출처

테스트 요약

OpenClaw를 직접 내려받아 보고, 그냥 소개 글이 아니라 설치 경로에서 어디까지 확인되는지까지 정리했다. 이번 테스트의 핵심은 2가지였다. 첫째, GitHub 저장소를 실제로 클론했을 때 현재 소스 트리가 어떤 상태인지 확인한다. 둘째, 일반 사용자가 가장 먼저 만나게 될 npm 배포판을 로컬 디렉터리에 설치해서 CLI가 정상적으로 뜨는지 확인한다.

항목	확인 결과	해석
소스 클론	GitHub HEAD e01b04d, package version 2026.5.28	저장소는 정상 접근 및 다운로드 가능
npm latest	2026.5.27, commit 27ae826	테스트 시점에는 npm 배포판이 main보다 한 버전 낮음
런타임	Node 24.14.0로 테스트	기본 Node 20은 요구 조건 미달
CLI 스모크	--version, --help, doctor --lint, status, gateway status 실행	패키지 실행은 정상, 설정은 온보딩 필요

결론부터 말하면 OpenClaw는 “개인 AI 비서”라는 표현에 걸맞게 채널, 게이트웨이, 에이전트, 스킬, 보안 점검을 한 CLI 안에 많이 담고 있다. 다만 소스 체크아웃과 배포판 설치는 성격이 다르므로, 이 차이를 분명히 알아야 한다.

다운로드와 버전 확인

테스트 기준일은 2026년 5월 29일이다. 로컬 테스트 환경은 macOS arm64였고, 시스템 기본 Node.js는 v20.20.1이었다. OpenClaw 문서와 README는 Node 24를 권장하고 Node 22.19 이상을 지원한다고 적고 있다. 그래서 기본 Node로는 실행 조건을 만족하지 못했고, 테스트에는 별도 번들 Node v24.14.0을 사용했다.

git clone --depth 1 https://github.com/openclaw/openclaw.git openclaw-run
cd openclaw-run
git rev-parse HEAD
node openclaw.mjs --version

소스 체크아웃에서 node openclaw.mjs --version은 성공했다. 출력은 OpenClaw 2026.5.28 (e01b04d)였다. 하지만 node openclaw.mjs --help와 doctor --help는 실패했다. 이유는 명확했다. 소스 트리에는 빌드 산출물인 dist/entry가 없었고, 실행기는 “unbuilt source tree”라고 판단했다.

Error: openclaw: missing dist/entry.(m)js (build output).
This install looks like an unbuilt source tree or GitHub source archive.
Build locally with `pnpm install && pnpm build`, or install a built package instead.
For releases, use `npm install -g openclaw@latest`.

이 결과는 실패라기보다 정상적인 소스 트리 검증에 가깝다. README와 실행기 메시지 모두 “소스는 빌드가 필요하고, 일반 사용자는 빌드된 패키지를 설치하라”는 방향으로 일치한다.

▲ 공식 문서의 설치 스크립트 흐름. 일반 사용자는 빌드되지 않은 GitHub 소스보다 배포판 설치가 덜 헷갈린다. 출처

npm 배포판 스모크 테스트

실제 CLI 테스트는 npm 배포판으로 진행했다. 사용자의 전역 환경을 바꾸지 않기 위해 전역 설치 대신 로컬 prefix 설치를 택했다. 설치 결과는 345 packages가 29초 안에 추가되는 것으로 끝났다.

PATH=/path/to/node24/bin:$PATH npm install --prefix openclaw-npm-test openclaw@latest
./openclaw-npm-test/node_modules/.bin/openclaw --version
./openclaw-npm-test/node_modules/.bin/openclaw --help

버전 출력은 OpenClaw 2026.5.27 (27ae826)이었다. --help도 정상적으로 열렸고, acp, agent, agents, channels, cron, doctor, gateway, models, plugins, security, sessions, skills, status 등 주요 명령 목록을 확인했다.

실행 명령	결과	메모
openclaw --version	성공	npm 배포판 버전 2026.5.27 확인
openclaw --help	성공	주요 CLI 명령 목록 출력
openclaw doctor --lint --json	실행 성공, 종료 코드 1	설정 미완료 경고가 있어 ok:false
openclaw status	성공	Gateway는 아직 실행 전이라 unreachable
openclaw gateway status	성공	서비스와 config 파일이 아직 없음

▲ OpenClaw 공식 showcase 이미지. CLI가 단순 명령 모음이 아니라 에이전트 운용 화면과 연결되는 제품군임을 보여 준다. 출처

Gateway 상태와 온보딩 해석

doctor --lint --json은 읽기 전용 점검이므로 테스트에 적합했다. 결과 코드는 1이었지만, 이것은 프로그램 실행 실패가 아니라 설정 미완료에 따른 경고가 있었기 때문이다. JSON에는 ok:false, checksRun:19가 나왔고, 주요 경고는 Gateway auth 토큰이 없다는 점, gateway.mode가 설정되지 않았다는 점, 여러 스킬의 외부 바이너리나 API 키가 없다는 점이었다.

{"ok":false,"checksRun":19,"checksSkipped":0,"findings":[{"checkId":"core/doctor/gateway-auth","severity":"warning","message":"Gateway auth is off or missing a token."},{"checkId":"core/doctor/gateway-config","severity":"warning","message":"gateway.mode is unset; gateway start will be blocked."}]}

추가로 openclaw --profile codex-smoke status도 실행했다. 별도 프로필을 쓴 이유는 기본 사용자 설정을 건드리지 않기 위해서다. 상태 출력은 OS와 Node v24.14.0을 인식했고, Dashboard 주소를 http://127.0.0.1:18789/로 표시했다. Gateway는 local loopback 기준으로 잡혔지만 아직 실행 중이 아니어서 unreachable로 나왔다. LaunchAgent도 설치되지 않았고, 채널도 구성되지 않았다.

Gateway: local · ws://127.0.0.1:18789 (local loopback) · unreachable
Gateway service: LaunchAgent not installed
Node service: LaunchAgent not installed
Channels: No channels configured
Sessions: No sessions

여기서 중요한 판단은 “패키지와 CLI는 정상 작동하지만, 게이트웨이 상시 실행과 대화 기능은 온보딩 이후의 영역”이라는 점이다. 설치 후 바로 AI와 대화가 안 된다고 해서 패키지 설치가 실패했다고 볼 수는 없다.

▲ 공식 macOS 온보딩 이미지. Gateway 설정은 OpenClaw 실사용의 중심 단계다. 출처

보안 관점에서 봐야 할 것

OpenClaw를 도입할 때 가장 먼저 봐야 할 장점은 제어면을 로컬에 둔다는 점이다. 개인용 비서가 메시지, 파일, 브라우저, 셸, 스케줄러와 연결될수록 신뢰 경계가 중요해진다. 공식 보안 문서는 OpenClaw를 적대적 멀티테넌트 보안 경계가 아니라 개인 비서 모델로 설명한다. 한 Gateway를 서로 신뢰하지 않는 여러 사람이 공유하는 구조는 권장되지 않는다.

운영 전 체크 흐름

Node 버전 확인

배포판 설치

온보딩 실행

doctor 점검

채널 연결

주의할 점도 뚜렷하다. OpenClaw는 설치 후 설정할 항목이 많다. 모델 제공자 인증, Gateway 모드, 토큰, 채널 연결, 스킬 의존성, 데몬 설치, 보안 점검을 차례대로 지나야 한다. 단순히 챗봇 하나를 띄우려는 사람에게는 무겁게 느껴질 수 있다. 하지만 여러 채널과 로컬 도구를 묶어 항상 켜진 개인 비서를 만들고 싶다면 이 복잡성은 기능의 대가에 가깝다.

▲ 공식 온보딩 이미지의 보안 안내. OpenClaw는 로컬 도구 권한을 다루므로 초기 보안 설정이 중요하다. 출처

추천 설치 흐름

이번 테스트 기준으로 추천 흐름은 다음과 같다. 개발자라면 먼저 npm 배포판으로 CLI를 확인하고, 이후 GitHub 소스를 별도로 클론해 구조를 살피는 편이 좋다. 일반 사용자는 소스 클론보다 공식 설치 스크립트나 npm install -g openclaw@latest를 택하는 편이 덜 헷갈린다.

1. 먼저 node --version으로 Node 24 또는 Node 22.19 이상인지 확인한다.
2. 일반 설치는 공식 설치 스크립트 또는 npm 배포판을 사용한다.
3. 설치 직후에는 openclaw --version과 openclaw --help로 CLI 실행만 확인한다.
4. 이후 openclaw onboard --install-daemon으로 Gateway, 모델, 인증, 채널, 스킬을 구성한다.
5. 온보딩 후 openclaw doctor --lint와 openclaw status로 상태를 재확인한다.

한 줄 결론은 이렇다. OpenClaw는 설치만으로 끝나는 작은 도구가 아니라, 로컬 Gateway를 중심으로 여러 채팅 채널과 에이전트 도구를 연결하는 개인 AI 운영 레이어다. 이번 다운로드와 테스트에서는 저장소 클론, npm 설치, 버전 확인, help 출력, doctor lint, status, gateway status까지 확인했고, CLI 자체는 정상적으로 작동했다.

다만 실사용 후기를 완성하려면 다음 단계가 남아 있다. 온보딩으로 토큰과 모델 제공자를 설정하고, Gateway를 데몬으로 설치한 뒤, 실제 채널 하나를 붙여 왕복 메시지를 보내야 한다. 특히 Telegram이나 Slack처럼 외부에서 들어오는 메시지는 보안 정책과 허용 목록을 먼저 정해야 한다. 이번 글은 그 전 단계인 설치 가능성, 패키지 무결성, CLI 상태 점검에 초점을 맞춘 기록이다. 따라서 “대화 품질”이 아니라 “로컬에서 실행 준비가 되는가”를 판단하는 자료로 읽는 것이 정확하다.

개인적으로는 이 구분이 OpenClaw 평가에서 가장 중요하다고 봤다. 설치가 되는 도구와 운영할 수 있는 도구는 다르다. OpenClaw는 후자에 가까워서, 처음부터 로그 위치, 상태 점검, doctor 경고, Gateway 포트, LaunchAgent 여부를 함께 보게 만든다. 이런 설계는 초보자에게는 길게 느껴질 수 있지만, 장기간 켜 둘 비서라면 오히려 필요한 투명성이다. 그래서 첫 설치 기록을 남길 때도 성공 화면 하나보다 경고와 미완료 항목을 같이 적는 편이 훨씬 실용적이다. 운영 전 점검에도 맞다.

▲ 공식 showcase 이미지. OpenClaw가 채팅 채널 위에서 실제 작업 흐름을 처리하는 모습을 보여 준다. 출처

상세 테스트 노트

긴 원문식 기록은 줄이고, 실제 확인한 내용을 읽기 쉬운 점검표로 정리했다. 이 섹션만 보면 “무엇이 성공했고, 무엇이 아직 온보딩 영역인지”를 빠르게 구분할 수 있다.

체크포인트	실제 확인	읽는 법
Node 조건	기본 Node v20.20.1은 미달, Node v24.14.0으로 테스트	설치 전 Node 24를 먼저 맞추는 편이 안전하다.
GitHub 소스	클론과 버전 출력은 성공, help는 빌드 산출물 누락으로 실패	소스 트리는 개발자용이다. 바로 쓰려면 빌드가 필요하다.
npm 배포판	로컬 prefix 설치 성공, version/help 출력 성공	일반 사용자는 npm 배포판이나 공식 설치 스크립트가 더 적합하다.
doctor 결과	실행은 됐지만 설정 경고로 ok:false	새 설치 직후에는 온보딩으로 채워야 할 항목으로 보면 된다.
Gateway 상태	포트와 대시보드 주소는 표시, 서비스는 아직 미설치	실제 대화 테스트는 Gateway 설정 이후 단계다.

이번 테스트에서 바로 말할 수 있는 것

• OpenClaw 저장소는 정상적으로 내려받을 수 있었다.
• npm 배포판 CLI는 버전 확인과 도움말 출력까지 정상 작동했다.
• 소스 체크아웃은 빌드 전 상태라 전체 CLI 실행에는 맞지 않았다.
• 설치 직후 경고 대부분은 실패라기보다 설정 미완료에 가깝다.

테스트 명령만 다시 보기+

1. git clone --depth 1 https://github.com/openclaw/openclaw.git openclaw-run
2. node openclaw.mjs --version
3. npm install --prefix openclaw-npm-test openclaw@latest
4. openclaw --version, openclaw --help
5. openclaw doctor --lint --json, openclaw status

아직 테스트하지 않은 영역+

모델 API 키 입력, Gateway 데몬 설치, 실제 채널 연결, 왕복 메시지 송수신은 온보딩 이후에 확인해야 한다. 그래서 이 글은 대화 품질 평가가 아니라 설치 가능성과 CLI 상태 점검 기록으로 보는 것이 정확하다.

FAQ

Q1. OpenClaw는 다운로드만 하면 바로 대화할 수 있나요?+

아니요. CLI 설치 후 모델 인증, Gateway 설정, 토큰, 워크스페이스, 채널 등을 온보딩해야 실제 대화 환경이 완성됩니다. 설치 직후에는 버전과 명령 목록 확인부터 하는 것이 좋습니다.

Q2. GitHub 소스를 클론했는데 help 명령이 실패한 이유는 무엇인가요?+

클론한 소스 트리에는 빌드 산출물인 dist/entry가 없을 수 있습니다. 소스에서 직접 실행하려면 빌드가 필요하고, 일반 사용자는 빌드된 npm 배포판을 설치하는 편이 안전합니다.

Q3. Node v20에서도 설치할 수 있나요?+

이번 테스트 기준으로 OpenClaw는 Node 22.19 이상을 요구하고 Node 24를 권장합니다. Node v20 환경에서는 실행기가 요구 조건을 만족하지 못했다고 보고했습니다.

Q4. doctor 명령이 종료 코드 1을 내면 설치 실패인가요?+

반드시 그렇지는 않습니다. 이번 테스트에서는 명령 자체는 실행됐지만 Gateway auth, gateway.mode, 스킬 의존성 같은 설정 경고가 있어서 ok:false가 나왔습니다. 새 설치 직후라면 온보딩으로 채워야 할 항목 목록으로 보는 편이 맞습니다.

Q5. OpenClaw를 팀 공용 봇처럼 써도 되나요?+

공식 보안 문서는 OpenClaw를 개인 비서 신뢰 모델로 설명합니다. 서로 신뢰하지 않는 여러 사용자가 하나의 Gateway와 도구 권한을 공유하는 방식은 권장되지 않습니다. 팀에서 쓰려면 신뢰 경계와 권한 분리를 먼저 설계해야 합니다.

출처

• OpenClaw GitHub 저장소
• OpenClaw Getting started 문서
• OpenClaw Onboarding CLI 문서
• OpenClaw Security 문서
• npm registry openclaw latest