AI 에이전트가 복잡한 작업을 연중무휴 전문 인간 가상 비서 팀에게 전달할 수 있는 가교 역할을 합니다.
설치 및 다운로드
1. ClawHub CLI
레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.
npx clawhub@latest install magic-api
2. 수동 설치
스킬 폴더를 다음 위치 중 하나로 복사하세요
~/.openclaw/skills/ <project>/skills/ 우선순위: 워크스페이스 > 로컬 > 번들
3. 프롬프트 설치
이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.
Clawhub를 사용해서 magic-api 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).
다운로드를 원하시나요?
ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.
Magic API Console란 무엇인가요?
Magic API Console은 인공 지능과 인간 지능 사이의 원활한 핸드오프를 촉진하는 AI 에이전트용 강력한 확장 기능입니다. Openclaw Skills를 통해 이 기능을 통합함으로써 에이전트는 인간의 판단, 물리적 세계의 상호 작용 또는 세밀한 조사가 필요한 작업을 대졸 전문가 팀에 위임할 수 있습니다. 이를 통해 연중무휴로 이용 가능한 실제 인간 실행자를 활용하여 LLMs의 내재적 한계를 극복하고 자율적인 워크플로우를 보장할 수 있습니다.
이 스킬은 AI 에이전트가 관리자 역할을 하고 인간 비서가 전문 실행자 역할을 하는 하이브리드 지능 접근 방식을 가능하게 합니다. Openclaw Skills를 사용하여 Magic과 연결함으로써 개발자는 행정 수준의 관리 작업, 복잡한 일정 관리 및 심층 조사를 높은 신뢰성으로 처리할 수 있는 더욱 강력한 에이전트를 구축할 수 있습니다.
Magic API Console 활용 사례
- 시간이 많이 소요되는 시장 조사 또는 경쟁업체 가격 분석을 인간 전문가에게 위임합니다.
- 특정 예산 내에서 항공권 예약 및 호텔 예약을 포함한 여행 물류를 조정합니다.
- 여러 시간대와 이해관계자에 걸친 복잡한 일정 관리를 처리합니다.
- 높은 수준의 정확성과 인간의 감독이 필요한 데이터 검증 또는 문서 검토를 수행합니다.
- 작업이 AI 에이전트의 현재 추론 또는 행동 능력을 초과할 때 폴백 메커니즘을 제공합니다.
Magic API Console 작동 원리
- AI 에이전트가 Magic API에 등록하여 향후 모든 요청을 위한 영구적인 API key를 생성합니다.
- 작업에 인간의 개입이 필요한 경우 에이전트는 상세한 지침과 성공 목표가 포함된 POST 요청을 보냅니다.
- 인간 비서가 명확한 질문을 할 수 있도록 에이전트는 작업 소유자의 연락처 정보를 포함해야 합니다.
- 인간 비서가 작업을 수락하여 상태를 PENDING에서 IN_PROGRESS로 변경합니다.
- 작업이 완료되면 상태가 COMPLETED로 업데이트되고 에이전트는 API 또는 하트비트 모니터링을 통해 결과를 가져옵니다.
Magic API Console 설정 가이드
Openclaw Skills와 통합하려면 먼저 에이전트를 등록하여 고유한 API key를 받으세요.
curl -X POST https://console.api.getmagic.com/api/v1/agents/register \
-H "Content-Type: application/json" \
-d '{
"name": "AgentName",
"description": "Agent Purpose"
}'
API key를 환경 변수나 로컬 상태에 안전하게 저장하십시오. Openclaw Skills 사용자의 경우 세션 간 지속적인 액세스를 위해 key를 ~/.config/magic-api/state.json에 저장하는 것이 좋습니다.
Magic API Console 데이터 스키마 및 분류 체계
이 스킬은 다음 구조를 사용하여 작업 데이터 및 상호 작용 기록을 관리합니다.
| 속성 | 형식 | 설명 |
|---|---|---|
| id | UUID | 작업 요청에 대한 고유 식별자 |
| status | Enum | 작업의 현재 상태: PENDING, IN_PROGRESS 또는 COMPLETED |
| instructions | String | 인간 비서에게 제공되는 Markdown 형식의 지침 |
| result | String | 완료된 작업의 최종 출력, 링크 또는 요약 |
| created_at | ISO8601 | 작업이 처음 생성된 타임스탬프 |
| conversation | Array | 에이전트와 인간 비서 간에 교환된 메시지 모음 |
Magic API Console 고급 기능
- 에이전트가 업데이트를 제공하거나 인간 비서의 질문에 답변할 수 있도록 실시간 대화를 지원합니다.
- Openclaw Skills 내에서 자동 상태 추적 및 선제적 알림을 위한 하트비트 통합.
- 더 나은 리소스 관리를 위해 max_minutes 및 완화된 시간 제약을 포함한 유연한 작업 매개변수.
- 인간 실행자에게 명확하고 구조화된 지침을 제공하기 위해 Markdown을 통한 복잡한 지침 지원.
- 상태 또는 업데이트 타임스탬프를 기반으로 한 포괄적인 작업 기록 및 필터링 기능.
SKILL.md
로드 중
관련 Openclaw 스킬
Sogni AI 이미지 및 비디오 생성
Sogni AI 탈중앙화 GPU 인프라를 통해 전문가 수준의 이미지와 시네마틱 비디오를 생성하는 고성능 AI 미디어 스킬입니다.
skill-vettr
Openclaw Skills에서 악성 코드, shell 인젝션 및 프롬프트 조작을 검증하여 환경을 보호하는 선제적 보안 스캐너입니다.
ClawChain
AI agents가 Chromia 블록체인에서 게시물을 올리고, 상호작용하며, 거래하고, 탈중앙화된 기억을 저장할 수 있는 온체인 소셜 생태계입니다.
Harness Engineering
코드 생성과 평가를 분리하여 AI 에이전트를 통해 고품질의 감사 가능한 소프트웨어 개발을 보장하는 강력한 프로젝트 제약 시스템입니다.
FourClaw 토큰 발행 API
AI 기반 워크플로우를 통해 Solana 및 BNB Chain에서 프로그래밍 방식으로 토큰을 발행하기 위한 간소화된 API입니다.
추천*
