명령 개요
openclaw agents 명령은 여러 AI 에이전트(Agent)를 관리하는 데 사용됩니다. 각 에이전트는 서로 다른 페르소나, 모델, 스킬 및 동작 설정을 가질 수 있으며, 다중 역할 AI가 필요한 시나리오에 적합합니다.
에이전트 목록 조회
openclaw agents list
출력:
Agents:
default gpt-4o-mini Active General assistant
code-helper gpt-4o Active Programming assistant
translator gpt-4o-mini Active Translation specialist
customer-svc claude-sonnet Inactive Customer service bot
새 에이전트 생성
openclaw agents create assistant-ko
대화형 생성:
Creating new agent: assistant-ko
Display name: 한국어 어시스턴트
Description: 한국어 대화에 특화된 AI 어시스턴트
Model [gpt-4o-mini]: qwen-72b
System prompt: 당신은 전문 한국어 AI 어시스턴트로, 한국어 작문, 번역, 지식 Q&A에 능숙합니다. 항상 한국어로 답변하세요.
Agent 'assistant-ko' created successfully.
비대화형 생성:
openclaw agents create code-expert \
--display-name "코드 전문가" \
--model gpt-4o \
--system "당신은 시니어 풀스택 엔지니어로, 코드 리뷰, 아키텍처 설계, 기술 방안 작성에 능숙합니다." \
--tools code_exec,web_search \
--temperature 0.3
에이전트 설정 상세 정보
openclaw agents show code-expert
출력:
Agent: code-expert
Display Name: 코드 전문가
Model: gpt-4o
Temperature: 0.3
Max Tokens: 4096
System Prompt: 당신은 시니어 풀스택 엔지니어로...
Tools: code_exec, web_search
Channels: discord-dev
Status: Active
Created: 2026-03-14
Messages: 1,520
에이전트 설정 수정
# 모델 변경
openclaw agents update code-expert --model gpt-4o-mini
# 시스템 프롬프트 변경
openclaw agents update code-expert --system "새로운 시스템 프롬프트"
# 온도 변경
openclaw agents update code-expert --temperature 0.5
# 도구 추가
openclaw agents update code-expert --add-tool image_gen
에이전트를 채널에 할당
# 에이전트를 채널에 할당
openclaw agents assign code-expert --channel discord-dev
openclaw agents assign assistant-ko --channel wechat-main
# 에이전트의 채널 할당 조회
openclaw agents channels code-expert
하나의 채널에는 하나의 에이전트만 바인딩할 수 있지만, 하나의 에이전트는 여러 채널에 서비스할 수 있습니다.
에이전트 간 라우팅
메시지 라우팅 규칙을 설정하여 내용에 따라 자동으로 다른 에이전트에 분배합니다:
{
"routing": {
"enabled": true,
"rules": [
{
"match": "코드|프로그래밍|bug|함수",
"agent": "code-expert"
},
{
"match": "번역|translate",
"agent": "translator"
},
{
"match": ".*",
"agent": "default"
}
]
}
}
에이전트 활성화/비활성화
# 에이전트 비활성화 (메시지 처리 중지)
openclaw agents disable customer-svc
# 에이전트 활성화
openclaw agents enable customer-svc
에이전트 삭제
openclaw agents delete old-agent
참고: 에이전트를 삭제해도 해당 대화 기록은 삭제되지 않습니다.
에이전트 통계
openclaw agents stats code-expert
Agent Stats: code-expert (last 7 days)
Messages processed: 342
Avg response time: 2.1s
Token usage: 125,000
Estimated cost: $1.25
Active sessions: 5
Error rate: 0.3%
일괄 관리
# 모든 에이전트 설정 내보내기
openclaw agents export agents-backup.json
# 에이전트 설정 가져오기
openclaw agents import agents-backup.json
# 일괄 모델 업데이트
openclaw agents update-all --model gpt-4o-mini
설정 파일에서 에이전트 정의
{
"agents": {
"code-expert": {
"displayName": "코드 전문가",
"model": "gpt-4o",
"systemPrompt": "당신은 시니어 엔지니어입니다...",
"temperature": 0.3,
"tools": ["code_exec", "web_search"],
"maxTokens": 4096
},
"translator": {
"displayName": "번역가",
"model": "gpt-4o-mini",
"systemPrompt": "당신은 전문 번역가입니다...",
"temperature": 0.3,
"maxTokens": 2048
}
}
}
정리
openclaw agents를 사용하면 하나의 OpenClaw 인스턴스에서 서로 다른 능력과 페르소나를 가진 여러 AI 에이전트를 실행할 수 있습니다. 적절한 에이전트 역할 분담과 라우팅 설정을 통해 다양한 사용자 그룹에게 맞춤형 AI 서비스를 제공할 수 있습니다.