CLI 자동화 가이드

새로운 환경을 구축할 때마다 매번 터미널의 질문에 하나하나 답하는 과정은 꽤 번거로운 일이죠. 특히 여러 대의 서버를 설정하거나 CI/CD 파이프라인에서 작업을 자동화해야 할 때는 이런 대화형 인터페이스가 오히려 방해가 되기도 합니다.

이제 --non-interactive 플래그를 사용해서 이 과정을 깔끔하게 자동화해 보세요. 스크립트 하나로 필요한 모든 설정을 한 번에 끝낼 수 있습니다.

필요한 것

• openclaw CLI
• 사용하려는 서비스의 API Key (Anthropic, Gemini 등) 및 Node.js 환경

빠른 시작

5분 안에 자동화 설정을 마치는 방법이에요. 핵심은 openclaw onboard 명령어에 --non-interactive 플래그를 추가하는 것입니다.

기본 자동화 예시

이 스크립트는 로컬 모드에서 Anthropic API를 사용하도록 설정하며, Daemon을 Node.js 환경에서 실행하도록 구성합니다.

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice apiKey \
  --anthropic-api-key "$ANTHROPIC_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback \
  --install-daemon \
  --daemon-runtime node \
  --skip-skills

결과를 프로그램이 읽기 좋은 형태로 받고 싶다면 --json 플래그를 추가하세요. 다만, --json을 넣는다고 해서 자동으로 비대화형 모드가 되는 것은 아니니, 스크립트에서는 반드시 --non-interactive와 --workspace를 함께 사용하는 것이 좋습니다.

Provider별 설정 예시

사용 중인 Provider에 맞춰 아래 예시 코드를 복사해서 사용해 보세요.

Gemini

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

Z.AI

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

Vercel AI Gateway

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

Cloudflare AI Gateway

openclaw onboard --non-interactive \
  --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-port 18789 \
  --gateway-bind loopback

Moonshot

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

OpenCode Zen

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

에이전트 추가하기

openclaw agents add <name> 명령어를 사용하면 별도의 Workspace와 세션, 인증 프로필을 가진 에이전트를 새로 만들 수 있어요. --workspace 없이 실행하면 마법사(Wizard)가 시작되니 주의하세요.

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

이 명령어를 통해 설정되는 항목은 다음과 같습니다:

• agents.list[].name
• agents.list[].workspace
• agents.list[].agentDir

몇 가지 기억할 점이 있어요. 기본 Workspace 경로는 ~/.openclaw/workspace-<agentId> 형식을 따릅니다. 또한 들어오는 메시지를 라우팅하려면 bindings를 추가해야 하며, 자동화 시에는 --model, --agent-dir, --bind, --non-interactive 플래그를 주로 사용하게 됩니다.

설정 과정에서 도움이 필요하다면 AI Setup Assistant에게 언제든 물어보세요!

다음 단계

• 온보딩 허브: Onboarding Wizard (CLI)
• 전체 레퍼런스: CLI Onboarding Reference
• 명령어 상세 정보: openclaw onboard