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

Guides

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?
On this page

On this page