OpenClaw는 사용자의 머신에 상주하며 이미 사용 중인 채팅 앱 — WhatsApp, Telegram, Slack, Discord, Signal, Google Chat 및 ~20개의 다른 앱 — 을 통해 사용자와 통신하는 오픈소스 개인 AI 데몬입니다. Model Context Protocol을 기본 지원하므로, 모든 MCP 서버(OmniGems의 16-tool 바이럴 콘텐츠 표면 포함)가 이러한 모든 채널에서 채팅 명령이 됩니다.
이 가이드는 실제 작동하는 설정입니다. OpenClaw가 무엇인지, OmniGems MCP를 어떻게 연결하는지, 사전에 알아야 할 인증 함정, 그리고 실제로 누적 효과를 내는 다섯 가지 워크플로 패턴을 다룹니다.
이 조합이 중요한 이유
OpenClaw와 OmniGems는 같은 문제의 인접한 두 측면을 해결합니다:
- OpenClaw 는 채팅에 상주하는 영구 어시스턴트를 제공합니다. Telegram을 통해 폰에서, Slack을 통해 노트북에서, 한밤중 Signal에서 호출할 수 있습니다. 세션 간 메모리를 유지하며 주기적 작업을 위한 예약 "하트비트"를 지원합니다.
- OmniGems 는 AI 인플루언서 운영 표면을 제공합니다 — 페르소나 라이프사이클, 콘텐츠 생성, 멀티플랫폼 게시, BURNS-정렬 크리에이터 경제 — MCP를 통해 노출됩니다.
함께 연결하면 모든 채팅 채널에서 AI 크리에이터 운영 이 가능합니다: Telegram에서 "Q3용 새 뷰티 페르소나 만들기", Slack에서 "내 BURNS 잔액은?", WhatsApp에서 "@miami_condos용 매물 영상 5개 큐에 추가". 페르소나 파이프라인은 백그라운드에서 실행되고 채팅은 단지 운전대일 뿐입니다.
OmniGems 단독 설정(Claude Code, Cursor, ChatGPT 스타일 클라이언트)은 OmniGems MCP Guide를 참고하십시오.
2026년 OpenClaw가 실제로 무엇인가
오픈소스 개인 AI 어시스턴트(MIT 라이선스; github.com/openclaw/openclaw). Claude Code와는 다른 제품 분류입니다:
- OpenClaw: 영구 메모리와 예약 하트비트를 갖춘 데몬-상주 멀티 채널 어시스턴트. 생활 자동화용 — 받은편지함, 캘린더, 게시, 운영.
- Claude Code: 터미널-상주 페어 프로그래머. 에디터 내 개발 작업용.
둘 다 MCP를 지원합니다. 서로 다른 청중과 강점을 가집니다. OpenClaw는 macOS, Linux, Windows(WSL2 통해)에서 실행되며 Node 24 권장(최소 22.16+). 설치:
npm install -g openclaw@latest && openclaw onboard --install-daemon
OpenClaw의 MCP 지원은 기본 제공입니다 — openclaw mcp 는 일급 CLI 서브커맨드입니다. 지원 트랜스포트: stdio, sse, streamable-http. CLI는 type: "http" 를 별칭으로 받아들이고 openclaw doctor --fix 를 통해 정규 transport 필드로 정규화합니다.
먼저 알아야 할 인증 함정
OpenClaw는 원격 MCP 서버에 대해 MCP OAuth Authorization-Code+PKCE 흐름을 실행하지 않습니다. MCP 엔드포인트의 인증은 정적 헤더 전용 입니다 — Bearer 토큰, API 키, 사용자 정의 헤더. OpenClaw의 OAuth 흐름은 모델 제공자(Anthropic, OpenAI/Codex)용으로 예약되어 있으며 MCP 서버 자체에는 사용되지 않습니다.
실용적으로 이는 OmniGems MCP를 OpenClaw에 연결하려면 수동 토큰 붙여넣기 가 필요함을 의미합니다:
- 브라우저에서 omnigems.ai에 로그인
- 계정 설정에서 개인 액세스 토큰 생성 (
https://app.omnigems.ai/settings/tokens) - OpenClaw의 MCP 설정에 Bearer 헤더로 붙여넣기
- 주기적으로 회전(권장: 30–90 days마다)
이는 자체 페르소나 파이프라인을 운영하는 단일 오퍼레이터에게는 괜찮습니다. 여러 오퍼레이터가 액세스를 공유하는 팀/스튜디오 시나리오에서는 Claude Code의 OmniGems MCP(클라이언트별 전체 PKCE 흐름 실행)가 더 적합합니다. 해당 설정은 OmniGems MCP Guide를 참고하십시오.
OmniGems MCP를 OpenClaw에 연결하기
정확한 명령:
openclaw mcp set omnigems '{
"url": "https://app.omnigems.ai/api/mcp",
"transport": "streamable-http",
"headers": { "Authorization": "Bearer ${OMNIGEMS_TOKEN}" },
"connectionTimeoutMs": 10000
}'
~/.openclaw/config 의 mcp.servers 아래 동등한 설정 블록:
"omnigems": {
"url": "https://app.omnigems.ai/api/mcp",
"transport": "streamable-http",
"headers": { "Authorization": "Bearer ${OMNIGEMS_TOKEN}" }
}
설정 후 검증:
openclaw mcp show omnigems
openclaw doctor
doctor 는 type → transport 를 정규화하고 항목이 깨끗하게 파싱되는지 확인합니다. Authorization 헤더에 편집 경고가 표시되면 그것은 예상된 동작입니다 — OpenClaw는 설계상 로그에서 민감한 헤더 값을 편집합니다.
토큰 보안
토큰은 OpenClaw 설정 파일에 일반 텍스트로 저장됩니다. 두 가지 권장 사항:
${OMNIGEMS_TOKEN}보간을 사용하십시오 — JSON에 리터럴 토큰을 붙여넣는 대신 — 그러면 토큰이 OpenClaw 설정 대신 셸 환경(또는 제한 권한의.env파일)에 위치합니다.- 누출 의심 시 회전 — OmniGems는 동일한 설정 페이지를 통해 토큰 취소를 지원합니다. 취소 후 새 토큰을 생성하고 환경 변수를 업데이트하십시오.
URL userinfo (https://user:token@…)에 토큰을 넣지 마십시오 — 작동하고 로그에서 편집되지만 userinfo를 제거하는 일부 HTTP 프록시에서는 깨집니다.
연결 검증
openclaw mcp set 후 등록된 채팅 채널 중 하나에서 연결을 ping하십시오:
"List my OmniGems agents."
OpenClaw는 이를 viral_list_agents 도구로 라우팅하고 구조화된 응답을 반환하며 채널에 렌더링합니다. 에이전트가 보이면 연결된 것입니다.
호출이 실패하면 openclaw doctor --fix 를 실행하고 다음을 확인하십시오:
transport: "streamable-http"("http"또는"sse"가 아님)Authorization헤더가 서버에 도달하는지 (openclaw mcp show omnigems에서 편집 확인된 값 확인)- 토큰이 필요한 스코프를 가지는지 — 쿼리에는
mcp:read, 콘텐츠 생성에는mcp:write connectionTimeoutMs가 최소10000— 큰 페르소나/비디오 생성은 그만큼 걸릴 수 있습니다
누적 효과를 내는 다섯 가지 워크플로
OmniGems 웹 UI를 단순히 사용하는 대신 OmniGems를 OpenClaw에 연결하는 것을 정당화하는 패턴들입니다.
1. Telegram 아침 스탠드업
8am Telegram 메시지: "Daily ops report for all my agents"
OpenClaw 하트비트가 프롬프트를 발사하고 viral_activity_daily + viral_active_processes + viral_list_user_tasks 를 실행하여 보고서를 Telegram으로 다시 렌더링합니다. 커피와 함께 읽습니다. 탭 전환 없음, 대시보드 없음.
2. Slack 페르소나 출시
Slack 메시지: "Create a new persona — coral-gables real estate, mid-30s licensed agent, podcast voice, English + Spanish."
OpenClaw는 자유 형식을 구조화된 설정으로 변환하기 위해 viral_parse_influencer_description 으로 라우팅하고, BURNS 견적을 위해 viral_estimate_cost, 채널 내 확인 후 viral_create_influencer 를 호출합니다. 세 번의 도구 호출; 하나의 채팅 스레드.
3. WhatsApp 콘텐츠 배치
WhatsApp 메시지: "Queue 5 listing videos for @miami_condos with hooks based on this week's top post."
OpenClaw는 viral_get_post(이번 주 최고 성과작) → viral_estimate_cost → viral_start_content 를 구성합니다. 후크는 AI 클라이언트에서 오고 오케스트레이션은 MCP에서 옵니다. 결과: 60-second 메시지 교환에서 큐에 들어간 5개의 비디오.
4. Discord 비용 가드레일
Discord 예약 하트비트(시간별): 잔액 + 활성 프로세스 확인; 잔액 < 1000 BURNS인 경우 진행 중인 장형 생성을 취소하고 소유자에게 DM.
OpenClaw의 영구 하트비트가 이를 위한 올바른 기반입니다. viral_get_balance + viral_active_processes + (조건부) viral_cancel_process + DM의 반복 작업으로 연결합니다. 비용 가드레일은 사용자가 자고 있을 때도 실행됩니다.
5. Signal에서 인간 검토자에게 핸드오프
Signal 메시지: "Review pending tasks for @miami_condos."
OpenClaw는 viral_list_user_tasks 를 가져오고, 가장 오래된 것을 선택하고, 폼 필드를 로드하기 위해 viral_get_process_status 를 호출하고, 사용자의 음성으로 응답을 작성하고, 채널 내에서 사용자의 승인을 기다립니다. "yes" 후 viral_complete_user_task 를 통해 커밋합니다. 단일 Signal 스레드에서 종단 간 human-in-the-loop.
이러한 멀티플랫폼 패턴에 대한 자세한 내용은 How AI Agents Post on Social Media를 참고하십시오. viral_get_balance 와 viral_estimate_cost 를 뒷받침하는 더 넓은 BURNS 경제는 BURNS Token Glossary를 참고하십시오.
이 조합이 진정으로 빛나는 곳
OpenClaw + OmniGems가 어느 한 도구만 사용하는 것 이상을 제공하는 세 가지 패턴:
채팅을 떠나지 않고 페르소나 운영
이미 WhatsApp/Telegram/Slack에서 하루 4+ hours를 보낸다면(대부분의 오퍼레이터가 그렇습니다), 채팅 채널 표면이 대시보드 탭을 제거합니다. 이전에 OmniGems UI 로그인이 필요했던 작업이 이제 팀과 전략을 논의하는 동일한 스레드에서 발생합니다. 컨텍스트 전환 비용 감소 = 시간당 더 많은 의사결정.
단일 프롬프트에서 멀티플랫폼
OpenClaw의 채널 라우터 + OmniGems의 게시 도구 = "post this clip to TikTok, IG Reels, and X" 를 단일 명령으로. How AI Agents Post on Social Media 에서 문서화된 동일한 게시 에이전트가 이미 사용 중인 모든 채널에서 트리거 가능해집니다.
비용 인식 예약 생성
OpenClaw의 하트비트는 야간 비용-예산 생성을 실행할 수 있습니다: 당일 최고 성과 게시물을 선택하고, 야간 BURNS 예산까지 최고 성과작당 5개의 후속 클립을 큐에 넣고, 야간에 렌더링하고, 아침에 게시. 빈 큐나 깜짝 청구서 대신 ROI 순으로 순위가 매겨진 콘텐츠 초안 배치로 깨어납니다.
이 조합이 적합하지 않을 때
도움이 되지 않는 경우에 대해 정직하게:
- 이미 Claude Code를 사용 중인 데스크톱 단일 오퍼레이터. Claude Code의 OAuth-처리 흐름은 OpenClaw의 수동 토큰 모델보다 안전합니다. 채팅 채널 트리거가 특별히 필요한 경우가 아니면 Claude Code를 고수하십시오.
- 페르소나 파이프라인을 공유하는 여러 오퍼레이터의 팀/스튜디오. 각 오퍼레이터는 정적 토큰의 OpenClaw 설정을 공유하지 말고 Claude Code의 PKCE 흐름을 통해 별도로 인증해야 합니다.
- 인증 감사 추적이 중요한 컴플라이언스 엄격 니치(crypto, finance). Claude Code를 통한 OmniGems의 OAuth 2.1 + PKCE 흐름은 OpenClaw가 현재 지원하는 수동 토큰 모델보다 깨끗한 감사 로그를 생성합니다.
해당 시나리오의 경우 대신 OmniGems MCP Guide를 참고하십시오.
로드맵 인식
OpenClaw의 MCP-OAuth 지원은 프로젝트 트래커에 있습니다. 도착하면(이 글 작성 시점에서 약속된 날짜 없음) 위의 수동 토큰 흐름은 Claude Code가 사용하는 동일한 PKCE 흐름으로 마이그레이션할 수 있어 회전 오버헤드를 제거합니다. 그때까지는 정적 토큰 접근이 지원되는 경로입니다.
OmniGems는 MCP 사양을 추적합니다; 프로토콜 범프는 먼저 canary에 도착한 다음 ~2주 내에 프로덕션으로 졸업합니다. 새 도구는 매월 도착합니다. OpenClaw 워크플로용으로 노출되기 원하는 특정 도구가 있다면 오픈소스 MCP 서버 사양을 통해 요청하십시오.
시작 방법
- OpenClaw 설치:
npm install -g openclaw@latest && openclaw onboard --install-daemon https://app.omnigems.ai/settings/tokens에서 OmniGems 개인 액세스 토큰 생성- 내보내기:
export OMNIGEMS_TOKEN=ogm_… - 연결: 위의
openclaw mcp set omnigems …명령 실행 - 검증:
openclaw mcp show omnigems와openclaw doctor - 좋아하는 채널에서 테스트: "list my OmniGems agents" 로 OpenClaw에 ping
- 이 가이드의 워크플로를 계층화하십시오
이미 사용 중인 채팅 채널이 AI 크리에이터 파이프라인의 운영 표면이 됩니다. 그것이 구조적 승리입니다.
다음에 읽을 것
- OmniGems MCP Guide — 전체 설정과 16-tool 참조(Claude Code 경로)
- OmniGems MCP vs Higgsfield — 자산 생성 비교
- OmniGems MCP vs Arcade — 생산성 SaaS 비교
- How AI Agents Post on Social Media — 멀티플랫폼 게시 계층
- BURNS Token Glossary —
viral_get_balance를 뒷받침하는 토큰 경제