|
26 | 26 | - [9. 채널·서버별 동작 조정](#9-채널·서버별-동작-조정) |
27 | 27 | - [10. 워크스페이스·인격을 봇으로 끌어오기](#10-워크스페이스인격을-봇으로-끌어오기) |
28 | 28 | - [11. 봇 행동 관리 (mute · disable · 다중 서버)](#11-봇-행동-관리-mute--disable--다중-서버) |
| 29 | +- [12. 🎬 상황별 Discord 워크플로우 — 모든 상황에서](#12--상황별-discord-워크플로우--모든-상황에서) |
29 | 30 | - [🎯 명령·인터랙션 cheat sheet](#-명령인터랙션-cheat-sheet) |
30 | 31 | - [🔒 보안 주의](#-보안-주의-꼭-읽으세요) |
31 | 32 | - [🛠 트러블슈팅](#-트러블슈팅) |
@@ -412,6 +413,215 @@ OpenClaw 가 attachment 지원하는 경우: |
412 | 413 |
|
413 | 414 | 자세한 일상 on/off 사이클: [GUIDE-DAILY-USE.md](GUIDE-DAILY-USE.md). |
414 | 415 |
|
| 416 | +--- |
| 417 | + |
| 418 | +## 12. 🎬 상황별 Discord 워크플로우 — 모든 상황에서 |
| 419 | + |
| 420 | +"지금 내 위치/상황에서 Discord 로 OpenClaw 에이전트한테 무엇을 어떻게 시키면 되나" 의 8가지 케이스. 각 시나리오는 **언제 / Discord 에 보낼 메시지 / 일어나는 일 / 한계** 4개로 구성. |
| 421 | + |
| 422 | +### ① 노트북 옆에 있을 때 — 빠른 질문 |
| 423 | + |
| 424 | +**언제** — 코드 짜다 막힘, 모르는 명령어, 단순 Q&A. |
| 425 | + |
| 426 | +**Discord 에** |
| 427 | +``` |
| 428 | +@OpenClaw-Mo rsync 로 권한 유지하면서 폴더 동기화하는 옵션이 뭐였지? |
| 429 | +``` |
| 430 | + |
| 431 | +**일어나는 일** — 봇이 즉시 응답. 채널에 그 답이 남으니 나중에 "지난주에 답해줬던 거" 검색 가능. |
| 432 | + |
| 433 | +**한계** — 터미널과 비교: TUI/chat 이 응답 속도는 더 빠르고 토큰도 절약 (시스템 prompt 가 매번 안 실림). 그래도 채널 히스토리·팀 공유 이점이 크면 Discord. |
| 434 | + |
| 435 | +**TIP**: 자주 쓰는 quick-Q 채널 하나 만들어서 [§9 채널 화이트리스트](#9-채널·서버별-동작-조정) 에 등록 → 멘션 없이 모든 메시지에 응답. |
| 436 | + |
| 437 | +--- |
| 438 | + |
| 439 | +### ② 외출 중 / 모바일에서만 접근 가능 |
| 440 | + |
| 441 | +**언제** — 카페·이동 중·미팅 대기. 노트북 못 열고 폰만 있음. |
| 442 | + |
| 443 | +**Discord 에 (DM 으로)** |
| 444 | +``` |
| 445 | +오늘 약속 끝나고 ~/DEV/openclawAgent/daily-notes/ 안에 |
| 446 | +"2026-05-14.md" 파일 만들어서 다음 내용 적어줘: |
| 447 | +
|
| 448 | +회의 핵심: |
| 449 | +- A 안건은 다음주로 연기 |
| 450 | +- B 는 내일 오전까지 초안 보내기 |
| 451 | +``` |
| 452 | + |
| 453 | +**일어나는 일** |
| 454 | +- 봇이 호스트 워크스페이스(`~/DEV/openclawAgent`) 에 파일 작성. 노트북은 켜져 있어야 함 (OpenClaw 컨테이너가 살아있어야 봇이 도구 사용 가능). |
| 455 | +- 노트북 돌아가서 보면 그 파일이 그대로 있음. |
| 456 | + |
| 457 | +**한계** |
| 458 | +- 노트북이 꺼져 있거나 슬립이면 (Docker·OpenClaw 가 안 떠 있으면) 봇이 Offline → 답 없음. **외출 전엔 `./openclaw start` 확인 + Discord 봇 Online 인지 한 줄 보고.** |
| 459 | +- 모바일은 긴 코드 붙여넣기 불편 — `surf` 같은 도구 호출도 가능하지만 결과를 폰에서 읽긴 짧은 게 편함. |
| 460 | + |
| 461 | +**예: 외출 전 30초 점검** |
| 462 | +```bash |
| 463 | +./openclaw doctor # ✓ 다 떠 있는지 |
| 464 | +./openclaw network status # online 인지 (isolated 면 봇이 Discord 와 통신 못 함) |
| 465 | +# Discord 에서 봇 Online 점 확인 |
| 466 | +``` |
| 467 | + |
| 468 | +--- |
| 469 | + |
| 470 | +### ③ 팀 채널 협업 |
| 471 | + |
| 472 | +**언제** — 동료들과 같이 회의록·외부 링크·코드 리뷰를 같이 보고 싶을 때. |
| 473 | + |
| 474 | +**Discord 에 (팀 채널)** |
| 475 | +``` |
| 476 | +@OpenClaw-Mo 이 PR diff 핵심 3가지 + 잠재 버그 / 보안 이슈 요약해줘 |
| 477 | +``` |
| 478 | +```` |
| 479 | +```diff |
| 480 | ++ const apiKey = process.env.API_KEY; |
| 481 | +- const apiKey = "hardcoded-key-123"; |
| 482 | ++ fetch(url + "?key=" + apiKey) |
| 483 | +``` |
| 484 | +```` |
| 485 | + |
| 486 | +**일어나는 일** — 봇 응답이 채널에 공개로 남음 → 팀 전원이 활용. 다른 멤버가 follow-up 질문 가능: `@OpenClaw-Mo 그러면 .env 파일 형식은 어떻게 하는 게 좋아?` |
| 487 | + |
| 488 | +**한계** — 채널의 모든 멤버가 봇 응답을 볼 수 있음. 비밀 코드는 DM 으로. 봇 토큰을 채널에 노출 절대 금지 ([🔒 보안 주의](#-보안-주의-꼭-읽으세요) §3). |
| 489 | + |
| 490 | +**TIP**: 코드 리뷰·회의록 같은 팀 작업은 **스레드** 로 진행 → 메인 채널 잡담 안 끊고 길게 대화 가능. |
| 491 | + |
| 492 | +--- |
| 493 | + |
| 494 | +### ④ 워크스페이스 파일 작업 (읽기·수정·정리) |
| 495 | + |
| 496 | +**언제** — 자기 노트·MEMORY·일일 기록을 봇으로 조회·정리. |
| 497 | + |
| 498 | +**Discord 에** |
| 499 | +``` |
| 500 | +@OpenClaw-Mo ~/DEV/openclawAgent/MEMORY.md 에서 "디스코드" 키워드 들어간 항목만 |
| 501 | +시간순으로 정리해서 보여줘 |
| 502 | +
|
| 503 | +@OpenClaw-Mo daily-notes 폴더 최근 7일치 회고만 모아서 한 줄씩 요약해줘 |
| 504 | +
|
| 505 | +@OpenClaw-Mo 방금 우리 대화 핵심을 MEMORY.md 에 "discord-workflows" 섹션으로 추가해줘 |
| 506 | +``` |
| 507 | + |
| 508 | +**일어나는 일** — 봇이 호스트 워크스페이스 (마운트된 `/home/node/.openclaw/workspace`, 호스트의 `~/DEV/openclawAgent`) 에 직접 접근. 변경된 파일은 호스트에서 그대로 보임. |
| 509 | + |
| 510 | +**한계** |
| 511 | +- 호스트 임의 경로 (`~/Documents`, `~/Desktop`) 는 **접근 불가** — 격리 의도. 공유하려면 워크스페이스 안에 둬야 함. |
| 512 | +- 큰 파일 (수십 MB+) 은 컨텍스트에 한 번에 못 들어감. 봇이 "일부만 봤다" 라고 명시할 것. |
| 513 | +- 동시 수정 위험 — 봇이 파일 쓰는 도중 사용자가 열어서 편집하면 충돌. 큰 작업 전에 알려서 동시 편집 회피. |
| 514 | + |
| 515 | +--- |
| 516 | + |
| 517 | +### ⑤ 시스템 상태 점검 / 운영 (DevOps) |
| 518 | + |
| 519 | +**언제** — "서버 떠 있어?", "에러 났던 거 로그 보여줘" — 터미널 못 열고 빠르게. |
| 520 | + |
| 521 | +**Discord 에 (DM 추천)** |
| 522 | +``` |
| 523 | +@OpenClaw-Mo 지금 ./openclaw doctor 결과 보여줘 |
| 524 | +
|
| 525 | +@OpenClaw-Mo gateway 컨테이너 최근 50줄 로그에서 ERROR 나 WARN 만 추려줘 |
| 526 | +
|
| 527 | +@OpenClaw-Mo ~/.openclaw-mgr/network-mode 파일 내용 알려줘 |
| 528 | +``` |
| 529 | + |
| 530 | +**일어나는 일** — 봇이 도구 사용 권한 있고 명령 실행 허용된 설정이면 호스트 명령을 컨테이너 안에서 또는 SSH 같은 방식으로 실행 후 결과 정리해서 답. (OpenClaw 의 정책·플러그인에 따라 달라짐 — 기본은 워크스페이스 안 파일 조회만 안전.) |
| 531 | + |
| 532 | +**한계 (중요)** |
| 533 | +- 봇에게 임의 호스트 명령 실행 권한 주는 건 보안 트레이드오프. **계정 사용자 = Discord 친구들** 인 작은 운영팀에서만 권장. |
| 534 | +- 민감 작업(컨테이너 재시작, 백업 복원, 토큰 갱신 등) 은 차라리 터미널로 직접. 봇 응답 신뢰성·롤백 비용 고려. |
| 535 | + |
| 536 | +**TIP**: 운영용 채널 (예: `#ops-alerts`) 을 [§9 자동 응답 채널](#9-채널·서버별-동작-조정) 로 등록 → 멘션 없이도 "지금 상태?" 같은 메시지에 응답. |
| 537 | + |
| 538 | +--- |
| 539 | + |
| 540 | +### ⑥ 긴 작업 트리거 + 알림 받기 |
| 541 | + |
| 542 | +**언제** — 대용량 PDF 요약, 여러 URL 크롤·정리, 큰 모델 추론 등 1~10분 걸리는 작업. |
| 543 | + |
| 544 | +**Discord 에** |
| 545 | +``` |
| 546 | +@OpenClaw-Mo 이 PDF 30페이지 요약 부탁 (첨부 파일) |
| 547 | +끝나면 멘션으로 알려줘 |
| 548 | +
|
| 549 | +@OpenClaw-Mo surf 로 "오늘 KOSPI 종가 + 외인 순매수 상위 10개" 검색해서 |
| 550 | +마크다운 표로 정리, 완료 시 #notes 에 올려줘 |
| 551 | +``` |
| 552 | + |
| 553 | +**일어나는 일** |
| 554 | +- 봇이 작업 시작 → 짧은 "받았어, 시작할게" 응답 |
| 555 | +- 백그라운드 처리 후 결과를 답글 또는 다른 채널에 포스팅 |
| 556 | +- 봇이 mention 으로 알림 → Discord 알림 → 폰까지 푸시 |
| 557 | + |
| 558 | +**한계** |
| 559 | +- 봇이 작업 도중 컨테이너가 재시작되면 작업 유실. 매우 긴 작업은 별도 큐/스케줄러 필요. |
| 560 | +- 메시지 길이 한도 (2,000자) — 결과가 길면 봇이 자동으로 파일로 첨부 또는 스레드 분할. |
| 561 | + |
| 562 | +--- |
| 563 | + |
| 564 | +### ⑦ 정기 작업 · 리마인더 |
| 565 | + |
| 566 | +**언제** — "매일 아침 어제 회의록 요약", "월요일 9시에 주간 OKR 점검 알림". |
| 567 | + |
| 568 | +**Discord 에 (설정 한 번)** |
| 569 | +``` |
| 570 | +@OpenClaw-Mo 매일 평일 오전 9시에 #notes 채널에 |
| 571 | +어제 daily-notes 폴더에 새로 추가된 파일이 있으면 요약해서 올려줘 |
| 572 | +없으면 조용히 패스 |
| 573 | +``` |
| 574 | + |
| 575 | +**일어나는 일** — OpenClaw 의 스케줄러 / cron 통합이 활성화돼 있으면 봇이 정해진 시간에 자동 실행. ([README — 자동 업데이트 스케줄](../README.md#-업데이트-흐름) 의 launchd 와 같은 메커니즘.) |
| 576 | + |
| 577 | +**한계** |
| 578 | +- OpenClaw 본체 / 플러그인 버전에 따라 스케줄러 지원이 다름. 미지원이면 호스트에서 cron 으로 `./openclaw chat --no-system -m gemma4:26b <<< "..."` 같은 방식 우회. |
| 579 | +- 봇이 끄져 있는 시간엔 스케줄도 안 돌아감. 노트북 항상 켜져 있다는 전제. |
| 580 | + |
| 581 | +--- |
| 582 | + |
| 583 | +### ⑧ Cold boot / 노트북 비정상 종료 직후 |
| 584 | + |
| 585 | +**언제** — 노트북을 완전히 껐다 다시 켰거나, 비정상 종료 후 일어남. |
| 586 | + |
| 587 | +**Discord 측** |
| 588 | +- 봇은 자동으로 다시 Online 시도 (gateway healthy 후 30~60초 안에). |
| 589 | +- 봇 멤버 옆 초록 점이 보이지 않으면 노트북 측 점검 필요. |
| 590 | + |
| 591 | +**확인 / 복구 순서** |
| 592 | +```bash |
| 593 | +# 노트북에서 (시나리오 0 cold-boot 경로 — GUIDE-DAILY-USE 참조) |
| 594 | +cd ~/DEV/openclawAgent/openclaw-workspace/openclaw-mgr |
| 595 | +./openclaw doctor |
| 596 | +./openclaw start # 컨테이너 자동 복구 안 된 경우 |
| 597 | +./openclaw network status # isolated 면 → online 으로 (봇이 Discord 로 나갈 길) |
| 598 | +./openclaw network online --restart |
| 599 | +./openclaw logs | grep -i discord # 봇 재연결 진행 확인 |
| 600 | +``` |
| 601 | + |
| 602 | +**Discord 에서 빠른 테스트** |
| 603 | +``` |
| 604 | +@OpenClaw-Mo 살아있어? |
| 605 | +``` |
| 606 | +응답 오면 OK. 안 오면 [§ 트러블슈팅: 봇 Offline](#봇이-서버에서-계속-offline) 트레일. |
| 607 | + |
| 608 | +**한계** — Discord 만 있고 노트북 접근이 아예 불가능한 상황에선 봇 자체를 다시 살릴 방법이 없음. **모바일 응급용 SSH** (예: Tailscale + iSH/Termius) 같은 비상 경로를 미리 준비해두면 외출 중에도 `./openclaw start` 가능. |
| 609 | + |
| 610 | +--- |
| 611 | + |
| 612 | +### 상황별 빠른 매칭 표 |
| 613 | + |
| 614 | +| 어디 / 언제 | 권장 트리거 | 채널 | 비고 | |
| 615 | +|---|---|---|---| |
| 616 | +| 노트북 옆 | @멘션 또는 자동응답 채널 | 채널 | TUI/chat 도 같이 좋은 선택 | |
| 617 | +| 외출 (모바일) | DM | DM | 노트북 켜져 있어야 함 | |
| 618 | +| 팀 협업 | @멘션 + 스레드 | 팀 채널 | 비밀 정보는 DM 으로 | |
| 619 | +| 워크스페이스 작업 | @멘션 (workspace 내 경로 명시) | 어디든 | 호스트 외부 경로는 접근 불가 | |
| 620 | +| 시스템 운영 | DM 또는 운영 전용 채널 | 운영 채널 | 권한 신중 | |
| 621 | +| 긴 작업 트리거 | @멘션 + "완료 시 알려줘" | 채널 (결과 공개 OK 라면) | 결과 길면 자동 첨부 | |
| 622 | +| 정기 알림 | 한 번 설정 + 봇 자동 실행 | 알림 채널 | 노트북 항상 켜져 있어야 함 | |
| 623 | +| Cold boot 직후 | @멘션 "살아있어?" | DM 또는 채널 | 봇 Offline 이면 노트북 점검 | |
| 624 | + |
415 | 625 | ### 영구 비활성 (Discord 만 빼고 OpenClaw 는 유지) |
416 | 626 |
|
417 | 627 | ```bash |
|
0 commit comments