OpenClaw
GitHub시작하기
상세 구성

OpenClaw 설정 가이드 - AI 모델 및 채팅 채널 설정

OpenClaw를 이미 설치하셨나요? AI 모델, 게이트웨이 설정, 채팅 채널 등을 구성하는 방법을 알아보세요

무엇을 구성하시겠습니까?

구성하려는 항목을 선택하여 해당 섹션으로 이동

OpenClaw 설정 개요

OpenClaw는 모든 구성을 ~/.openclaw 디렉토리에 저장합니다. 이 구조를 이해하면 설정을 관리하고 백업하는 데 도움이 됩니다.

파일 구조

~/.openclaw/openclaw.json기본 구성 파일
~/.openclaw/workspace/스킬, 프롬프트, 메모리
~/.openclaw/credentials/OAuth 및 API 자격 증명
~/.openclaw/agents/멀티 에이전트 구성
~/.openclaw/credentials/oauth.jsonOAuth 토큰 (Claude 등)

OpenClaw AI 모델 설정

필수

OpenClaw는 여러 AI 제공업체를 지원합니다. 선호하는 제공업체를 선택하고 설정 단계를 따르세요.

현재 구성:Anthropic - API Key

최적: 사용량 기반 결제가 포함된 표준 API 액세스. Anthropic Console에서 API 키를 생성하세요.

1

API 키 받기

Anthropic Console에서 API 키 생성

Anthropic Console 열기
2

CLI 설정

구성 마법사를 실행하거나 비대화형 모드 사용

대화형 (권장)

$ openclaw onboard
# choose: Anthropic API key

비대화형

$ openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
3

구성 파일 구조

구성 완료 후, openclaw.json의 관련 설정:

~/.openclaw/openclaw.json
{
  env: { ANTHROPIC_API_KEY: "sk-ant-..." },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-5" } } },
}

프롬프트 캐싱 (API 전용)

OpenClaw는 설정하지 않는 한 Anthropic의 기본 캐시 TTL을 재정의하지 않습니다. 구독 인증은 TTL 설정을 적용하지 않습니다.

~/.openclaw/openclaw.json
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-5": {
          params: { cacheControlTtl: "5m" }, // or "1h"
        },
      },
    },
  },
}

구성 확인

$ openclaw models status

이 명령을 실행하여 인증 구성이 작동하는지 확인

최상의 경험을 위해 Anthropic Claude를 권장합니다. 지원 모델: anthropic/claude-opus-4-5, anthropic/claude-sonnet-4-20250514, anthropic/claude-haiku 등.
참고: 인증은 에이전트별로 독립적입니다. 새 에이전트는 별도의 자격 증명 구성이 필요합니다.

OpenClaw 게이트웨이 설정

필수

게이트웨이는 AI와 채팅 플랫폼 간의 모든 메시지 라우팅을 처리하는 OpenClaw의 핵심 서비스입니다.

기본 설정

포트
18789
바인드 주소
127.0.0.1
인증 방식
token / password

자주 사용하는 명령

데몬 서비스 설치 (macOS/Linux 자동 감지)

$ openclaw gateway install

게이트웨이 상태 확인

$ openclaw gateway status

실시간 로그 보기

$ openclaw logs --follow

원격 액세스

SSH 터널을 통해 원격 서버의 게이트웨이에 안전하게 액세스:

$ ssh -N -L 18789:127.0.0.1:18789 user@host
전체 게이트웨이 문서 보기

OpenClaw 채팅 채널 설정

최소 1개

OpenClaw를 선호하는 채팅 플랫폼에 연결하세요. 각 채널은 고유한 설정 프로세스가 있습니다.

현재 구성:WhatsApp
1

WhatsApp 계정 관리

WhatsApp 계정 로그인 또는 로그아웃

로그인 (QR 코드 생성)

$ openclaw channels login whatsapp

로그아웃 (재연결 시 사용)

$ openclaw channels logout whatsapp
2

QR 코드 스캔

휴대폰에서 WhatsApp을 열고 설정 → 연결된 기기 → QR 코드 스캔

QR 코드

WhatsApp 모바일 앱으로 스캔

3

페어링 승인

첫 번째 메시지에서 페어링 코드를 받습니다. 승인하여 채팅을 시작하세요.

$ openclaw pairing list whatsapp
$ openclaw pairing approve whatsapp [CODE]
전용 전화번호를 사용하세요. VoIP 번호는 쉽게 차단될 수 있어 권장되지 않습니다.
자격 증명은 ~/.openclaw/credentials/whatsapp/ 디렉토리에 저장됩니다.
전체 WhatsApp 구성 문서 보기

OpenClaw 스킬 관리

선택

스킬은 OpenClaw의 기능을 확장합니다. 스킬을 설치하고 관리하여 AI 어시스턴트를 향상시키세요.

사용 가능한 스킬 목록

$ openclaw skills list

스킬 설치

$ openclaw skills install <skill-name>

스킬 활성화

$ openclaw skills enable <skill-name>

인기 스킬

웹 검색

웹을 검색하고 결과 요약

web-search
코드 인터프리터

샌드박스 환경에서 코드 실행

code-interpreter
파일 관리자

파일 읽기, 쓰기, 관리

file-manager
캘린더

캘린더 이벤트 및 알림 관리

calendar
전체 스킬 구성 문서 보기

OpenClaw 고급 설정

선택

복잡한 설정 및 자동화를 위한 파워 유저 기능.

멀티 에이전트 설정

다른 컨텍스트(업무, 개인 등)를 위한 별도의 에이전트를 생성합니다. 각 에이전트는 고유한 워크스페이스, 세션, 자격 증명을 가집니다.

$ openclaw agents add work
$ openclaw agents list
$ openclaw agents switch work

비대화형 모드

스크립트 또는 CI/CD 파이프라인에서 OpenClaw 설정 자동화.

$ openclaw onboard --non-interactive \
  --mode local \
  --auth-choice apiKey \
  --anthropic-api-key "$ANTHROPIC_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback

예약 작업

cron 스타일 스케줄링을 사용하여 자동화된 메시지 및 작업 설정.

cron.json
# ~/.openclaw/cron.json
{
  "jobs": [
    {
      "schedule": "0 9 * * *",
      "action": "send",
      "channel": "telegram",
      "message": "Good morning! Here's your daily briefing..."
    }
  ]
}
전체 고급 구성 문서 보기

구성 완료!

OpenClaw가 완전히 구성되었습니다. AI 어시스턴트와 채팅을 시작하세요.

다음 단계