From a1592f789881c7bbc4e2c2dbd8e9dc9e8076f390 Mon Sep 17 00:00:00 2001 From: kappa Date: Wed, 18 Mar 2026 17:03:22 +0900 Subject: [PATCH] =?UTF-8?q?openclaw:=20=EB=A7=A4=EB=89=B4=EC=96=BC?= =?UTF-8?q?=EC=9D=84=20=EC=84=B9=EC=85=98=EB=B3=84=20=ED=8C=8C=EC=9D=BC?= =?UTF-8?q?=EB=A1=9C=20=EB=B6=84=EB=A6=AC=20(14=EA=B0=9C)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 단일 파일에서 디렉토리 구조로 변경하여 컨텍스트 관리 용이하게 함. openclaw-manual.md는 위키링크 인덱스로 변환. Co-Authored-By: Claude Opus 4.6 (1M context) --- openclaw/openclaw-architecture.md | 28 ++++ openclaw/openclaw-automation.md | 10 ++ openclaw/openclaw-channels.md | 18 +++ openclaw/openclaw-gateway.md | 14 ++ openclaw/openclaw-heartbeat.md | 24 +++ openclaw/openclaw-install.md | 31 ++++ openclaw/openclaw-manual.md | 258 +++--------------------------- openclaw/openclaw-memory.md | 27 ++++ openclaw/openclaw-multi-agent.md | 29 ++++ openclaw/openclaw-plugins.md | 9 ++ openclaw/openclaw-runtime.md | 24 +++ openclaw/openclaw-security.md | 22 +++ openclaw/openclaw-sessions.md | 34 ++++ openclaw/openclaw-skills.md | 30 ++++ openclaw/openclaw-tools.md | 30 ++++ 15 files changed, 348 insertions(+), 240 deletions(-) create mode 100644 openclaw/openclaw-architecture.md create mode 100644 openclaw/openclaw-automation.md create mode 100644 openclaw/openclaw-channels.md create mode 100644 openclaw/openclaw-gateway.md create mode 100644 openclaw/openclaw-heartbeat.md create mode 100644 openclaw/openclaw-install.md create mode 100644 openclaw/openclaw-memory.md create mode 100644 openclaw/openclaw-multi-agent.md create mode 100644 openclaw/openclaw-plugins.md create mode 100644 openclaw/openclaw-runtime.md create mode 100644 openclaw/openclaw-security.md create mode 100644 openclaw/openclaw-sessions.md create mode 100644 openclaw/openclaw-skills.md create mode 100644 openclaw/openclaw-tools.md diff --git a/openclaw/openclaw-architecture.md b/openclaw/openclaw-architecture.md new file mode 100644 index 0000000..92c3cfa --- /dev/null +++ b/openclaw/openclaw-architecture.md @@ -0,0 +1,28 @@ +--- +title: OpenClaw 아키텍처 +updated: 2026-03-18 +--- + +게이트웨이(Gateway)가 중앙 데몬으로 모든 메시징 채널을 관리. 호스트당 1개만 존재. 기본 `127.0.0.1:18789`. + +## 구조 + +``` +채널(WhatsApp/Telegram/Discord...) ← WebSocket → 게이트웨이 ← WebSocket → 클라이언트(CLI/macOS앱/웹UI) + ↕ + 노드(macOS/iOS/Android) +``` + +## 구성요소 + +- **게이트웨이**: 메시징 연결 유지, WebSocket API, JSON Schema 검증 +- **클라이언트**: 게이트웨이에 WebSocket 연결, `send`/`agent`/`status` 요청 +- **노드**: `role: node`로 연결, 기기 ID 기반 페어링, camera/screen 등 명령 + +## 연결 프로토콜 + +- 첫 프레임은 반드시 `connect` 요청 +- 요청/응답: `{type:"req", id, method, params}` ↔ `{type:"res", id, ok, payload}` +- 이벤트: `{type:"event", event, payload}` +- 보안: 새 기기는 페어링 승인 필요, 로컬은 자동 승인 +- 원격: Tailscale/VPN 또는 SSH 터널 (`ssh -N -L 18789:127.0.0.1:18789 user@host`) diff --git a/openclaw/openclaw-automation.md b/openclaw/openclaw-automation.md new file mode 100644 index 0000000..9bf5f95 --- /dev/null +++ b/openclaw/openclaw-automation.md @@ -0,0 +1,10 @@ +--- +title: OpenClaw 자동화 +updated: 2026-03-18 +--- + +- **Cron**: `openclaw cron list|add|remove`, 게이트웨이 내장 스케줄러 +- **Hooks**: 이벤트 기반 트리거 (automation/hooks) +- **Webhooks**: 외부 서비스 연동 (automation/webhook) +- **Polls**: 주기적 외부 상태 확인 (automation/poll) +- **Gmail PubSub**: Gmail 실시간 알림 (automation/gmail-pubsub) diff --git a/openclaw/openclaw-channels.md b/openclaw/openclaw-channels.md new file mode 100644 index 0000000..69151cd --- /dev/null +++ b/openclaw/openclaw-channels.md @@ -0,0 +1,18 @@ +--- +title: OpenClaw 채널 +updated: 2026-03-18 +--- + +각 채널은 `openclaw.json`에 설정 섹션이 있으면 자동 시작. + +## DM 정책 + +pairing(기본)|allowlist|open|disabled + +## 주요 채널 + +- **Telegram**: botToken, streaming(off|partial|block|progress), groups, topics +- **Discord**: token, guilds, channels, voice, thread bindings +- **WhatsApp**: dmPolicy, allowFrom, textChunkLimit, mediaMaxMb +- **Slack**: botToken + appToken (Socket Mode), slash commands +- **Signal, iMessage, IRC, Matrix, Mattermost, MS Teams, LINE, Google Chat, Nostr, Twitch, Zalo** 등 diff --git a/openclaw/openclaw-gateway.md b/openclaw/openclaw-gateway.md new file mode 100644 index 0000000..7ad8fd0 --- /dev/null +++ b/openclaw/openclaw-gateway.md @@ -0,0 +1,14 @@ +--- +title: OpenClaw 게이트웨이 +updated: 2026-03-18 +--- + +- mode: local|remote, port: 18789 +- bind: loopback|lan|tailnet|custom|auto +- auth: none|token|password|trusted-proxy +- Tailscale: mode=off|serve|funnel +- 서비스: `openclaw gateway install|start|stop|restart|status|uninstall` +- RPC: `openclaw gateway call {method} --params {json}` +- 헬스: `openclaw gateway health|probe|discover` +- HTTP API: chatCompletions, responses (OpenAI 호환) +- Control UI: `openclaw dashboard` 또는 `http://127.0.0.1:18789/` diff --git a/openclaw/openclaw-heartbeat.md b/openclaw/openclaw-heartbeat.md new file mode 100644 index 0000000..2cb6dc1 --- /dev/null +++ b/openclaw/openclaw-heartbeat.md @@ -0,0 +1,24 @@ +--- +title: OpenClaw 하트비트 +updated: 2026-03-18 +--- + +정기적 에이전트 실행으로 백그라운드 작업/상태 확인 자동화. + +## 설정 + +```json5 +heartbeat: { + every: "30m", + activeHours: "09:00-22:00", + model: "openai/gpt-5.2-mini", + to: "last", + isolatedSession: true +} +``` + +## 동작 + +- `HEARTBEAT_OK` 응답 시 자동 제거 (알림 없음) +- `isolatedSession: true`로 토큰 100K → 2-5K 절감 +- `HEARTBEAT.md` 파일로 체크리스트 관리 diff --git a/openclaw/openclaw-install.md b/openclaw/openclaw-install.md new file mode 100644 index 0000000..43d60d6 --- /dev/null +++ b/openclaw/openclaw-install.md @@ -0,0 +1,31 @@ +--- +title: OpenClaw 개요 및 설치 +updated: 2026-03-18 +--- + +오픈소스 AI 에이전트 프레임워크. 메시징 앱(WhatsApp, Telegram, Discord, Slack, Signal, iMessage 등)을 통해 LLM과 대화하고, 셸 명령, 브라우저 자동화, 이메일, 파일 작업 등을 자율 수행. + +## 설치 + +```bash +# macOS/Linux +curl -fsSL https://openclaw.ai/install.sh | bash + +# 온보딩 (인증, 게이트웨이, 채널 설정) +openclaw onboard --install-daemon +``` + +**요구사항:** Node 24 권장 (22.16+ 호환) + +## 환경변수 + +- `OPENCLAW_HOME`: 홈 디렉토리 +- `OPENCLAW_STATE_DIR`: 상태 디렉토리 +- `OPENCLAW_CONFIG_PATH`: 설정 파일 경로 + +## 온보딩 4단계 + +1. `openclaw onboard --install-daemon` — 인증, 게이트웨이, 채널 설정 +2. `openclaw gateway status` — 서비스 상태 점검 +3. `openclaw dashboard` — 제어 UI (http://127.0.0.1:18789/) +4. 제어 UI 정상 로드 확인 diff --git a/openclaw/openclaw-manual.md b/openclaw/openclaw-manual.md index 62990dd..27e9400 100644 --- a/openclaw/openclaw-manual.md +++ b/openclaw/openclaw-manual.md @@ -1,250 +1,28 @@ --- -title: OpenClaw 매뉴얼 +title: OpenClaw 매뉴얼 인덱스 updated: 2026-03-18 tags: [openclaw, agent, ai] --- 공식 문서: https://docs.openclaw.ai/ -## 1. 개요 및 설치 +## 매뉴얼 목차 -오픈소스 AI 에이전트 프레임워크. 메시징 앱(WhatsApp, Telegram, Discord, Slack, Signal, iMessage 등)을 통해 LLM과 대화하고, 셸 명령, 브라우저 자동화, 이메일, 파일 작업 등을 자율 수행. +1. [[openclaw-install]] — 개요 및 설치 +2. [[openclaw-architecture]] — 아키텍처 +3. [[openclaw-runtime]] — 에이전트 런타임 +4. [[openclaw-tools]] — 도구 시스템 +5. [[openclaw-skills]] — 스킬 시스템 +6. [[openclaw-plugins]] — 플러그인 시스템 +7. [[openclaw-sessions]] — 세션 관리 +8. [[openclaw-channels]] — 채널 +9. [[openclaw-gateway]] — 게이트웨이 +10. [[openclaw-memory]] — 메모리 시스템 +11. [[openclaw-multi-agent]] — 멀티 에이전트 +12. [[openclaw-heartbeat]] — 하트비트 +13. [[openclaw-automation]] — 자동화 +14. [[openclaw-security]] — 보안 및 샌드박싱 -**설치:** -```bash -# macOS/Linux -curl -fsSL https://openclaw.ai/install.sh | bash +## 관련 문서 -# 온보딩 (인증, 게이트웨이, 채널 설정) -openclaw onboard --install-daemon -``` - -**요구사항:** Node 24 권장 (22.16+ 호환) - -**환경변수:** -- `OPENCLAW_HOME`: 홈 디렉토리 -- `OPENCLAW_STATE_DIR`: 상태 디렉토리 -- `OPENCLAW_CONFIG_PATH`: 설정 파일 경로 - -## 2. 아키텍처 - -게이트웨이(Gateway)가 중앙 데몬으로 모든 메시징 채널을 관리. 호스트당 1개만 존재. 기본 `127.0.0.1:18789`. - -``` -채널(WhatsApp/Telegram/Discord...) ← WebSocket → 게이트웨이 ← WebSocket → 클라이언트(CLI/macOS앱/웹UI) - ↕ - 노드(macOS/iOS/Android) -``` - -**구성요소:** -- **게이트웨이**: 메시징 연결 유지, WebSocket API, JSON Schema 검증 -- **클라이언트**: 게이트웨이에 WebSocket 연결, `send`/`agent`/`status` 요청 -- **노드**: `role: node`로 연결, 기기 ID 기반 페어링, camera/screen 등 명령 - -**연결 프로토콜:** -- 첫 프레임은 반드시 `connect` 요청 -- 요청/응답: `{type:"req", id, method, params}` ↔ `{type:"res", id, ok, payload}` -- 이벤트: `{type:"event", event, payload}` -- 보안: 새 기기는 페어링 승인 필요, 로컬은 자동 승인 -- 원격: Tailscale/VPN 또는 SSH 터널 (`ssh -N -L 18789:127.0.0.1:18789 user@host`) - -## 3. 에이전트 런타임 - -pi-mono 기반 단일 임베디드 에이전트 런타임. 세션 관리와 도구 연동은 OpenClaw가 직접 담당. - -**워크스페이스 구조:** -- `AGENTS.md` — 운영 지침 및 메모리 -- `SOUL.md` — 페르소나, 경계, 톤 -- `TOOLS.md` — 도구 사용법 가이드 -- `IDENTITY.md` — 에이전트 이름/이모지 -- `USER.md` — 사용자 프로필 -- `BOOTSTRAP.md` — 일회성 초기화 (완료 후 삭제) -- `HEARTBEAT.md` — 하트비트 체크리스트 (선택) - -**모델 참조:** `provider/model` 형식 (예: `anthropic/claude-opus-4-6`) - -**설정 파일:** `~/.openclaw/openclaw.json` (JSON5) - -## 4. 도구 시스템 - -도구 접근 제어: `tools.allow`/`tools.deny` (deny 우선) - -**프로필:** -- `minimal`: 세션 상태만 -- `coding`: 파일시스템, 런타임, 세션, 메모리, 이미지 -- `messaging`: 메시징 관련 -- `full`: 제한 없음 - -**핵심 도구:** - -| 카테고리 | 도구 | 기능 | -|----------|------|------| -| 파일/실행 | exec, process, read, write, edit, apply_patch | 셸 명령, 백그라운드 관리, 파일 조작 | -| 웹 | web_search, web_fetch | Brave/Firecrawl 검색, URL 콘텐츠 추출 | -| UI 자동화 | browser, canvas | 브라우저 제어, 캔버스 드라이브 | -| 노드 | nodes, device_status | 페어링 노드, 카메라/화면 캡처 | -| 메시징 | message | Discord/Slack/Telegram/WhatsApp 메시지 전송 | -| 세션 | sessions_list, sessions_history, sessions_send, sessions_spawn | 세션 관리, 서브에이전트 | -| 이미지 | image, image_generate, pdf | 이미지 분석/생성, PDF 분석 | -| 자동화 | cron, gateway | 크론 작업, 게이트웨이 설정 | - -**도구 그룹:** `group:fs`, `group:runtime`, `group:sessions`, `group:web`, `group:ui` - -## 5. 스킬 시스템 - -AgentSkills 호환 스킬 폴더. 각 스킬은 `SKILL.md` (YAML frontmatter) 포함 디렉토리. - -**로드 우선순위:** 워크스페이스 `skills/` > `~/.openclaw/skills/` > 번들 - -**SKILL.md 형식:** -```yaml ---- -name: 스킬-이름 -description: 설명 -user-invocable: true -metadata: { "openclaw": { "requires": { "bins": [], "env": [], "config": [] }, "os": ["darwin","linux"] } } ---- -스킬 본문 (사용법, 도구 호출 가이드) -``` - -**설정 오버라이드:** `openclaw.json`의 `skills.entries`에서 활성화/비활성화, API 키, 환경변수 주입 - -**ClawHub:** 공개 스킬 레지스트리 — `clawhub install/update/sync` - -## 6. 플러그인 시스템 - -- 매니페스트: `openclaw.plugin.json` (id, configSchema 필수) -- 슬롯: `plugins.slots.memory` (기본: memory-core), `contextEngine` -- 명령: `openclaw plugins list|info|install|enable|disable|doctor` -- 플러그인은 자체 스킬 디렉토리 배포 가능 - -## 7. 세션 관리 - -**dmScope** (DM 격리 방식): - -| 값 | 동작 | -|----|------| -| `main` (기본) | 모든 DM 주 세션 공유 | -| `per-peer` | 발신자 ID로 격리 | -| `per-channel-peer` | 채널+발신자로 격리 (다중 사용자 필수) | -| `per-account-channel-peer` | 계정+채널+발신자로 격리 | - -**세션 키 체계:** -- DM: `agent::main` 또는 `agent::direct:` -- 그룹: `agent:::group:` -- Telegram 토픽: `...group::topic:` -- Cron: `cron:`, 웹훅: `hook:` - -**리셋 정책:** -- `daily` (기본, atHour:4) 또는 `idle` (idleMinutes) -- `/new`, `/reset` 명령으로 즉시 리셋 -- `resetByType`으로 direct/group/thread별, `resetByChannel`로 채널별 재정의 - -**유지보수:** pruneAfter:30d, maxEntries:500, maxDiskBytes:500mb (mode: warn|enforce) - -**저장소:** `~/.openclaw/agents//sessions/sessions.json` - -## 8. 채널 - -각 채널은 `openclaw.json`에 설정 섹션이 있으면 자동 시작. - -**DM 정책:** pairing(기본)|allowlist|open|disabled - -**주요 채널:** -- **Telegram**: botToken, streaming(off|partial|block|progress), groups, topics -- **Discord**: token, guilds, channels, voice, thread bindings -- **WhatsApp**: dmPolicy, allowFrom, textChunkLimit, mediaMaxMb -- **Slack**: botToken + appToken (Socket Mode), slash commands -- **Signal, iMessage, IRC, Matrix, Mattermost, MS Teams, LINE, Google Chat, Nostr, Twitch, Zalo** 등 - -## 9. 게이트웨이 - -- mode: local|remote, port: 18789 -- bind: loopback|lan|tailnet|custom|auto -- auth: none|token|password|trusted-proxy -- Tailscale: mode=off|serve|funnel -- 서비스: `openclaw gateway install|start|stop|restart|status|uninstall` -- RPC: `openclaw gateway call {method} --params {json}` -- 헬스: `openclaw gateway health|probe|discover` -- HTTP API: chatCompletions, responses (OpenAI 호환) -- Control UI: `openclaw dashboard` 또는 `http://127.0.0.1:18789/` - -## 10. 메모리 시스템 - -평문 마크다운 파일이 유일한 진실 공급원. - -**파일 구조:** -- `memory/YYYY-MM-DD.md` — 일일 로그 (추가 전용) -- `MEMORY.md` — 장기 메모리 (정선된 지속 정보) - -**메모리 도구:** `memory_search` (벡터 검색), `memory_get` (파일 읽기) - -**벡터 검색:** -- 기본 활성화, 마크다운 변경 자동 감시 -- 제공자: local(node-llama-cpp) → openai → gemini → voyage → mistral -- 하이브리드 검색: BM25(30%) + 벡터(70%) -- 시간 감쇠: 반감기 30일 (MEMORY.md는 감쇠 없음) - -**메모리 플러시:** 컴팩션 전 자동으로 메모리 저장 트리거 (softThresholdTokens: 4000) - -## 11. 멀티 에이전트 - -각 에이전트는 독립된 워크스페이스, 세션, 인증 프로필 보유. - -**설정:** -```json5 -agents: { - list: [ - { id: "home", workspace: "~/.openclaw/workspace-home" }, - { id: "work", workspace: "~/.openclaw/workspace-work" } - ] -}, -bindings: [ - { agentId: "home", match: { channel: "whatsapp", accountId: "personal" } }, - { agentId: "work", match: { channel: "discord", guildId: "123" } } -] -``` - -**라우팅 우선순위:** peer > parentPeer > guildId+roles > guildId > teamId > accountId > channel > 기본 - -**에이전트 관리:** `openclaw agents add|list|remove`, 에이전트별 샌드박스/도구 제한 가능 - -## 12. 하트비트 - -정기적 에이전트 실행으로 백그라운드 작업/상태 확인 자동화. - -**설정:** -```json5 -heartbeat: { - every: "30m", - activeHours: "09:00-22:00", - model: "openai/gpt-5.2-mini", - to: "last", - isolatedSession: true -} -``` - -- `HEARTBEAT_OK` 응답 시 자동 제거 (알림 없음) -- `isolatedSession: true`로 토큰 100K → 2-5K 절감 -- `HEARTBEAT.md` 파일로 체크리스트 관리 - -## 13. 자동화 - -- **Cron**: `openclaw cron list|add|remove`, 게이트웨이 내장 스케줄러 -- **Hooks**: 이벤트 기반 트리거 (automation/hooks) -- **Webhooks**: 외부 서비스 연동 (automation/webhook) -- **Polls**: 주기적 외부 상태 확인 (automation/poll) -- **Gmail PubSub**: Gmail 실시간 알림 (automation/gmail-pubsub) - -## 14. 보안 및 샌드박싱 - -**샌드박스 모드:** -- `off`: 제한 없음 -- `non-main`: 메인 에이전트 외 샌드박스 적용 -- `all`: 모든 에이전트 샌드박스 - -**도구 정책:** exec deny(기본)|allowlist|full - -**기기 페어링:** 새 기기는 승인 필요, 로컬은 자동, 원격은 명시적 - -**스킬 보안:** 제3자 스킬은 신뢰할 수 없는 코드로 취급, 활성화 전 검토 필수 +- [[openclaw-agents]] — IronDesk 에이전트 시스템 (DarkRouter, BlackSmith, Stamp, Flux 등) diff --git a/openclaw/openclaw-memory.md b/openclaw/openclaw-memory.md new file mode 100644 index 0000000..9312036 --- /dev/null +++ b/openclaw/openclaw-memory.md @@ -0,0 +1,27 @@ +--- +title: OpenClaw 메모리 시스템 +updated: 2026-03-18 +--- + +평문 마크다운 파일이 유일한 진실 공급원. + +## 파일 구조 + +- `memory/YYYY-MM-DD.md` — 일일 로그 (추가 전용) +- `MEMORY.md` — 장기 메모리 (정선된 지속 정보) + +## 메모리 도구 + +- `memory_search` — 벡터 검색 +- `memory_get` — 파일 읽기 + +## 벡터 검색 + +- 기본 활성화, 마크다운 변경 자동 감시 +- 제공자: local(node-llama-cpp) → openai → gemini → voyage → mistral +- 하이브리드 검색: BM25(30%) + 벡터(70%) +- 시간 감쇠: 반감기 30일 (MEMORY.md는 감쇠 없음) + +## 메모리 플러시 + +컴팩션 전 자동으로 메모리 저장 트리거 (softThresholdTokens: 4000) diff --git a/openclaw/openclaw-multi-agent.md b/openclaw/openclaw-multi-agent.md new file mode 100644 index 0000000..6ca241c --- /dev/null +++ b/openclaw/openclaw-multi-agent.md @@ -0,0 +1,29 @@ +--- +title: OpenClaw 멀티 에이전트 +updated: 2026-03-18 +--- + +각 에이전트는 독립된 워크스페이스, 세션, 인증 프로필 보유. + +## 설정 + +```json5 +agents: { + list: [ + { id: "home", workspace: "~/.openclaw/workspace-home" }, + { id: "work", workspace: "~/.openclaw/workspace-work" } + ] +}, +bindings: [ + { agentId: "home", match: { channel: "whatsapp", accountId: "personal" } }, + { agentId: "work", match: { channel: "discord", guildId: "123" } } +] +``` + +## 라우팅 우선순위 + +peer > parentPeer > guildId+roles > guildId > teamId > accountId > channel > 기본 + +## 에이전트 관리 + +`openclaw agents add|list|remove`, 에이전트별 샌드박스/도구 제한 가능 diff --git a/openclaw/openclaw-plugins.md b/openclaw/openclaw-plugins.md new file mode 100644 index 0000000..496f7d9 --- /dev/null +++ b/openclaw/openclaw-plugins.md @@ -0,0 +1,9 @@ +--- +title: OpenClaw 플러그인 시스템 +updated: 2026-03-18 +--- + +- 매니페스트: `openclaw.plugin.json` (id, configSchema 필수) +- 슬롯: `plugins.slots.memory` (기본: memory-core), `contextEngine` +- 명령: `openclaw plugins list|info|install|enable|disable|doctor` +- 플러그인은 자체 스킬 디렉토리 배포 가능 diff --git a/openclaw/openclaw-runtime.md b/openclaw/openclaw-runtime.md new file mode 100644 index 0000000..f39a197 --- /dev/null +++ b/openclaw/openclaw-runtime.md @@ -0,0 +1,24 @@ +--- +title: OpenClaw 에이전트 런타임 +updated: 2026-03-18 +--- + +pi-mono 기반 단일 임베디드 에이전트 런타임. 세션 관리와 도구 연동은 OpenClaw가 직접 담당. + +## 워크스페이스 구조 + +- `AGENTS.md` — 운영 지침 및 메모리 +- `SOUL.md` — 페르소나, 경계, 톤 +- `TOOLS.md` — 도구 사용법 가이드 +- `IDENTITY.md` — 에이전트 이름/이모지 +- `USER.md` — 사용자 프로필 +- `BOOTSTRAP.md` — 일회성 초기화 (완료 후 삭제) +- `HEARTBEAT.md` — 하트비트 체크리스트 (선택) + +## 모델 참조 + +`provider/model` 형식 (예: `anthropic/claude-opus-4-6`) + +## 설정 파일 + +`~/.openclaw/openclaw.json` (JSON5) diff --git a/openclaw/openclaw-security.md b/openclaw/openclaw-security.md new file mode 100644 index 0000000..1276ae5 --- /dev/null +++ b/openclaw/openclaw-security.md @@ -0,0 +1,22 @@ +--- +title: OpenClaw 보안 및 샌드박싱 +updated: 2026-03-18 +--- + +## 샌드박스 모드 + +- `off`: 제한 없음 +- `non-main`: 메인 에이전트 외 샌드박스 적용 +- `all`: 모든 에이전트 샌드박스 + +## 도구 정책 + +exec deny(기본)|allowlist|full + +## 기기 페어링 + +새 기기는 승인 필요, 로컬은 자동, 원격은 명시적 + +## 스킬 보안 + +제3자 스킬은 신뢰할 수 없는 코드로 취급, 활성화 전 검토 필수 diff --git a/openclaw/openclaw-sessions.md b/openclaw/openclaw-sessions.md new file mode 100644 index 0000000..4373ba6 --- /dev/null +++ b/openclaw/openclaw-sessions.md @@ -0,0 +1,34 @@ +--- +title: OpenClaw 세션 관리 +updated: 2026-03-18 +--- + +## dmScope (DM 격리 방식) + +| 값 | 동작 | +|----|------| +| `main` (기본) | 모든 DM 주 세션 공유 | +| `per-peer` | 발신자 ID로 격리 | +| `per-channel-peer` | 채널+발신자로 격리 (다중 사용자 필수) | +| `per-account-channel-peer` | 계정+채널+발신자로 격리 | + +## 세션 키 체계 + +- DM: `agent::main` 또는 `agent::direct:` +- 그룹: `agent:::group:` +- Telegram 토픽: `...group::topic:` +- Cron: `cron:`, 웹훅: `hook:` + +## 리셋 정책 + +- `daily` (기본, atHour:4) 또는 `idle` (idleMinutes) +- `/new`, `/reset` 명령으로 즉시 리셋 +- `resetByType`으로 direct/group/thread별, `resetByChannel`로 채널별 재정의 + +## 유지보수 + +pruneAfter:30d, maxEntries:500, maxDiskBytes:500mb (mode: warn|enforce) + +## 저장소 + +`~/.openclaw/agents//sessions/sessions.json` diff --git a/openclaw/openclaw-skills.md b/openclaw/openclaw-skills.md new file mode 100644 index 0000000..455bc87 --- /dev/null +++ b/openclaw/openclaw-skills.md @@ -0,0 +1,30 @@ +--- +title: OpenClaw 스킬 시스템 +updated: 2026-03-18 +--- + +AgentSkills 호환 스킬 폴더. 각 스킬은 `SKILL.md` (YAML frontmatter) 포함 디렉토리. + +## 로드 우선순위 + +워크스페이스 `skills/` > `~/.openclaw/skills/` > 번들 + +## SKILL.md 형식 + +```yaml +--- +name: 스킬-이름 +description: 설명 +user-invocable: true +metadata: { "openclaw": { "requires": { "bins": [], "env": [], "config": [] }, "os": ["darwin","linux"] } } +--- +스킬 본문 (사용법, 도구 호출 가이드) +``` + +## 설정 오버라이드 + +`openclaw.json`의 `skills.entries`에서 활성화/비활성화, API 키, 환경변수 주입 + +## ClawHub + +공개 스킬 레지스트리 — `clawhub install/update/sync` diff --git a/openclaw/openclaw-tools.md b/openclaw/openclaw-tools.md new file mode 100644 index 0000000..1e6861b --- /dev/null +++ b/openclaw/openclaw-tools.md @@ -0,0 +1,30 @@ +--- +title: OpenClaw 도구 시스템 +updated: 2026-03-18 +--- + +도구 접근 제어: `tools.allow`/`tools.deny` (deny 우선) + +## 프로필 + +- `minimal`: 세션 상태만 +- `coding`: 파일시스템, 런타임, 세션, 메모리, 이미지 +- `messaging`: 메시징 관련 +- `full`: 제한 없음 + +## 핵심 도구 + +| 카테고리 | 도구 | 기능 | +|----------|------|------| +| 파일/실행 | exec, process, read, write, edit, apply_patch | 셸 명령, 백그라운드 관리, 파일 조작 | +| 웹 | web_search, web_fetch | Brave/Firecrawl 검색, URL 콘텐츠 추출 | +| UI 자동화 | browser, canvas | 브라우저 제어, 캔버스 드라이브 | +| 노드 | nodes, device_status | 페어링 노드, 카메라/화면 캡처 | +| 메시징 | message | Discord/Slack/Telegram/WhatsApp 메시지 전송 | +| 세션 | sessions_list, sessions_history, sessions_send, sessions_spawn | 세션 관리, 서브에이전트 | +| 이미지 | image, image_generate, pdf | 이미지 분석/생성, PDF 분석 | +| 자동화 | cron, gateway | 크론 작업, 게이트웨이 설정 | + +## 도구 그룹 + +`group:fs`, `group:runtime`, `group:sessions`, `group:web`, `group:ui`