openclaw agent 단일 호출 명령 튜토리얼

명령 개요

openclaw agent 명령을 사용하면 명령줄에서 직접 AI에 단일 요청을 보내고 응답을 받을 수 있으며, 채널을 거칠 필요가 없습니다. 빠른 테스트, 스크립트 통합 및 자동화 워크플로에 적합합니다.

기본 사용법

openclaw agent "안녕하세요, 자기소개를 해주세요"

출력:

안녕하세요! 저는 OpenClaw AI 어시스턴트입니다. 질문 답변, 코드 작성,
텍스트 번역 등을 도와드릴 수 있습니다. 무엇을 도와드릴까요?

모델 지정

# 설정에 정의된 모델 별칭 사용
openclaw agent --model gpt-4o "양자 컴퓨팅의 기본 원리를 설명해주세요"

# 공급자와 모델명 사용
openclaw agent --provider openai --model gpt-4o-mini "정렬 알고리즘을 작성해주세요"

시스템 프롬프트 전달

openclaw agent \
  --system "당신은 전문 Python 프로그래머이며, Python으로만 답변합니다" \
  "이진 트리의 중위 순회를 구현해주세요"

표준 입력에서 읽기

# 파이프 입력
echo "영어로 번역: 오늘 날씨가 좋습니다" | openclaw agent

# 파일에서 읽기
cat error.log | openclaw agent "이 로그에서 오류 원인을 분석해주세요"

# Here document
openclaw agent <<EOF
다음 코드를 검토해주세요:
def add(a, b):
    return a - b
EOF

스트리밍 출력

# 스트리밍 출력 활성화 (실시간으로 생성 내용 표시)
openclaw agent --stream "인공지능에 대한 짧은 글을 작성해주세요"

출력 형식

# 일반 텍스트 (기본)
openclaw agent "안녕하세요"

# JSON 형식
openclaw agent --format json "안녕하세요"

JSON 출력:

{
  "content": "안녕하세요! 무엇을 도와드릴까요?",
  "model": "gpt-4o-mini",
  "usage": {
    "promptTokens": 12,
    "completionTokens": 15,
    "totalTokens": 27
  },
  "latency": 850
}

모델 파라미터 조정

openclaw agent \
  --temperature 0.2 \
  --max-tokens 1000 \
  --top-p 0.9 \
  "프로젝트 이름 5개를 추천해주세요"

도구 사용

AI가 도구를 호출할 수 있도록 허용합니다:

openclaw agent --tools web_search "오늘 서울의 날씨는 어떤가요?"

openclaw agent --tools code_exec "fibonacci(30)의 값을 계산해주세요"

# 여러 도구
openclaw agent --tools web_search,code_exec "Python 최신 버전을 검색하고 테스트 코드를 실행해주세요"

다중 턴 대화

agent는 주로 단일 호출용이지만 간단한 다중 턴 대화도 지원합니다:

# session ID를 사용하여 컨텍스트 유지
openclaw agent --session my-test "제 이름은 김철수입니다"
openclaw agent --session my-test "제 이름이 무엇인가요?"
# 출력: 김철수입니다.

스크립트 통합 예시

Shell 스크립트에서 사용

#!/bin/bash
# Git commit message 자동 생성
DIFF=$(git diff --cached)
MESSAGE=$(echo "$DIFF" | openclaw agent --model gpt-4o-mini \
  --system "git diff를 기반으로 간결한 commit message를 생성하세요. message만 출력하고 다른 내용은 포함하지 마세요" \
  --format text)

git commit -m "$MESSAGE"

일괄 처리

#!/bin/bash
# 파일 일괄 번역
for file in docs/*.md; do
  openclaw agent --model gpt-4o-mini \
    --system "다음 Markdown 내용을 영어로 번역하세요. 형식을 유지하세요" \
    < "$file" > "translated/$(basename $file)"
done

jq와 함께 사용

# JSON에서 특정 필드 추출
openclaw agent --format json "랜덤 사용자 데이터 3개를 생성해주세요" | jq '.content'

종료 코드

0: 성공
1: 일반 오류
2: 인증 오류
3: 모델 사용 불가
4: 속도 제한

openclaw agent "테스트" || echo "호출 실패, 종료 코드: $?"

타임아웃 설정

openclaw agent --timeout 30 "복잡한 질문..."

디버그 모드

openclaw agent --debug "안녕하세요"

요청 및 응답의 상세 정보가 포함된 출력:

[DEBUG] Provider: openai
[DEBUG] Model: gpt-4o-mini
[DEBUG] Request tokens: 12
[DEBUG] Response time: 850ms
[DEBUG] Response tokens: 15

안녕하세요! 무엇을 도와드릴까요?

정리

openclaw agent는 OpenClaw CLI에서 가장 유연한 명령 중 하나로, AI 기능을 직접 명령줄로 가져옵니다. AI 호출을 다른 Unix 도구처럼 파이프, 스크립트 및 자동화 프로세스에 조합하여 사용할 수 있습니다.