docs: OpenClaw llms.txt 기반 로빙 적용 가이드 및 오케스트레이션 README 보강

Made-with: Cursor

journey/research/orchestration_tools/260323_openclaw_llms_txt_로빙_적용_가이드.md

@@ -0,0 +1,98 @@
+---
+type: research
+tags: [research, orchestration, openclaw, gateway, documentation]
+status: active
+research_target: docs.openclaw.ai llms.txt 인덱스 기준으로 로빙에 OpenClaw를 적용·참조하는 방법 정리
+related:
+  - ./260322_openclaw_로빙_적용_리서치_v2.md
+  - ./260205_openclaw_official_docs_summary.md
+  - ./260205_openclaw_로빙_적용_리서치.md
+---
+
+# OpenClaw 문서 인덱스(llms.txt)와 로빙 적용 가이드
+
+**작성일**: 2026-03-23  
+**전제**: OpenClaw 공식 문서의 **전체 목록**은 [OpenClaw llms.txt](https://docs.openclaw.ai/llms.txt)에서 확인한다. 세부 페이지는 해당 인덱스의 링크를 따라가며 탐색한다.
+
+---
+
+## 1. 문서 탐색 순서 (권장)
+
+1. **[llms.txt](https://docs.openclaw.ai/llms.txt)** — 채널·CLI·Gateway·보안·자동화 등 **모든 문서 URL 목록**(약 300+ 항목 규모).
+2. **[Quickstart / 랜딩](https://docs.openclaw.ai/)** — 한 줄 정의, 설치·온보딩·대시보드 진입점.
+3. 로빙과 직접 맞닿는 축만 골라 읽기:
+   - **Gateway**: [Configuration](https://docs.openclaw.ai/gateway/configuration.md), [Security](https://docs.openclaw.ai/gateway/security.md), [Remote](https://docs.openclaw.ai/gateway/remote.md), [Troubleshooting](https://docs.openclaw.ai/gateway/troubleshooting.md)
+   - **채널**: [Chat Channels index](https://docs.openclaw.ai/channels/index.md), 필요 시 [Slack](https://docs.openclaw.ai/channels/slack.md), [Telegram](https://docs.openclaw.ai/channels/telegram.md), [WhatsApp](https://docs.openclaw.ai/channels/whatsapp.md)
+   - **개념**: [Multi-Agent Routing](https://docs.openclaw.ai/concepts/multi-agent.md), [Session Management](https://docs.openclaw.ai/concepts/session.md), [Model Providers](https://docs.openclaw.ai/concepts/model-providers.md)
+   - **CLI**: [onboard](https://docs.openclaw.ai/cli/onboard.md), [dashboard](https://docs.openclaw.ai/cli/dashboard.md), [gateway](https://docs.openclaw.ai/cli/gateway.md)
+
+llms.txt에 없는 내용은 공식 사이트 검색·최신 릴리스 노트로 보완한다.
+
+---
+
+## 2. 공식 Quickstart 요약 (런타임 관점)
+
+- **정의**: 자체 호스팅 **Gateway**가 WhatsApp·Telegram·Discord·iMessage 등과 **Pi 계열 코딩 에이전트**를 잇는 브리지.
+- **설치**: `npm install -g openclaw@latest` ([Quickstart](https://docs.openclaw.ai/start/getting-started) 흐름과 동일 계열).
+- **온보딩**: `openclaw onboard --install-daemon` — 가이드 설치·데몬 등록.
+- **대시보드**: `openclaw dashboard` — 브라우저 **Control UI** (문서상 로컬 기본 `http://127.0.0.1:18789/`).
+- **런타임**: Node **24 권장**, 또는 **22 LTS(22.16+)** 호환; API 키는 선택한 모델 제공자 기준.
+- **설정 파일**: 기본 `~/.openclaw/openclaw.json` — 채널 allowlist·그룹 멘션 규칙 등 ([공식 랜딩 예시](https://docs.openclaw.ai/)의 JSON5 스니펫 참고).
+
+---
+
+## 3. 로빙 아키텍처와의 대응
+
+| OpenClaw | 로빙(현 구조) | 적용 시 해석 |
+|----------|----------------|--------------|
+| 단일 Gateway 프로세스 | `robeing-gateway`(FastAPI)·Slack 라우터 등 | **세션·라우팅·정책**을 게이트웨이 층에 두는 패턴을 참고. 구현체를 바꾸지 않아도 **책임 분리** 기준으로 정렬 가능. |
+| 채널 플러그인 | `skill-slack`, 기타 진입 웹훅 | 채널은 **이벤트 전달**에 가깝게 두고, 의도 분기·세션은 상위에서 처리하는 방향이 OpenClaw와 맞음. |
+| Pi / 도구 루프 | `rb8001` + `skill-*` | **에이전트·스킬 계약**·도구 허용 범위는 OpenClaw의 tools/profiles·스킬 메타데이터 아이디어를 참고. |
+| Control UI | 프론트·관리 UI | 운영자용 **세션·설정 가시화** 필요 시 UX 참고. |
+
+상세 매핑표·우선순위는 [OpenClaw 공식 문서 요약 및 로빙 적용 우선 목록](./260205_openclaw_official_docs_summary.md) §13–14, 결론·기준은 [OpenClaw 로빙 적용 리서치 v2](./260322_openclaw_로빙_적용_리서치_v2.md)를 본 문서의 **심화 참조**로 둔다.
+
+---
+
+## 4. 로빙에 “어떻게” 쓸지 — 세 가지 시나리오
+
+### 4.1 참고 전용 (권장 기본)
+
+- 코드 이식 없이 **Gateway·보안·스킬 문서 포맷**만 로빙 DOCS·구현 정책에 반영.
+- 리스크 최소; v2 리서치의 **“설계 참고”** 결론과 동일 계열.
+
+### 4.2 병행 PoC (개인/내부 단말)
+
+- **별도 호스트**에 OpenClaw Gateway만 올려 Telegram 등 **가벼운 채널**로 Pi 워크플로를 검증.
+- 로빙 프로덕션 URL·DB와 **직접 연결하지 않음** → 공격면·쿼터 분리.
+
+### 4.3 통합형 (장기, 검증 후)
+
+- 로빙 API(`robeing-gateway`의 `/api/chat` 등)와 OpenClaw를 **동일 사용자 facing**으로 묶으려면: 인증·세션 키·Slack 이벤트 중복·429/레이트리밋을 **한 번에** 설계해야 함.
+- **반드시** 보안 문서([Security](https://docs.openclaw.ai/gateway/security.md))와 로빙 측 allowlist·멘션 정책을 맞춘 뒤 단계적 도입.
+
+---
+
+## 5. 실행 체크리스트 (로빙 팀 관점)
+
+1. llms.txt에서 **Channels / Gateway / Security** 링크만 먼저 읽고, 팀에 공유할 범위를 정한다.
+2. 로빙 쪽은 **채널 이벤트 → 게이트웨이 → rb8001/skill-*** 경로가 OpenClaw의 “채널 → Gateway → 에이전트”와 같은지 그림으로 대조한다.
+3. 스킬은 [SKILL.md 패턴](./260205_openclaw_official_docs_summary.md#8-skills)을 참고해 `skill-*`별 **입출력·권한·실패 기준**을 문서에 명시한다.
+4. 운영은 OpenClaw의 `doctor`·로깅 개념을 참고해, 로빙 기존 헬스·트러블슈팅 문서(`DOCS/journey/troubleshooting/`)와 **진입점**을 맞춘다.
+
+---
+
+## 6. 관련 로빙 문서
+
+- [OpenClaw 로빙 적용 리서치 v2](./260322_openclaw_로빙_적용_리서치_v2.md) — 정의·기준·적용·리스크
+- [OpenClaw 공식 문서 요약](./260205_openclaw_official_docs_summary.md) — 허브·기능·보안·로빙 매핑표
+- [OpenClaw 아키텍처 분석 및 로빙 적용 리서치](./260205_openclaw_로빙_적용_리서치.md) — 레포 구조·코어 디렉터리
+- Gateway 구현 메모: [250809 robeing-gateway 구현](../../troubleshooting/250809_happybell80_robing-gateway구현.md)
+
+---
+
+## 7. 변경 이력
+
+| 날짜 | 내용 |
+|------|------|
+| 2026-03-23 | 초안: llms.txt 기준 탐색 경로, Quickstart 요약, 로빙 대응·시나리오·체크리스트 정리 |

journey/research/orchestration_tools/README.md

@@ -5,6 +5,9 @@
 - [LangGraph vs n8n 비교](250925_langgraph_vs_n8n_comparison.md) — LLM 에이전트·워크플로우 오케스트레이션 도구 비교
 - [OpenClaw 로빙 적용 리서치](260205_openclaw_로빙_적용_리서치.md) — OpenClaw 아키텍처 분석 및 로빙 적용 아이디어 (로컬: `reference/openclaw`, 서버: `ivada/openclaw`)
 - [OpenClaw 공식 문서 요약](260205_openclaw_official_docs_summary.md) — docs.openclaw.ai 요약 및 로빙 적용 우선순위
+- [OpenClaw llms.txt·로빙 적용 가이드](260323_openclaw_llms_txt_로빙_적용_가이드.md) — [공식 문서 인덱스](https://docs.openclaw.ai/llms.txt) 기준 탐색 순서, Quickstart 요약, 로빙 대응·시나리오
+- [OpenClaw 로빙 적용 리서치 v1](260322_openclaw_로빙_적용_리서치_v1.md) — documentation-engineer 기준 초안
+- [OpenClaw 로빙 적용 리서치 v2](260322_openclaw_로빙_적용_리서치_v2.md) — 정의·기준·적용·검증·잔여 리스크 강화본
 - [로빙 에이전트 루프·스킬 훅·LLM 실행 구조 리서치](260312_로빙_에이전트루프_스킬훅_LLM실행구조_리서치.md) — LLM API, 에이전트 런타임, 스킬 계약, 훅 구조를 로빙 기준으로 정리
 - [로빙 LLM API·Agent API·모델 선정·비용 비교 리서치](260312_로빙_LLM_API_Agent_API_모델선정_비용비교_리서치.md) — Gemini/OpenAI 계열 비교, 비용 문서화 원칙, 로빙 기준 모델 선택 방향 정리
 - [Context Engineering, DeepAgents, Claude Code 영상 리서치](260313_컨텍스트엔지니어링_딥에이전트_클로드코드_영상리서치.md) — 유튜브 영상의 도구 설명을 공식 문서와 교차 검증한 리서치