OpenClawDocs
이 페이지에서

이 페이지에서

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Setup guides and reference

CLI 자동화

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

기본 비대화형 예시

bash
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 모드에서는 제공자 환경 변수가 프로세스 환경에 이미 설정되어 있어야 합니다. 인라인 키 플래그를 전달하면서 이에 대응하는 환경 변수가 없으면 즉시 실패합니다.
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice openai-api-key \  --secret-input-mode ref

제공자별 예시

Anthropic API 키 예시
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice apiKey \  --anthropic-api-key "$ANTHROPIC_API_KEY" \  --gateway-bind loopback
Cloudflare AI Gateway 예시
bash
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 예시
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice gemini-api-key \  --gemini-api-key "$GEMINI_API_KEY" \  --gateway-bind loopback
Mistral 예시
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice mistral-api-key \  --mistral-api-key "$MISTRAL_API_KEY" \  --gateway-bind loopback
Moonshot 예시
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice moonshot-api-key \  --moonshot-api-key "$MOONSHOT_API_KEY" \  --gateway-bind loopback
Ollama 예시
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice ollama \  --custom-model-id "qwen3.5:27b" \  --gateway-bind loopback
OpenCode 예시
bash
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 예시
bash
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 예시
bash
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 예시
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice zai-api-key \  --zai-api-key "$ZAI_API_KEY" \  --gateway-bind loopback
사용자 지정 제공자 예시
bash
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" }로 저장하는 참조 모드 변형:

bash
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가 필요합니다.

bash
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은 예약되어 있습니다.

관련 문서

Was this useful?