From 8eb637cc22e9a3d84d3a2090ac4fa5acb9368265 Mon Sep 17 00:00:00 2001 From: kappa Date: Sat, 4 Apr 2026 15:10:20 +0900 Subject: [PATCH] =?UTF-8?q?Obsidian=20vault=20=EB=A6=AC=ED=8C=A9=ED=86=A0?= =?UTF-8?q?=EB=A7=81:=20openclaw=20=ED=86=B5=ED=95=A9,=20=ED=83=9C?= =?UTF-8?q?=EA=B7=B8=20=EC=A0=95=EA=B7=9C=ED=99=94,=20=EC=83=81=ED=98=B8?= =?UTF-8?q?=EC=B0=B8=EC=A1=B0=20=EB=B3=B4=EA=B0=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - openclaw: 14개 소형 레퍼런스 파일(10~30줄) → openclaw-reference.md 1개로 통합 - 삭제: architecture, runtime, tools, skills, plugins, sessions, channels, gateway, memory, multi-agent, heartbeat, automation, security, install - 유지: agents(운영), jarvis(서버설정), ollama(통합가이드), manual(인덱스) - 태그 추가 (10개 파일): tasks, dev-environment, infra-forge, vault, cert-manager, cloudflare, openclaw-agents, irondesk, irondesk-tax-legal, aws-ses, telegram-bot, twilio - 상호참조: cloudflare.md에 netbis/cf-multisite/crowdsec/bunnycdn 링크 추가 - telegram-bot.md에 openclaw-jarvis 참조 추가 Co-Authored-By: Claude Opus 4.6 (1M context) --- dev/dev-environment.md | 3 +- infra/cert-manager.md | 1 + infra/cloudflare.md | 10 +- infra/infra-forge.md | 1 + infra/vault.md | 1 + openclaw/openclaw-agents.md | 1 + 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 | 24 +-- openclaw/openclaw-memory.md | 27 ---- openclaw/openclaw-multi-agent.md | 29 ---- openclaw/openclaw-plugins.md | 9 -- openclaw/openclaw-reference.md | 235 ++++++++++++++++++++++++++++++ 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 ---- products/irondesk-tax-legal.md | 1 + products/irondesk.md | 1 + services/aws-ses.md | 3 +- services/telegram-bot.md | 5 +- services/twilio.md | 3 +- tasks.md | 3 +- 28 files changed, 268 insertions(+), 354 deletions(-) delete mode 100644 openclaw/openclaw-architecture.md delete mode 100644 openclaw/openclaw-automation.md delete mode 100644 openclaw/openclaw-channels.md delete mode 100644 openclaw/openclaw-gateway.md delete mode 100644 openclaw/openclaw-heartbeat.md delete mode 100644 openclaw/openclaw-install.md delete mode 100644 openclaw/openclaw-memory.md delete mode 100644 openclaw/openclaw-multi-agent.md delete mode 100644 openclaw/openclaw-plugins.md create mode 100644 openclaw/openclaw-reference.md delete mode 100644 openclaw/openclaw-runtime.md delete mode 100644 openclaw/openclaw-security.md delete mode 100644 openclaw/openclaw-sessions.md delete mode 100644 openclaw/openclaw-skills.md delete mode 100644 openclaw/openclaw-tools.md diff --git a/dev/dev-environment.md b/dev/dev-environment.md index dfbab52..2bab7b7 100644 --- a/dev/dev-environment.md +++ b/dev/dev-environment.md @@ -1,6 +1,7 @@ --- title: 개발 환경 및 도구 -updated: 2026-03-12 +updated: 2026-04-04 +tags: [dev, environment, tools] --- ## Chrome CDP diff --git a/infra/cert-manager.md b/infra/cert-manager.md index adfa305..92e617d 100644 --- a/infra/cert-manager.md +++ b/infra/cert-manager.md @@ -1,6 +1,7 @@ --- title: cert-manager SSL 인증서 관리 updated: 2026-03-26 +tags: [infra, k3s, ssl, cert-manager] --- ## 인증 diff --git a/infra/cloudflare.md b/infra/cloudflare.md index 438cc2f..9a28a06 100644 --- a/infra/cloudflare.md +++ b/infra/cloudflare.md @@ -1,6 +1,7 @@ --- title: Cloudflare 서비스 -updated: 2026-03-22 +updated: 2026-04-04 +tags: [infra, cloudflare, cdn] --- ## Zone @@ -34,3 +35,10 @@ Cloudflare Redirect Rule로 자체 도메인 리다이렉트 설정 ## DNS 프리셋 프리셋: cloudflare, aws, google, github, bunnycdn + +## 관련 문서 + +- [[netbis]] — Netbis 계정 Cloudflare 설정 (6개 zone, Rate Limiting, SBFM) +- [[cf-multisite]] — 멀티사이트 Cloudflare 설정 +- [[crowdsec-safeline]] — CrowdSec CF Worker Bouncer 연동 +- [[bunnycdn-security]] — BunnyCDN 엣지 보안 diff --git a/infra/infra-forge.md b/infra/infra-forge.md index 421e03a..bb88f6c 100644 --- a/infra/infra-forge.md +++ b/infra/infra-forge.md @@ -1,6 +1,7 @@ --- title: Forge 인프라 에이전트 updated: 2026-03-12 +tags: [infra, agent, forge] --- ## 지식 베이스 diff --git a/infra/vault.md b/infra/vault.md index 843de38..0c56ef1 100644 --- a/infra/vault.md +++ b/infra/vault.md @@ -1,6 +1,7 @@ --- title: Vault 시크릿 관리 updated: 2026-03-12 +tags: [infra, vault, security] --- ## K3s 배포 diff --git a/openclaw/openclaw-agents.md b/openclaw/openclaw-agents.md index 11c0934..985bb69 100644 --- a/openclaw/openclaw-agents.md +++ b/openclaw/openclaw-agents.md @@ -1,6 +1,7 @@ --- title: OpenClaw 에이전트 시스템 updated: 2026-03-12 +tags: [openclaw, agent] --- ## DarkRouter diff --git a/openclaw/openclaw-architecture.md b/openclaw/openclaw-architecture.md deleted file mode 100644 index 92c3cfa..0000000 --- a/openclaw/openclaw-architecture.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -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 deleted file mode 100644 index 9bf5f95..0000000 --- a/openclaw/openclaw-automation.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -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 deleted file mode 100644 index 69151cd..0000000 --- a/openclaw/openclaw-channels.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -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 deleted file mode 100644 index 7ad8fd0..0000000 --- a/openclaw/openclaw-gateway.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -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 deleted file mode 100644 index 2cb6dc1..0000000 --- a/openclaw/openclaw-heartbeat.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -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 deleted file mode 100644 index 43d60d6..0000000 --- a/openclaw/openclaw-install.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -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 69478f4..aa80692 100644 --- a/openclaw/openclaw-manual.md +++ b/openclaw/openclaw-manual.md @@ -1,32 +1,20 @@ --- title: OpenClaw 매뉴얼 인덱스 -updated: 2026-03-18 +updated: 2026-04-04 tags: [openclaw, agent, ai] --- 공식 문서: https://docs.openclaw.ai/ -## 매뉴얼 목차 +## 레퍼런스 -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]] — 보안 및 샌드박싱 +[[openclaw-reference]] — 통합 레퍼런스 매뉴얼 (아키텍처, 런타임, 도구, 스킬, 플러그인, 세션, 채널, 게이트웨이, 메모리, 멀티에이전트, 하트비트, 자동화, 보안) ## 통합 - [[openclaw-ollama]] — Ollama 로컬 LLM 통합 -## 관련 문서 +## 운영 문서 -- [[openclaw-agents]] — IronDesk 에이전트 시스템 (DarkRouter, BlackSmith, Stamp, Flux 등) +- [[openclaw-agents]] — 에이전트 시스템 (DarkRouter, BlackSmith, Stamp, Flux 등) +- [[openclaw-jarvis]] — Jarvis 서버 (hp2) 운영 설정 diff --git a/openclaw/openclaw-memory.md b/openclaw/openclaw-memory.md deleted file mode 100644 index 9312036..0000000 --- a/openclaw/openclaw-memory.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -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 deleted file mode 100644 index 6ca241c..0000000 --- a/openclaw/openclaw-multi-agent.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -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 deleted file mode 100644 index 496f7d9..0000000 --- a/openclaw/openclaw-plugins.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -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-reference.md b/openclaw/openclaw-reference.md new file mode 100644 index 0000000..16403de --- /dev/null +++ b/openclaw/openclaw-reference.md @@ -0,0 +1,235 @@ +--- +title: OpenClaw 레퍼런스 매뉴얼 +updated: 2026-04-04 +tags: [openclaw, agent, ai, reference] +--- + +기존 13개 개별 문서를 통합한 레퍼런스. 운영 문서: [[openclaw-agents]], [[openclaw-jarvis]], [[openclaw-ollama]] + +## 개요 및 설치 + +오픈소스 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 정상 로드 확인 + +## 아키텍처 + +게이트웨이(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`) + +## 에이전트 런타임 + +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) + +## 도구 시스템 + +도구 접근 제어: `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` + +## 스킬 시스템 + +AgentSkills 호환 스킬 폴더. 각 스킬은 `SKILL.md` (YAML frontmatter) 포함 디렉토리. + +**로드 우선순위:** 워크스페이스 `skills/` > `~/.openclaw/skills/` > 번들 + +```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` + +## 플러그인 시스템 + +- 매니페스트: `openclaw.plugin.json` (id, configSchema 필수) +- 슬롯: `plugins.slots.memory` (기본: memory-core), `contextEngine` +- 명령: `openclaw plugins list|info|install|enable|disable|doctor` +- 플러그인은 자체 스킬 디렉토리 배포 가능 + +## 세션 관리 + +### 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` + +## 채널 + +각 채널은 `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** 등 + +## 게이트웨이 + +- 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/` + +## 메모리 시스템 + +평문 마크다운 파일이 유일한 진실 공급원. + +**파일 구조:** `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) + +## 멀티 에이전트 + +각 에이전트는 독립된 워크스페이스, 세션, 인증 프로필 보유. + +```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`, 에이전트별 샌드박스/도구 제한 가능 + +## 하트비트 + +정기적 에이전트 실행으로 백그라운드 작업/상태 확인 자동화. + +```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` 파일로 체크리스트 관리 + +## 자동화 + +- **Cron**: `openclaw cron list|add|remove`, 게이트웨이 내장 스케줄러 +- **Hooks**: 이벤트 기반 트리거 (automation/hooks) +- **Webhooks**: 외부 서비스 연동 (automation/webhook) +- **Polls**: 주기적 외부 상태 확인 (automation/poll) +- **Gmail PubSub**: Gmail 실시간 알림 (automation/gmail-pubsub) + +## 보안 및 샌드박싱 + +**샌드박스 모드:** off(제한 없음), non-main(메인 에이전트 외 적용), all(모든 에이전트) + +**도구 정책:** exec deny(기본)|allowlist|full + +**기기 페어링:** 새 기기는 승인 필요, 로컬은 자동, 원격은 명시적 + +**스킬 보안:** 제3자 스킬은 신뢰할 수 없는 코드로 취급, 활성화 전 검토 필수 diff --git a/openclaw/openclaw-runtime.md b/openclaw/openclaw-runtime.md deleted file mode 100644 index f39a197..0000000 --- a/openclaw/openclaw-runtime.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -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 deleted file mode 100644 index 1276ae5..0000000 --- a/openclaw/openclaw-security.md +++ /dev/null @@ -1,22 +0,0 @@ ---- -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 deleted file mode 100644 index 4373ba6..0000000 --- a/openclaw/openclaw-sessions.md +++ /dev/null @@ -1,34 +0,0 @@ ---- -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 deleted file mode 100644 index 455bc87..0000000 --- a/openclaw/openclaw-skills.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -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 deleted file mode 100644 index 1e6861b..0000000 --- a/openclaw/openclaw-tools.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -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` diff --git a/products/irondesk-tax-legal.md b/products/irondesk-tax-legal.md index cde8cf0..4b1009d 100644 --- a/products/irondesk-tax-legal.md +++ b/products/irondesk-tax-legal.md @@ -1,6 +1,7 @@ --- title: IronDesk 세무 및 법률 updated: 2026-03-12 +tags: [product, irondesk, tax, legal] --- ## 세무 관련 정리 diff --git a/products/irondesk.md b/products/irondesk.md index b7b2139..407bada 100644 --- a/products/irondesk.md +++ b/products/irondesk.md @@ -1,6 +1,7 @@ --- title: IronDesk - AI 고객지원 에이전트 updated: 2026-03-12 +tags: [product, irondesk, ai] --- ## 시스템 구축 diff --git a/services/aws-ses.md b/services/aws-ses.md index ba3fdbd..3df9f57 100644 --- a/services/aws-ses.md +++ b/services/aws-ses.md @@ -1,6 +1,7 @@ --- title: AWS SES 이메일 -updated: 2026-03-12 +updated: 2026-04-04 +tags: [service, aws, email] --- ## IAM 권한 diff --git a/services/telegram-bot.md b/services/telegram-bot.md index e1752ab..9ef37f6 100644 --- a/services/telegram-bot.md +++ b/services/telegram-bot.md @@ -1,8 +1,11 @@ --- title: Telegram 봇 -updated: 2026-03-12 +updated: 2026-04-04 +tags: [service, telegram, bot] --- ## 구성 구성: Telegram Bot API → 웹훅 ([[cloudflare]] Workers) → FastAPI 서버 → DeepSeek LLM + +현재 운영: [[openclaw-jarvis]] 서버에서 @AnvilForgeBot 웹훅 수신 → OpenClaw irondesk 에이전트 diff --git a/services/twilio.md b/services/twilio.md index 663b32e..3f07eef 100644 --- a/services/twilio.md +++ b/services/twilio.md @@ -1,6 +1,7 @@ --- title: Twilio 음성/메시지 -updated: 2026-03-12 +updated: 2026-04-04 +tags: [service, twilio, voice] --- ## Account diff --git a/tasks.md b/tasks.md index 56ed774..c74e5c1 100644 --- a/tasks.md +++ b/tasks.md @@ -1,6 +1,7 @@ --- title: Tasks -updated: 2026-03-15 +updated: 2026-04-04 +tags: [tasks, infra] --- ## Infra