참조 (Reference)

OpenClaw의 참조 문서는 Gateway 운영, 채널 설정, provider 인증, 구조화 파일 편집, backup, live docs 검색을 나눠서 봐야 합니다.

기준일: 2026-06-07
공식 기준: CLI reference, Config CLI, Environment

섹션 개요

빠른 참조

CLI 명령어

# 초기 설정과 진단
openclaw onboard
openclaw doctor
openclaw status --deep
openclaw health --verbose

# Gateway와 채널
openclaw gateway start
openclaw gateway status
openclaw channels status --probe
openclaw channels logs --channel all

# 설정
openclaw config get
openclaw config set <key> <value>
openclaw config unset <key>
openclaw config validate

# 라이브 문서와 구조화 파일
openclaw docs gateway token secretref
openclaw path resolve 'oc://gateway.jsonc/server/port' --human

# 백업과 모델/인증
openclaw backup create
openclaw models list
openclaw model auth status
openclaw auth setup-token

설정 파일 예시

기본 모델 경로는 agents.defaults.model.primary입니다.

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "claude-sonnet-4-20250514"
      }
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "dmPolicy": "pairing"
    }
  }
}

환경 변수

export OPENCLAW_CONFIG_PATH="$HOME/.openclaw/openclaw.jsonc"
export TELEGRAM_BOT_TOKEN="123456:ABC..."
export SLACK_BOT_TOKEN="xoxb-..."
export SLACK_APP_TOKEN="xapp-..."
export ANTHROPIC_API_KEY="sk-ant-..."

전역 단일 API 키나 워크스페이스 환경 변수를 기본 전제로 두지 않습니다. Provider credential은 provider별 auth/onboarding 흐름과 설정 검증으로 확인합니다.

선택 기준

실습

문제 상황을 한 번에 분리합니다.

openclaw doctor
openclaw config validate
openclaw gateway status
openclaw channels status --probe
openclaw model auth status
openclaw docs gateway token secretref

설정 파일의 특정 값을 안전하게 확인합니다.

openclaw path validate 'oc://gateway.jsonc/channels/telegram/enabled' --human
openclaw path resolve 'oc://gateway.jsonc/channels/telegram/dmPolicy' --human

도구에 입력할 프롬프트

내 OpenClaw 상태 점검 로그를 보고 설치, Gateway, 채널, 모델 인증, 설정 schema 문제를 분리해줘.
공식 CLI 명령 중 다음에 실행할 진단 명령만 제안하고,
설정 파일을 직접 수정하기 전에는 backup create를 먼저 넣어줘.

체크리스트

• 설정 삭제, 세션 조회, 스킬 조회는 현재 CLI의 config unset, sessions, skills 계열 명령으로 확인한다.
• 삭제는 openclaw config unset, 세션은 openclaw sessions, 스킬은 openclaw skills를 쓴다.
• channel liveness는 session 목록이 아니라 channels status --probe로 확인한다.
• 불확실한 문서 내용은 openclaw docs <query>로 현재 공식 문서를 검색한다.
• 설정 변경 전 openclaw backup create를 실행한다.

다음 단계

• CLI 명령어에서 주요 명령을 자세히 봅니다.
• Configuration에서 현재 설정 schema를 확인합니다.
• 환경 변수에서 provider/channel credential을 분리합니다.