From e652a1161801dc9d9303c4ae60fd45cb7adc777a Mon Sep 17 00:00:00 2001 From: happybell80 Date: Thu, 26 Feb 2026 23:57:12 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20CEU=20=EC=9A=A9=EC=96=B4=EC=A7=91=20?= =?UTF-8?q?=EC=B6=94=EA=B0=80,=20OpenClaw=20=EB=A0=88=ED=8F=AC=20=ED=81=B4?= =?UTF-8?q?=EB=A1=A0=20=EA=B2=80=EC=A6=9D=20=EB=B0=98=EC=98=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Made-with: Cursor --- book/600_appendix/650_용어집.md | 5 ++++ .../260205_openclaw_official_docs_summary.md | 21 ++++++++++++++ ...260205_openclaw_로빙_적용_리서치.md | 29 +++++++++++++++++-- .../research/orchestration_tools/README.md | 2 +- 4 files changed, 53 insertions(+), 4 deletions(-) diff --git a/book/600_appendix/650_용어집.md b/book/600_appendix/650_용어집.md index 3c92f54..dd697cb 100644 --- a/book/600_appendix/650_용어집.md +++ b/book/600_appendix/650_용어집.md @@ -92,6 +92,11 @@ Docker 컨테이너의 기본이 되는 이미지. chroma_vector:1.0은 ChromaDB ### 존재형 에이전트 (Existence-type Agent) 로빙의 철학적 개념. 단순 작업 수행을 넘어 고유한 정체성, 성장, 관계를 가진 AI를 지칭. '로빙'과 같은 의미로 사용되나, 철학적 맥락을 강조할 때 주로 사용. +## ㅈ + +### 접속 사건 단위 / CEU (Connection Event Unit) +접속이라는 사건을 통해 존재가 확정되는 최소 지능 단위. "존재는 접속이다" 철학을 기술 명세로 담은 용어. 공식 표기: 연결 사건 단위. 관련: 0_VALUE, TheGooseCouncil Connection_Unit_Ontology. + ## ㅊ ### 체크포인트 (Checkpoint) diff --git a/journey/research/orchestration_tools/260205_openclaw_official_docs_summary.md b/journey/research/orchestration_tools/260205_openclaw_official_docs_summary.md index 111bccb..b8fb69a 100644 --- a/journey/research/orchestration_tools/260205_openclaw_official_docs_summary.md +++ b/journey/research/orchestration_tools/260205_openclaw_official_docs_summary.md @@ -86,6 +86,27 @@ - ClawHub: clawhub.com에서 스킬 검색·설치·업데이트 - 설정: skills.entries..enabled, env, apiKey 등 +### 8.1 SKILL.md 메타데이터 예시 (레포 검증) + +```yaml +--- +name: github +description: "GitHub operations via gh CLI..." +metadata: + openclaw: + emoji: "🐙" + requires: { bins: ["gh"], config: ["channels.slack"] } + install: + - { id: "brew", kind: "brew", formula: "gh", bins: ["gh"], label: "Install GitHub CLI (brew)" } + - { id: "apt", kind: "apt", package: "gh", bins: ["gh"], label: "Install GitHub CLI (apt)" } +--- +``` + +- `requires.bins`: 실행에 필요한 CLI (gh 등) +- `requires.config`: 채널·설정 의존 +- `install`: 사용자 설치 가이드 (brew, apt 등) +- `emoji`: UI 표시용 + --- ## 9. Gateway Runbook diff --git a/journey/research/orchestration_tools/260205_openclaw_로빙_적용_리서치.md b/journey/research/orchestration_tools/260205_openclaw_로빙_적용_리서치.md index 552b7cf..2a5964f 100644 --- a/journey/research/orchestration_tools/260205_openclaw_로빙_적용_리서치.md +++ b/journey/research/orchestration_tools/260205_openclaw_로빙_적용_리서치.md @@ -1,8 +1,9 @@ # OpenClaw 아키텍처 분석 및 로빙 적용 리서치 -**작성일**: 2026-02-05 +**작성일**: 2026-02-05 (260226 보완) **참고**: 312_문서_작성_원칙.md, 311_백엔드_구조_원칙.md **원본**: https://github.com/openclaw/openclaw +**로컬 클론**: `ivada/openclaw` (260226 클론) --- @@ -24,10 +25,32 @@ OpenClaw(구 Moltbot/Clawdbot)는 WhatsApp·Slack·Telegram 등 메신저로 대 | extensions/ | 채널 확장 (openclaw.plugin.json) | 블루버블, 마이크로소프트 팀즈, 매트릭스 등 | | skills/ | 스킬 패키지 | SKILL.md + YAML frontmatter + scripts/references | -### 2.2 설계 패턴 +### 2.2 실제 레포 구조 (클론 검증, 260226) + +`ivada/openclaw` 클론 기준 검증 결과. + +| 디렉터리 | 검증 | 비고 | +|----------|------|------| +| src/gateway | ✓ | WebSocket 컨트롤 플레인 | +| src/agents | ✓ | Pi Agent, acp-spawn 등 | +| src/channels | ✓ | dock.ts, registry.ts, plugins/ (채널 레지스트리·설정) | +| src/channels/plugins | ✓ | 확장 채널 로딩 | +| src/slack, telegram, whatsapp, discord 등 | ✓ | 코어 채널은 src/ 직접 | +| extensions/ | ✓ | 37개+ openclaw.plugin.json (Slack, Telegram, BlueBubbles, Matrix 등) | +| skills/ | ✓ | 46개+ SKILL.md (slack, github, coding-agent 등) | +| packages/ | (추가) | pnpm workspace 패키지 | +| apps/ | (추가) | macOS, Android 등 앱 | +| docs/ | (추가) | docs.openclaw.ai 소스 | +| openclaw.mjs | (추가) | CLI 엔트리포인트 | + +- **채널 구조**: 코어 채널(src/slack 등) + extensions/ 플러그인(openclaw.plugin.json)으로 확장. +- **스킬 메타**: `metadata.openclaw.requires`(bins/config/env), `install`(brew/apt), `emoji` 등. +- **버전**: package.json `2026.2.26` (클론 시점). + +### 2.3 설계 패턴 - **Gateway 중심**: 단일 WebSocket 컨트롤 플레인, 제품은 어시스턴트 -- **채널 플러그인화**: `openclaw.plugin.json` 기반 확장, channel.ts·runtime.ts 인터페이스 +- **채널 플러그인화**: `openclaw.plugin.json` 기반 확장( extensions/ 37개+), channel.ts·runtime.ts 인터페이스 - **스킬 포맷**: `SKILL.md` + name·description·metadata(YAML frontmatter) - **멀티 에이전트 라우팅**: 발신자·워크스페이스별 에이전트 분리, 세션 격리 - **보안 기본값**: DM pairing, allowlist, 비-main 세션 Docker 샌드박스 diff --git a/journey/research/orchestration_tools/README.md b/journey/research/orchestration_tools/README.md index ef292ac..bf60570 100644 --- a/journey/research/orchestration_tools/README.md +++ b/journey/research/orchestration_tools/README.md @@ -3,5 +3,5 @@ ## 문서 목록 - [LangGraph vs n8n 비교](250925_langgraph_vs_n8n_comparison.md) — LLM 에이전트·워크플로우 오케스트레이션 도구 비교 -- [OpenClaw 로빙 적용 리서치](260205_openclaw_로빙_적용_리서치.md) — OpenClaw 아키텍처 분석 및 로빙 적용 아이디어 +- [OpenClaw 로빙 적용 리서치](260205_openclaw_로빙_적용_리서치.md) — OpenClaw 아키텍처 분석 및 로빙 적용 아이디어 (로컬 클론: `ivada/openclaw`) - [OpenClaw 공식 문서 요약](260205_openclaw_official_docs_summary.md) — docs.openclaw.ai 요약 및 로빙 적용 우선순위