---
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 요약, 로빙 대응·시나리오·체크리스트 정리 |
