openclaw agent로 직접 에이전트 실행하기

에이전트가 잘 작동하는지 확인하려고 매번 메시징 앱을 열어 메시지를 보내고 계신가요? 반복적인 테스트나 자동화 작업을 할 때 매번 채팅 인터페이스를 거치는 건 효율이 떨어지죠.

터미널에서 명령 한 줄로 에이전트를 즉시 실행할 수 있다면 훨씬 편할 거예요. openclaw agent 명령어를 쓰면 인바운드 메시지 없이도 에이전트의 턴을 바로 시작할 수 있습니다.

필요한 것

• openclaw CLI
• --local 옵션 사용 시: 쉘(Shell) 환경 변수에 설정된 model provider API keys

빠른 시작

openclaw agent는 기본적으로 Gateway를 통해 실행돼요. 만약 현재 장비에 내장된 런타임으로 강제 실행하고 싶다면 --local 플래그를 추가하면 됩니다.

가장 기본적인 실행 방법은 --message와 함께 대상을 지정하는 거예요.

# 특정 번호로 메시지 전송 및 실행
openclaw agent --to +15555550123 --message "status update"

# 특정 에이전트에게 작업 지시
openclaw agent --agent ops --message "Summarize logs"

세션과 출력 방식을 제어하는 방법은 다음과 같습니다.

• 세션 선택: --to로 대상을 지정하거나, --session-id로 기존 세션을 재사용할 수 있어요. --agent를 쓰면 해당 에이전트의 main 세션을 사용합니다.
• 결과 확인: 기본적으로 응답 텍스트를 출력하지만, --json 플래그를 쓰면 메타데이터가 포함된 구조화된 데이터를 볼 수 있어요.
• 결과 전달: --deliver와 --channel을 조합하면 실행 결과를 특정 채널(Slack, Discord 등)로 보낼 수 있습니다.

다양한 옵션을 조합한 예시를 확인해 보세요.

# 세션 ID를 지정하고 thinking 레벨 설정
openclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium

# 상세 로그와 함께 JSON 형식으로 출력
openclaw agent --to +15555550123 --message "Trace logs" --verbose on --json

# 실행 결과를 Slack 채널로 전달
openclaw agent --agent ops --message "Generate report" --deliver --reply-channel slack --reply-to "#reports"

주요 Flags

• --local: 로컬에서 실행 (API keys 필요)
• --deliver: 응답을 선택한 채널로 전송
• --channel: 전송할 채널 선택 (whatsapp|telegram|discord|googlechat|slack|signal|imessage)
• --thinking <off|minimal|low|medium|high|xhigh>: thinking 수준 설정 (GPT-5.2 + Codex 모델 전용)
• --verbose <on|full|off>: 상세 출력 수준 설정
• --json: JSON 형식으로 출력

문제 해결

만약 Gateway에 연결할 수 없는 상태라면 어떻게 될까요? 걱정하지 마세요. CLI가 자동으로 로컬 임베디드 실행 모드로 fallback하여 작업을 계속 진행합니다.

설정된 타임아웃보다 작업이 길어진다면 --timeout <seconds> 플래그를 사용해 제한 시간을 직접 늘려보세요.

---

궁금한 점이 더 있다면 AI Setup Assistant에게 물어보세요.

다음 단계

• openclaw message 사용법
• Gateway 구성 가이드