CLI 자동화

스크립트로 설정하려면 openclaw onboard --non-interactive를 사용하세요. 이 명령에는 --accept-risk가 필요합니다. 비대화형 설정은 확인 메시지 없이 자격 증명과 데몬 구성을 기록할 수 있으므로, 이 플래그는 위험을 명시적으로 인정한다는 의미입니다.

--json은 비대화형 모드를 의미하지 않습니다. 스크립트에서는 --non-interactive --accept-risk를 명시적으로 전달하세요.

기본 비대화형 예시

openclaw onboard --non-interactive --accept-risk \
  --mode local \
  --auth-choice apiKey \
  --anthropic-api-key "$ANTHROPIC_API_KEY" \
  --secret-input-mode plaintext \
  --gateway-bind loopback \
  --install-daemon \
  --daemon-runtime node \
  --skip-bootstrap \
  --skip-skills

기계가 읽을 수 있는 요약을 출력하려면 --json을 추가하세요.

--gateway-port의 기본값은 18789입니다. 기본값을 재정의할 때만 전달하세요.
--skip-bootstrap은 기본 작업 공간 파일 생성을 건너뜁니다. 자체 작업 공간을 미리 구성하는 자동화에 사용합니다.
--secret-input-mode ref는 일반 텍스트 키 대신 환경 변수 기반 참조({ source: "env", provider: "default", id: "<ENV_VAR>" })를 인증 프로필에 저장합니다. 비대화형 ref 모드에서는 제공자 환경 변수가 프로세스 환경에 이미 설정되어 있어야 합니다. 인라인 키 플래그를 전달하면서 이에 대응하는 환경 변수가 없으면 즉시 실패합니다.

openclaw onboard --non-interactive --accept-risk \
  --mode local \
  --auth-choice openai-api-key \
  --secret-input-mode ref

제공자별 예시

Anthropic API 키 예시

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

Cloudflare AI Gateway 예시

openclaw onboard --non-interactive --accept-risk \
  --mode local \
  --auth-choice cloudflare-ai-gateway-api-key \
  --cloudflare-ai-gateway-account-id "your-account-id" \
  --cloudflare-ai-gateway-gateway-id "your-gateway-id" \
  --cloudflare-ai-gateway-api-key "$CLOUDFLARE_AI_GATEWAY_API_KEY" \
  --gateway-bind loopback

Gemini 예시

openclaw onboard --non-interactive --accept-risk \
  --mode local \
  --auth-choice gemini-api-key \
  --gemini-api-key "$GEMINI_API_KEY" \
  --gateway-bind loopback

Mistral 예시

openclaw onboard --non-interactive --accept-risk \
  --mode local \
  --auth-choice mistral-api-key \
  --mistral-api-key "$MISTRAL_API_KEY" \
  --gateway-bind loopback

Moonshot 예시

openclaw onboard --non-interactive --accept-risk \
  --mode local \
  --auth-choice moonshot-api-key \
  --moonshot-api-key "$MOONSHOT_API_KEY" \
  --gateway-bind loopback

Ollama 예시

openclaw onboard --non-interactive --accept-risk \
  --mode local \
  --auth-choice ollama \
  --custom-model-id "qwen3.5:27b" \
  --gateway-bind loopback

OpenCode 예시

openclaw onboard --non-interactive --accept-risk \
  --mode local \
  --auth-choice opencode-zen \
  --opencode-zen-api-key "$OPENCODE_API_KEY" \
  --gateway-bind loopback

Go 카탈로그를 사용하려면 --auth-choice opencode-go --opencode-go-api-key "$OPENCODE_API_KEY"로 바꾸세요.

Synthetic 예시

openclaw onboard --non-interactive --accept-risk \
  --mode local \
  --auth-choice synthetic-api-key \
  --synthetic-api-key "$SYNTHETIC_API_KEY" \
  --gateway-bind loopback

Vercel AI Gateway 예시

openclaw onboard --non-interactive --accept-risk \
  --mode local \
  --auth-choice ai-gateway-api-key \
  --ai-gateway-api-key "$AI_GATEWAY_API_KEY" \
  --gateway-bind loopback

Z.AI 예시

openclaw onboard --non-interactive --accept-risk \
  --mode local \
  --auth-choice zai-api-key \
  --zai-api-key "$ZAI_API_KEY" \
  --gateway-bind loopback

사용자 지정 제공자 예시

openclaw onboard --non-interactive --accept-risk \
  --mode local \
  --auth-choice custom-api-key \
  --custom-base-url "https://llm.example.com/v1" \
  --custom-model-id "foo-large" \
  --custom-api-key "$CUSTOM_API_KEY" \
  --custom-provider-id "my-custom" \
  --custom-compatibility anthropic \
  --custom-image-input \
  --gateway-bind loopback

--custom-api-key는 선택 사항입니다. 일부 엔드포인트에는 인증이 필요하지 않습니다. 생략하면 온보딩 과정에서 환경 변수의 CUSTOM_API_KEY를 확인합니다. --custom-provider-id는 선택 사항이며, 생략하면 기본 URL에서 자동으로 파생됩니다. --custom-compatibility의 기본값은 openai입니다(다른 값: openai-responses, anthropic).OpenClaw는 알려진 비전 모델 ID 패턴(gpt-4o, claude-3/4, gemini, -vl/vision 접미사 등)을 바탕으로 이미지 입력 지원 여부를 추론합니다. 인식되지 않는 비전 모델에서 이미지 입력을 강제로 활성화하려면 --custom-image-input을 추가하고, 텍스트 전용으로 강제하려면 --custom-text-input을 추가하세요.apiKey를 { source: "env", provider: "default", id: "CUSTOM_API_KEY" }로 저장하는 참조 모드 변형:

export CUSTOM_API_KEY="your-key"
openclaw onboard --non-interactive --accept-risk \
  --mode local \
  --auth-choice custom-api-key \
  --custom-base-url "https://llm.example.com/v1" \
  --custom-model-id "foo-large" \
  --secret-input-mode ref \
  --custom-provider-id "my-custom" \
  --custom-compatibility anthropic \
  --custom-image-input \
  --gateway-bind loopback

Anthropic 설정 토큰 인증은 계속 지원되지만, 로컬 Claude CLI 로그인을 사용할 수 있으면 OpenClaw는 Claude CLI 재사용을 우선합니다. 프로덕션 환경에서는 Anthropic API 키를 사용하는 것이 좋습니다.

다른 에이전트 추가

openclaw agents add <name>은 자체 작업 공간, 세션 및 인증 프로필을 사용하는 별도의 에이전트를 생성합니다. --workspace와 다른 플래그를 지정하지 않고 실행하면 대화형 마법사가 시작됩니다. --workspace, --model, --agent-dir, --bind, --non-interactive 중 하나라도 전달하면 비대화형으로 실행되며, 이 경우 --workspace가 필요합니다.

openclaw agents add work \
  --workspace ~/.openclaw/workspace-work \
  --model openai/gpt-5.6-sol \
  --bind whatsapp:biz \
  --non-interactive \
  --json

기록되는 구성 키(새 에이전트 ID의 agents.list[] 항목):

name
workspace
agentDir
model (--model을 전달한 경우에만)

참고:

기본 작업 공간(대화형 마법사에서 --workspace를 생략한 경우): ~/.openclaw/workspace-<agentId>.
--bind <channel[:accountId]>는 반복해서 지정할 수 있습니다. 수신 메시지를 새 에이전트로 라우팅하려면 바인딩을 추가하세요(마법사에서도 대화형으로 설정할 수 있습니다).
에이전트 이름은 유효한 에이전트 ID로 정규화됩니다. main은 예약되어 있습니다.

개요

첫 단계

Guides

기본 비대화형 예시

제공자별 예시

다른 에이전트 추가

관련 문서

​기본 비대화형 예시

​제공자별 예시

​다른 에이전트 추가

​관련 문서

기본 비대화형 예시

제공자별 예시

다른 에이전트 추가

관련 문서