guide13분 분량

설치 명령어 한 줄과 봇 토큰 하나: 에이전트를 처음 돌려보는 사람을 위한 OpenClaw 2.0 세팅

초보자를 위한 검증된 OpenClaw 2.0 설치 가이드입니다. 필요한 Node 버전, 에이전트에 모델을 붙이는 세 가지 방법과 각각의 비용, v2026.8.1에서 새로 들어온 6단계 가이드 온보딩이 묻는 순서, 텔레그램 4단계 페어링, 첫 주에 돌려볼 만한 작업 세 가지, 폭발 반경을 좁게 유지하는 첫날 권한 설정, 그리고 새 설치가 실제로 부딪히는 다섯 가지 실패를 모두 담았습니다.

K
Ken Jo
#openclaw#ai-agents#setup-guide#self-hosted#telegram#agent-security#local-llm#beginners

OpenClaw 설치에 관한 공식 수치는 좋은 의미로 심심합니다. 설치 스크립트는 2~5분. QuickStart 온보딩은 "몇 분". 그다음 openclaw dashboard를 입력하면 브라우저 탭이 열리고, 메시지를 보내면 무언가가 답합니다.

그러니까 어려운 건 설치가 아닙니다. 어려운 건 그다음 한 주입니다. 이 물건이 무엇을 건드리게 둘지, 무엇을 시킬지, 그리고 아무 말 없이 가만히 있을 때 왜 그런지 알아내는 일이죠.

이 글은 2.0 릴리스가 실제로 무엇을 바꿨는지 다룬 분석글의 실전 짝입니다. 여기에 분석은 없고 절차만 있습니다. 무엇을 준비할지, 정확히 어떤 명령어를 칠지, 새 가이드 온보딩이 어떤 순서로 무엇을 묻는지, 텔레그램에 어떻게 붙이는지, 크기가 알맞은 첫 작업 세 가지, 첫날 잡아둘 권한, 그리고 새 설치가 실제로 부딪히는 다섯 가지 실패. 아래 모든 명령어는 2026년 9월 1일에 확인한 OpenClaw 공식 문서에서 가져왔습니다. 문서가 말하지 않는 부분은 추측하지 않고 그렇다고 밝혔습니다.

한눈에 보기

  • Node.js 22.22.3+, 24.15+, 25.9+ 중 하나가 필요합니다(Node 26 권장). 그리고 AI 공급원 하나 — 이미 쓰고 있는 Claude·ChatGPT 로그인, API 키, 또는 로컬 모델 서버.
  • 초보자 경로는 한 줄입니다. curl -fsSL https://openclaw.ai/install.sh | bash — Node가 없으면 설치까지 해주고 온보딩까지 띄웁니다.
  • 2.0의 가이드 온보딩은 이미 쓸 수 있는 AI 접근 경로를 먼저 찾아보고, 실제 completion이 성공하기 전까지는 모델 경로를 저장하지 않습니다. 이 변경 하나가 예전 설치가 조용히 실패하던 가장 흔한 경로를 없앴습니다.

설치 스크립트, 가이드 온보딩, 게이트웨이 상태 확인, 대시보드 채팅, 선택 사항인 텔레그램 페어링까지 명령어와 대략적인 소요 시간이 표시된 OpenClaw 2.0 최초 실행 5단계 경로

1~4단계가 문서에 적힌 퀵스타트입니다. 출처: OpenClaw "Getting started" 및 "Install", 2026년 9월 1일 확인.

뭘 치기 전에 준비할 것

준비물은 셋, 그중 결정이 필요한 건 하나뿐이다.

지원되는 Node.js. OpenClaw 설치 문서는 Node 22.22.3+, 24.15+, 25.9+ 를 요구하고 Node 26을 권장합니다. node --version으로 확인하세요. Node가 아예 없으면 설치 스크립트가 알아서 넣어줍니다 — macOS에는 Node 26, 리눅스에는 Node 24 LTS.

깨어 있는 기계. macOS, 리눅스, 윈도우 모두 됩니다. 문서는 트레이드오프를 솔직하게 적어뒀습니다. 노트북은 가장 마찰이 적고 로컬 파일과 눈에 보이는 브라우저 창을 그대로 쓸 수 있지만, 절전·네트워크 끊김·OS 업데이트가 전부 실행을 끊습니다. 서버는 항상 켜져 있지만 화면이 없습니다. 문서에 적힌 VPS 최소 사양은 1 vCPU, 1 GB RAM, 디스크 약 500 MB이고, 여유를 위해 2 GB 이상을 권장합니다. 라즈베리파이 4(4 GB)로도 충분한데, 파이는 게이트웨이만 돌리고 모델은 네트워크 너머에서 호출되기 때문입니다.

지금 쓰는 노트북에서 시작하세요. 나중에 디렉터리 두 개만 복사하면 통째로 옮길 수 있고, 그 이전 절차도 문서에 있습니다.

AI 공급원. 여기가 결정 지점입니다. OpenClaw는 모델을 함께 배포하지 않고, 모델에 연결할 뿐입니다.

기존 Claude·ChatGPT 로그인 재사용, 종량제 API 키, 로컬 모델 세 가지 OpenClaw 모델 공급원과 각각의 비용대·주의점을 보여주는 의사결정 다이어그램

가이드 설정은 1번 경로를 자동으로 찾아냅니다. 요금은 2026년 9월 1일에 확인한 공급사 정가 기준.

모델 공급원비용어울리는 사람함정
기존 Claude 구독(Pro·Max·Team·Enterprise)추가 지출 없음이미 Anthropic에 매달 결제 중인 사람OpenClaw가 Claude CLI 로그인을 재사용합니다. Anthropic은 현재 이 경로를 별도 무료 할당이 아니라 구독 플랜 한도 안의 사용으로 처리하므로, 수다스러운 에이전트가 세션 예산을 다 먹을 수 있습니다
기존 ChatGPT·Codex 구독추가 지출 없음이미 ChatGPT 플랜을 쓰는 사람Codex OAuth로 완전히 지원되고, 온보딩이 OAuth 절차를 대신 진행해줍니다. OpenAI는 OpenClaw 같은 외부 도구에서의 구독 OAuth 사용을 명시적으로 허용합니다
공급사 API 키토큰 종량제예측 가능한 과금을 원하는 사람정가 폭이 넓습니다. Claude Sonnet 5는 입력 100만 토큰당 2달러, 출력 10달러. Claude Opus 5는 5달러와 25달러. OpenAI gpt-5.6-luna는 0.20달러와 1.20달러
로컬 모델(Ollama, LM Studio)토큰 비용 0데이터가 절대 기계 밖으로 나가면 안 되는 경우하드웨어 문턱이 진짜입니다. OpenClaw 로컬 모델 문서는 24 GB GPU 한 장으로는 "가벼운 프롬프트만, 그것도 더 느리게" 처리된다고 적었고, 작거나 심하게 양자화된 모델은 프롬프트 인젝션에 더 취약하다고 경고합니다

API 키 항목에는 실제 숫자를 붙여둡시다. "토큰 종량제"는 결정할 때 아무 도움이 안 되니까요. 하루 30번 대화, 매번 컨텍스트 약 8,000 토큰을 보내고 700 토큰을 돌려받는다고 하면 하루 입력 240,000 토큰, 출력 21,000 토큰입니다. Claude Sonnet 5 정가로는 하루 약 0.69달러, 월 21달러 언저리. gpt-5.6-luna로는 하루 약 0.07달러, 월 2.20달러 언저리. 실제 청구서가 아니라 공개 정가에 대입한 산수이고, 실제 컨텍스트는 생각보다 크고 캐싱이 일부를 되돌려줍니다. 하지만 자릿수는 잡아줍니다 — 수백 달러가 아니라 몇 달러 단위라는 것.

첫 설치라면 이렇게 권합니다. 이미 결제 중인 구독이 있으면 그걸 쓰세요. 아무것도 붙여넣지 않아도 가이드 설정이 찾아냅니다. 없다면 아무 공급사에서든 API 키를 받고, 온보딩을 돌리기 전에 그 공급사 콘솔에서 지출 상한을 걸어두세요. 로컬 모델은 나중으로 미루세요. 정당한 목적지이긴 하지만 출발선으로는 나쁩니다.

설치는 한 줄, 알아둘 만한 대안은 둘

문서가 말하는 초보자 경로는 설치 스크립트입니다. OS를 감지하고, 필요하면 Node를 깔고, OpenClaw를 설치하고, 온보딩까지 띄웁니다. 결정 네 개 대신 명령어 하나.

macOS·리눅스·WSL2:

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

윈도우 PowerShell:

iwr -useb https://openclaw.ai/install.ps1 | iex

설치는 이게 전부입니다. 오늘 쓰지 않더라도 알아둘 만한 대안이 둘 있습니다.

데스크톱 앱, 터미널에서 살고 싶지 않다면. 윈도우에는 서명된 Hub 설치 파일이 있어 다른 윈도우 앱처럼 실행하면 되고, macOS에는 프로젝트 GitHub 릴리스에서 .dmg로 배포되는 메뉴 막대 앱이 있습니다. 둘 다 최초 실행 설정에서 로컬 게이트웨이를 구성할 수 있습니다.

npm, Node를 이미 직접 관리한다면. npm 12 또는 npm 11.16 이상에서:

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

--allow-scripts=openclaw 플래그가 중요합니다. npm 12는 승인되지 않은 라이프사이클 스크립트를 기본으로 차단하고, 이 플래그가 없으면 OpenClaw의 preinstall·postinstall 단계를 "blocked because they are not covered by allowScripts"로 보고합니다. npm 11.15 이하에서는 같은 명령을 플래그 없이 실행하세요. Docker, Podman, Nix, 소스에서 pnpm 빌드도 모두 문서화되어 있고, 전부 첫 한 시간에는 잘못된 선택입니다.

2.0 가이드 온보딩이 순서대로 묻는 것

v2026.8.1이 초보자 경험을 가장 크게 바꾼 지점이라 미리 알고 있는 편이 낫습니다. 설치 스크립트가 대신 띄워주는 openclaw onboard는 이제 6단계 가이드 경로를 따릅니다.

  1. 보안 고지 수락. 읽으세요. 여러분이 받아들이는 신뢰 모델을 진술하는 화면이고, 그 내용은 이 글 뒷부분에서 평범한 말로 풀어놨습니다.
  2. 탐지가 읽기 전용으로 돌아갑니다. 이미 설정된 모델, API 키 환경 변수, 지원되는 로컬 AI CLI, 그리고 접근 가능한 Ollama·LM Studio 서버에 이미 설치되어 있는 도구 호출 가능 모델을 찾습니다. 이 단계는 모델을 절대 내려받지 않습니다. 문서에 명시된 두 가지 제외 사항을 기억하세요. Gemini CLI와 Antigravity는 탐지 설정 경로로 제공되지 않고, Pi와 OpenCode 설치는 참고용으로만 표시될 뿐 추론 경로로 쓰이지 않습니다.
  3. 첫 후보를 실제 completion으로 시험합니다. 실패하면 이유를 보여주고 다음 후보로 넘어갑니다. 망가진 경로를 저장하지 않습니다.
  4. 탐지가 아무것도 못 찾으면 공급사를 고릅니다. 첫 메뉴에 OpenAI, Anthropic, xAI(Grok), Google, OpenRouter가 나오고 나머지는 More…, 목록에 없는 엔드포인트는 Custom Provider 입니다. 두 번째 메뉴에서 그 공급사의 리전·플랜·지원 인증 방식(브라우저, 기기, API 키, 토큰)을 보여줍니다. 모든 경로가 똑같은 실제 completion 시험을 거칩니다. Skip for now 를 고르면 더 진행하지 않고 빠져나갑니다.
  5. 검증된 경로만 저장됩니다. 그 경로가 필요로 하는 자격 증명·플러그인 상태까지만요. 이 시점에는 워크스페이스와 게이트웨이 설정을 건드리지 않습니다.
  6. 설정 어시스턴트가 시작됩니다. 검증된 모델로 나머지를 대화로 구성합니다 — 워크스페이스, 게이트웨이, 채널, 에이전트, 플러그인.

그다음엔 직접 확인하세요.

openclaw gateway status     # 게이트웨이가 18789 포트에서 대기 중이어야 합니다
openclaw dashboard          # 브라우저에 Control UI가 열립니다

Control UI 채팅에 메시지를 하나 쳐보세요. 답이 오면 모든 계층이 동작하는 겁니다.

핵심은 이겁니다. 2.0에 대해 알아야 할 가장 유용한 사실 하나. 가이드 흐름은 동작을 증명하지 못한 모델 경로를 저장하지 않습니다. 그래서 이미 설정된 설치에서 openclaw onboard를 다시 돌리면 그대로 복구 절차가 됩니다. 현재 기본 모델을 먼저 시험하고, 실패해도 조용히 모델을 바꿔치기하지 않고 멈춰서 어떻게 할지 묻습니다.

가이드 온보딩이 일부러 하지 않는 일이 둘 있습니다. 원격 게이트웨이 설정, 채널 페어링 마법사, 데몬 제어, 스킬, 임포트는 다루지 않습니다 — 그건 openclaw onboard --classic의 클래식 마법사 몫입니다. 그리고 나중에 모델 공급사나 인증을 바꾸려면 어시스턴트를 나와 openclaw onboard를 다시 실행해야 합니다. 대화형 어시스턴트는 공급사 설정 흐름을 열지 않습니다.

텔레그램 연결: 네 단계와 찾아내야 할 숫자 하나

문서는 텔레그램을 가장 빨리 붙일 수 있는 채널로 꼽습니다. 봇 토큰 말고는 필요한 게 없기 때문이죠. DM 정책 기본값은 pairing이고, 그게 안전한 기본값이자 3단계가 존재하는 이유입니다.

  1. 봇을 만듭니다. 텔레그램에서 @BotFather 에게 메시지를 보내고(핸들이 정확히 그것인지 확인하세요) /newbot을 실행합니다. 안내를 따라간 뒤 토큰을 저장하세요. UI를 선호한다면 BotFather 웹 앱에서 진행하는 방법도 있습니다.

  2. 토큰을 설정 파일에 넣습니다. 위치는 ~/.openclaw/openclaw.json:

{
  channels: {
    telegram: {
      enabled: true,
      botToken: "123:abc",
      dmPolicy: "pairing",
      groups: { "*": { requireMention: true } },
    },
  },
}

환경 변수 TELEGRAM_BOT_TOKEN은 기본 계정에 한해 대체 수단으로 동작합니다. 텔레그램은 openclaw channels login telegram을 쓰지 않습니다. 설정이나 환경 변수에 토큰을 넣고 게이트웨이를 시작하세요.

  1. 게이트웨이를 켜고, 봇에게 DM을 보내고, 자기 자신을 승인합니다.
openclaw gateway
openclaw pairing list telegram
openclaw pairing approve telegram <CODE>

페어링 코드는 1시간 뒤 만료됩니다. 시간이 지났다면 봇에게 다시 메시지를 보내 새 코드를 받으세요.

  1. 텔레그램 숫자 사용자 ID를 찾아 고정합니다. 페어링 승인은 DM 접근만 허용할 뿐 전방위 인가가 아닙니다. 문서가 권하는 프라이버시 친화적 방법은 이렇습니다. 봇에게 DM을 보내고 openclaw logs --follow를 켠 뒤 로그 줄에서 from.id를 읽습니다. 공식 Bot API 방법은 curl "https://api.telegram.org/bot<bot_token>/getUpdates"를 호출해 message.from.id를 읽는 것입니다. 서드파티 ID 봇도 있지만 프라이버시 면에서 떨어집니다. 숫자를 얻었다면, 1인 소유 봇에 대한 문서의 권고는 과거 페어링 승인에 기대지 말고 dmPolicy: "allowlist"channels.telegram.allowFrom 으로 그 숫자 ID를 명시하는 것입니다.

그룹은 별개의 결정이고 별개의 함정을 갖고 있습니다. 텔레그램 봇은 기본적으로 Privacy Mode 상태라 애초에 받아보는 그룹 메시지가 제한됩니다. 전부 보게 하려면 BotFather /setprivacy로 프라이버시 모드를 끄거나 봇을 그룹 관리자로 만드세요. 그리고 전환한 뒤에는 각 그룹에서 봇을 뺐다가 다시 넣어야 텔레그램이 변경을 반영합니다. 첫날에는 그룹을 아예 건너뛰세요.

Discord, Signal, WhatsApp, Slack, iMessage, Matrix, Microsoft Teams를 비롯해 스무 개 넘는 채널이 각자의 문서 페이지와 함께 지원됩니다. 그중 봇 토큰만큼 빨리 세울 수 있는 건 없습니다.

첫 주에 어울리는 작업 세 가지

에이전트는 가져오기, 요약하기, 지켜보기, 알려주기를 잘합니다. 틀렸을 때 비싸고 아무도 확인하지 않는 일에는 미덥지 않습니다. 첫 작업은 틀려도 5초의 짜증으로 끝나는 것으로 고르세요.

첫 번째: 일회성 리마인더. 스케줄러, 모델, 전달 경로가 함께 동작하는지 증명하고, 끝나면 스스로 지워집니다.

openclaw automations create "2026-09-08T09:00:00Z" \
  --name "Reminder" \
  --session main \
  --system-event "Reminder: review the OpenClaw permissions I set on day one" \
  --wake now \
  --delete-after-run

두 번째: 반복되는 아침 브리핑. 스케줄 인자는 표준 cron 표현식을 받고, 프롬프트는 두 번째 위치 인자입니다.

openclaw automations create "0 7 * * *" \
  "Summarize what changed in my workspace notes since yesterday." \
  --name "Morning brief"

그리고 만든 것을 들여다보세요. 실행 기록을 읽는 게 에이전트가 실제로 무엇을 했는지 배우는 방법입니다.

openclaw automations list
openclaw automations runs --id <job-id>

자동화에 대해 지금 몸에 새겨둘 성질이 둘 있습니다. 자동화는 게이트웨이 프로세스 안에서 돌아갑니다. 즉 게이트웨이가 켜져 있을 때만 스케줄이 발동합니다 — 덮은 노트북은 멈춘 스케줄러입니다. 그리고 모든 실행이 백그라운드 작업 기록을 남기므로 openclaw tasks listopenclaw tasks audit이 미스터리 대신 감사 로그를 줍니다.

세 번째: 내 자료를 대상으로 한 읽기 전용 작업. 에이전트를 자기 워크스페이스에 붙여두고 요약·검색·비교를 시키세요. 쓰기 없음, 메일 없음, 캘린더 없음, 셸 없음. 지금 하는 일은 보정입니다. 한 주가 지나면 어떤 요청은 정확히 해내고 어떤 요청은 자신만만하게 틀리는지 구체적으로 알게 됩니다. 그 보정이 첫 주의 진짜 산출물입니다. 자동화가 아니라요.

미뤄둘 것 하나. 문서에 있는 메일 경로, 즉 IMAP 트리거는 정말 쓸모 있는 패턴이지만, 그 문서 자체가 전용 제한 리더 에이전트 뒤에 tools.profile: "minimal", workspaceAccess: "none" 샌드박스, 발신자 허용 목록, DMARC 기반 발신자 인증을 걸어두고 구성합니다. 낯선 사람의 텍스트를 모델에 닿게 하려면 딱 그만큼의 편집증이 맞고, 그건 첫날 프로젝트가 아닙니다.

첫날의 경계선: 무엇을 시킬지보다 어디까지 닿게 할지를 먼저 정한다

OpenClaw 보안 문서는 보수적인 기본값으로 출하된다는 선언으로 시작합니다. 게이트웨이는 루프백에 바인딩되고, 대부분의 채널은 모르는 사람의 DM을 처리하는 대신 페어링 코드로 응답하며, 그룹 접근은 멘션 게이트 뒤 허용 목록입니다. 첫날 여러분의 일은 대체로 이걸 무너뜨리지 않는 것입니다.

신뢰 모델을 평범한 말로. 게이트웨이 하나가 신뢰 경계 하나입니다. 도구가 켜진 에이전트에 메시지를 보낼 수 있는 사람은 모두 그 에이전트의 도구 권한을 공유합니다. 여러분 자신에게는 괜찮고, 이미 서로 신뢰하는 동료들에게도 괜찮으며, 서로 적대적인 사용자가 한 에이전트를 공유하는 경우에는 명시적으로 지원하지 않습니다. ~/.openclaw 아래 파일을 고칠 수 있는 사람은 정의상 신뢰받는 운영자입니다. 서로 신뢰하지 않는 사람들에게 서비스해야 한다면, 문서가 제시하는 답은 영리한 설정이 아니라 게이트웨이 분리, 가능하면 OS 계정이나 호스트까지 분리입니다.

명령어 하나가 이탈 여부를 알려줍니다.

openclaw security audit
openclaw security audit --fix    # 좁고 안전한 수정만 적용합니다

감사 도구 자체의 분류 순서가 좋은 초보자 우선순위 목록입니다. "열려 있음"과 도구 활성화가 겹치는 것이 먼저, 그다음 공개 네트워크 노출, 브라우저 제어 노출, 파일 권한, 플러그인, 마지막으로 모델 선택.

첫 주에 붙이지 말 것. 어떤 dmPolicy"open"으로 두지 마세요. 봇 사용자명을 찾아내거나 추측한 아무 텔레그램 계정이나 봇에게 명령할 수 있게 됩니다. 게이트웨이를 루프백 밖으로 노출하지 말고, Tailscale Funnel을 켜지 마세요. 샌드박스 밖에서 셸 명령을 실행하는 탈출구인 tools.elevated를 켜지 마세요. 읽어보지 않은 플러그인을 설치하지 마세요. 그리고 가능한 한 최신 세대의 강한 모델을 쓰세요. 문서는 약하거나 과하게 양자화된 모델이 프롬프트 인젝션에 더 취약하다고 분명히 적고 있고, 도구를 가진 에이전트가 남이 쓴 글을 읽는 순간 그게 문제가 됩니다.

가능한 곳에서는 읽기 전용으로 시작하세요. 문서에 있는 읽기 전용 프로필은 workspaceAccess: "ro" 샌드박스와 도구 거부 목록을 결합합니다.

{
  agents: {
    entries: {
      family: {
        default: true,
        workspace: "~/.openclaw/workspace-family",
        sandbox: { mode: "all", scope: "agent", workspaceAccess: "ro" },
        tools: {
          allow: ["read"],
          deny: ["write", "edit", "apply_patch", "exec", "process", "browser"],
        },
      },
    },
  },
}

멈추는 법. 필요해진 다음이 아니라 그 전에 알아두세요.

openclaw gateway stop        # 관리형 서비스를 멈춥니다
openclaw gateway restart     # 재시작 (stop + start를 이어 붙이지 마세요)
openclaw backup create       # 파괴적인 작업 전 스냅샷
openclaw uninstall --dry-run # 삭제하면 정확히 무엇이 사라지는지 확인

openclaw gateway stop은 비대화형 셸에서 --force를 요구합니다. macOS에서는 현재 부팅 세션에서 LaunchAgent를 제거하는데, 재부팅 뒤에도 멈춘 상태를 유지하려면 --disable을 붙이세요. 정말 뭔가 잘못됐을 때의 사고 대응 순서는 이렇습니다. 프로세스를 멈추고, gateway.bind: "loopback"으로 되돌리고, 위험한 DM을 dmPolicy: "disabled"로 바꾸고 모든 "*" 전체 허용 항목을 지웁니다.

초보자가 실제로 부딪히는 다섯 가지 실패

설치는 성공했는데 openclaw: command not found. 거의 항상 PATH 문제입니다. npm 전역 bin 디렉터리가 셸 PATH에 없는 것이죠. node -v, npm prefix -g, echo "$PATH"로 진단하세요. 윈도우라면 npm config get prefix를 확인해 그 디렉터리를 사용자 PATH에 추가하고 PowerShell을 다시 여세요.

설치 스크립트가 멈춘 것처럼 보임. --verbose로 다시 돌려 실제 피드백을 받으세요. curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --verbose. PowerShell 설치기에는 verbose 스위치가 없으니 Set-PSDebug -Trace 1로 감싸세요.

온보딩이 wake-up 문구를 띄웠는데 아무 답이 없고 토큰 카운트가 0에 멈춰 있음. 에이전트가 아예 실행되지 않은 겁니다. 게이트웨이를 재시작한 뒤 인증과 로그를 이 순서로 확인하세요.

openclaw gateway restart
openclaw status
openclaw models status
openclaw logs --follow
openclaw doctor

모델 설정을 건너뛰었다면 온보딩이 "Model auth missing" 안내를 띄웁니다. openclaw configure --section model로 해결하세요.

텔레그램 시작 시 getMe returned 401. 봇 토큰의 텔레그램 인증 실패입니다, 그 이상도 이하도 아닙니다. BotFather에서 토큰을 다시 복사하거나 재발급하고 channels.telegram.botToken을 갱신하세요. 시작 중 뜨는 deleteWebhook 401 Unauthorized도 같은 잘못된 토큰이 다른 호출에서 드러난 것입니다.

봇이 그룹 메시지를 무시함. 세 가지를 순서대로 확인하세요. 프라이버시 모드가 아직 켜져 있는지(BotFather /setprivacy 후 봇을 뺐다가 다시 추가), 그 그룹이 channels.telegram.groups에 실제로 등재됐는지, 그리고 openclaw logs --follow가 어떤 스킵 사유를 주는지. -100으로 시작하는 음수 슈퍼그룹 ID는 groupAllowFrom이 아니라 groups 아래에 들어갑니다 — 정말 흔한 혼동입니다.

이걸로도 안 되면 명령어 하나가 설치 상태를 진단으로 바꿔줍니다. openclaw triage는 읽기 전용 헬스 체크를 돌리고, 발견 내용을 정제된 프롬프트로 적은 뒤, 그 프롬프트를 여러분 기계의 코딩 에이전트에 넘길지 물어봅니다. 에이전트를 고르기 전까지는 아무것도 기계 밖으로 나가지 않고, 비밀 값·토큰·원본 채팅 페이로드·원본 로그는 프롬프트에서 제외됩니다.

다음에 볼 곳

목적지는 문서이고, 이 문서는 유난히 다니기 좋습니다. 아무 페이지 URL 뒤에 .md를 붙이면 깔끔한 마크다운이 나오고, docs.openclaw.ai/llms.txt는 모든 페이지와 한 줄 설명을 담은 완전한 색인입니다. 첫날 즐겨찾기에 넣을 페이지는 Getting started, Channels, Security, Automations입니다. openclaw docs는 터미널에서 이 색인을 검색합니다.

가기 전에 솔직한 한계 하나. 에이전트는 실수하고, 도구를 가진 에이전트는 무언가를 건드리는 실수를 합니다. OpenClaw 문서는 그 부분을 대놓고 적어뒀습니다. 검색·페치·MCP·플러그인·브라우저가 돌려주는 텍스트는 모델이 보기 전에 길이를 제한하고 정규화하고 신뢰할 수 없는 것으로 명시적으로 표시되지만, 그럼에도 "모델은 자신이 읽은 적대적인 자료에 여전히 영향받을 수 있습니다." 어떤 작업을 가능하게 하는 가장 좁은 권한만 주는 습관을 들이고, 특정 작업이 강제할 때만 경계를 넓히세요.

결론: 설치는 8분, 나머지 한 주는 판단

설치는 정말로 한 줄입니다. 온보딩은 정말로 이미 결제 중인 구독을 찾아냅니다. 어떤 설치 스크립트도 대신해줄 수 없는 건, 자율적으로 도는 프로세스가 내 이름으로 어디까지 닿아도 되는지 정하는 일입니다. 그리고 설치가 아니라 그 결정이, 에이전트로 실제 성과를 내는 사람과 두 주 뒤 조용히 안 열게 되는 사람을 가릅니다.

기껏해야 나를 짜증나게 할 수 있는 읽기 전용 에이전트로 시작하세요. 경계는 한 번에 권한 하나씩, 매번 특정 작업이 요구했기 때문에 넓히세요. 첫 주는 더 느려지고 두 번째 달은 훨씬 좋아집니다.

내가 보고 있지 않을 때, 프로그램에 정말로 맡길 수 있는 일은 무엇인가요?


Telli.sh는 어디에 들어맞나: 에이전트는 여러분이 넘긴 작업을 처리하고, Telli.sh는 사람과 나눈 대화의 기록을 남깁니다. 실시간 전사, 화자 분리, AI 요약을 회의에 적용하고, 44개 언어로 번역하며 인터페이스는 15개 언어를 지원합니다. 통화에서 내려진 결정이 기억이 아니라 검색 가능한 노트로 남도록요. 에이전트가 팀이 합의한 내용을 근거로 움직일 거라면, 그 합의를 먼저 정확하게 적어둔 무언가가 있어야 합니다.

실시간 AI 노트 시작하기

출처

  • OpenClaw — Getting started — Node 22.22.3+/24.15+/25.9+ 요구 사항, 설치 명령어, 18789 포트의 openclaw gateway status, openclaw dashboard, openclaw triage. 2026년 9월 1일 확인
  • OpenClaw — Install — 시스템 요구 사항, 데스크톱 앱 내려받기, npm·pnpm·bun 경로와 npm 12의 --allow-scripts=openclaw 정책, PATH 문제 해결 명령어. 2026년 9월 1일 확인
  • OpenClaw — Onboarding (CLI) — 6단계 가이드 기본 흐름, 실제 completion 검증 게이트, 공급사 메뉴, Gemini CLI·Antigravity 제외, --classic이 여전히 다루는 범위. 2026년 9월 1일 확인
  • OpenClaw — v2026.8.1 (OpenClaw 2.0) 릴리스 노트 — 로컬 custodian 흐름이 된 가이드 온보딩, 설정 후 브라우저 우선 핸드오프, 도구 출력에 대한 신뢰 불가 외부 콘텐츠 표시. 2026년 9월 1일 확인
  • OpenClaw — Telegram — BotFather /newbot, 설정 블록, openclaw pairing list/approve, 1시간 코드 만료, 프라이버시 모드와 봇 재추가 요구, -100 슈퍼그룹 ID 규칙, getMe returned 401 시그니처. 2026년 9월 1일 확인
  • OpenClaw — Security — 보수적 기본값, 게이트웨이당 하나의 신뢰 경계 모델, openclaw security audit과 분류 순서, 읽기 전용 에이전트 프로필, 사고 봉쇄 순서. 2026년 9월 1일 확인
  • OpenClaw — FAQ: first-run setup — 2~5분 설치 추정, Claude CLI 재사용과 플랜 한도 과금 주의, Codex OAuth 지원, 응답 없는 wake-up 복구 절차, VPS 최소 사양, 노트북 대 서버 트레이드오프. 2026년 9월 1일 확인
  • OpenClaw — FAQ: models and auth — 도구가 켜진 에이전트에 강한 모델을 권하는 지침과 Ollama 설정 경로. 2026년 9월 1일 확인
  • OpenClaw — Automationsopenclaw automations — 일회성·cron create 문법, 게이트웨이 내부 실행, 실행 기록. 2026년 9월 1일 확인
  • OpenClaw — Local models — 24 GB 단일 GPU 제약과 양자화 체크포인트의 프롬프트 인젝션 경고. 2026년 9월 1일 확인
  • OpenClaw — openclaw gatewayopenclaw uninstall — stop·restart 동작, 비대화형 셸의 --force 요구, --dry-run 삭제. 2026년 9월 1일 확인
  • Anthropic — 모델 요금 — Claude Sonnet 5 100만 토큰당 2달러·10달러, Claude Opus 5 5달러·25달러. 2026년 9월 1일 확인
  • OpenAI — API 요금 — gpt-5.6-luna 100만 토큰당 입력 0.20달러·출력 1.20달러. 2026년 9월 1일 확인
  • OpenClaw 2.0 릴리스가 실제로 무엇을 바꿨는지 다룬 짝 글

블로그로 돌아가기