docs+qa: friendlier guide intros + fix broken contrib links

QA pass found:
  - bash -n: all 30 shell scripts pass
  - ast.parse: all 9 python modules pass
  - exec perms on 7 entry-point scripts: all OK
  - typo / U+FFFD scan: 0 hits
  - cross-link scan: 6 broken relative GitHub links in
    docs/GUIDE-CONTRIBUTING.md (../../issues/new/choose,
    ../../discussions) — converted to absolute URLs.

Guide intros — replaced one-liner blurbs with a uniform 'easy yet
professional' panel on all three automation guides. Each intro now
answers up front:

    한 줄 요약  · 누구에게 좋은가요?  · 무엇이 필요한가요?
                                   ·  조심할 점은? / 솔직한 한계는?
    + 5분 빠른 시작 (TL;DR) 코드 블록

so a new reader knows in <1 minute whether the guide applies to them
and exactly which command to run first. The deeper sections (sandbox
boundary, selector repair, ffmpeg fallback, ToS, ...) are unchanged
behind the new panel.

Files:
  ~ docs/GUIDE-WEB-FETCH.md
  ~ docs/GUIDE-CREATIVE-PIPELINE.md
  ~ docs/GUIDE-SHORTS-PIPELINE.md
  ~ docs/GUIDE-CONTRIBUTING.md  (absolute issue/discussion URLs)

Author: 박성모

docs/GUIDE-CONTRIBUTING.md

@@ -20,9 +20,9 @@
 
 | 종류 | 난이도 | 어떻게 |
 |---|---|---|
-| 🐛 버그 신고 | ⭐ | GitHub 에서 [새 이슈 → 🐛 Bug](../../issues/new/choose) |
-| 💡 기능 아이디어 제안 | ⭐ | GitHub 에서 [새 이슈 → ✨ Feature](../../issues/new/choose) |
-| ❓ 질문하기 | ⭐ | [Discussions](../../discussions) (있으면) 또는 이슈 |
+| 🐛 버그 신고 | ⭐ | GitHub 에서 [새 이슈 → 🐛 Bug](https://github.com/GoGoComputer/openclaw-workspace/issues/new/choose) |
+| 💡 기능 아이디어 제안 | ⭐ | GitHub 에서 [새 이슈 → ✨ Feature](https://github.com/GoGoComputer/openclaw-workspace/issues/new/choose) |
+| ❓ 질문하기 | ⭐ | [Discussions](https://github.com/GoGoComputer/openclaw-workspace/discussions) (있으면) 또는 이슈 |
 | 📝 오타·말투 수정 | ⭐⭐ | README 의 ✏️ 아이콘 → 직접 수정 → "Propose changes" |
 | 📖 문서 번역·보강 | ⭐⭐ | KO ↔ EN 번역, 헷갈렸던 부분 명확화 |
 | 🆘 다른 사람 질문에 답하기 | ⭐⭐ | 이슈/디스커션에서 본인 경험 공유 |
@@ -113,9 +113,9 @@ openclaw install         # 새 환경에서 설치 시도
 
 | Kind | Difficulty | How |
 |---|---|---|
-| 🐛 Report a bug | ⭐ | GitHub → [New issue → 🐛 Bug](../../issues/new/choose) |
-| 💡 Suggest a feature | ⭐ | GitHub → [New issue → ✨ Feature](../../issues/new/choose) |
-| ❓ Ask a question | ⭐ | [Discussions](../../discussions) (if enabled) or an issue |
+| 🐛 Report a bug | ⭐ | GitHub → [New issue → 🐛 Bug](https://github.com/GoGoComputer/openclaw-workspace/issues/new/choose) |
+| 💡 Suggest a feature | ⭐ | GitHub → [New issue → ✨ Feature](https://github.com/GoGoComputer/openclaw-workspace/issues/new/choose) |
+| ❓ Ask a question | ⭐ | [Discussions](https://github.com/GoGoComputer/openclaw-workspace/discussions) (if enabled) or an issue |
 | 📝 Fix a typo / wording | ⭐⭐ | Click ✏️ in any README → edit → "Propose changes" |
 | 📖 Translate / improve docs | ⭐⭐ | KO ↔ EN translation; clarify confusing parts |
 | 🆘 Help others on issues | ⭐⭐ | Share your own experience |

docs/GUIDE-CREATIVE-PIPELINE.md

@@ -2,11 +2,30 @@
 
 [← README 로 돌아가기](../README.md) · [README (English)](../README.en.md)
 
+> **한 줄 요약.** Pinterest 에서 레퍼런스를 모아 → LLM 이 프롬프트 N개로 확장 → 나노바나나(Gemini) 웹을 **창 4개 병렬**로 돌려 이미지 생성 → Figma 디자인에 그리드로 자동 배치. 단일 명령 `creative run "키워드"` 로 완결.
 
-> Pinterest(레퍼런스) → Claude(프롬프트) → 나노바나나(이미지) → Figma 워크플로우를 **한 명령**으로 묶고, 나노바나나 웹 UI 를 **여러 창 병렬**로 띄워 속도를 올립니다.
+<table>
+<tr><td><b>누구에게 좋은가요?</b></td><td>• 하루에도 몇 번씩 "레퍼런스 높기 → 프롬프트 돌리기 → 피그마 붙이기"를 반복하는 디자이너·마케터<br>• 테스트 시안을 대관 시간 안에 12장씯 붙여보고 싶은 사람<br>• 나노바나나 웹 1창만 쓰면 너무 느려서 답답했던 사람</td></tr>
+<tr><td><b>무엇이 필요한가요?</b></td><td>• macOS + Homebrew + Docker Desktop<br>• 호스트 Ollama (`qwen2.5vl:7b` 비전용 + `qwen2.5-coder:7b` 텍스트용)<br>• Google 계정 (나노바나나 로그인용), Figma 계정 (Editor 권한)<br>• 1회 세팅: `bash scripts/creative-pipeline-setup.sh`</td></tr>
+<tr><td><b>존중해야 할 경계는?</b></td><td>• OpenClaw 메인 컨테이너는 건들지 않고 `isolated` 로 유지 — 디자이너 워크플로우는 호스트의 `~/openclaw-creative/` 안에서만 동작<br>• 나노바나나 웹 자동화는 Google 웹 ToS 의 회색 영역 — 개인 대시보드용으로만 사용, 상업 재배포 금지<br>• 프로필 권한 700, 토큰판 Figma 폴백 때만 `.env` 이용 등 최소 권한 원칙</td></tr>
+</table>
+
+## 5분 빠른 시작 (TL;DR)
+
+```bash
+# 1회
+bash scripts/creative-pipeline-setup.sh
+creative banana-login        # 창 떠서 구글 로그인 → 창 닫기
+creative figma-login         # 창 떠서 Figma 로그인 → 창 닫기
+
+# 이후 매번
+creative run "동남아시아 풍경 일러스트" --variations 12 --windows 4
+# → 이미지 12장 생성 (~1분 5초), Figma 지정 페이지에 4열 그리드 배치
+```
 
 이 가이드는 OpenClaw 의 일부가 아닌 **개인 작업 자동화** 입니다. 별도 디렉터리(`~/openclaw-creative/`) 에서 동작하며, OpenClaw 컨테이너의 isolated 정책과 무관합니다.
 
+
 ## 📖 목차 / Contents
 
 - [🇰🇷 한국어](#-한국어)

docs/GUIDE-SHORTS-PIPELINE.md

@@ -3,7 +3,26 @@
 [← README 로 돌아가기](../README.md) · [README (English)](../README.en.md)
 
 
-> 한 명령(`shorts run "키워드"`)으로 **레퍼런스 수집 → 디자인 편집 → 영상 export** 까지. OpenClaw 보안 모델은 그대로 유지하고, 호스트(맥북)에서 실제 프로그램(미리캔버스 웹, CapCut Web/Desktop)을 사람과 동일하게 GUI 로 조종합니다.
+> **한 줄 요약.** 한 명령(`shorts run "키워드"`)으로 **레퍼런스 수집 → 디자인 편집 → 영상 export** 까지. OpenClaw 보안 모델은 그대로 유지하고, 호스트(맥북)에서 실제 프로그램(미리캔버스 웹, CapCut Web/Desktop)을 사람과 동일하게 GUI 로 조종합니다.
+
+<table>
+<tr><td><b>누구에게 좋은가요?</b></td><td>• 쇼츠·릴스 소재를 주기적으로 올리는 일반 크리에이터<br>• 콘텐츠는 직접 큐레이팅하고 싶지만 반복적인 업로드·배치 작업은 자동화하고 싶은 사람<br>• 단순 슬라이드쇼는 ffmpeg 한 줄로 완전 무인 처리하고 싶은 개발자</td></tr>
+<tr><td><b>무엇이 필요한가요?</b></td><td>• macOS + Homebrew + Docker Desktop (대장은 아니지만 동렬에 포함)<br>• 미리캔버스 계정 (무료 플랜 충분) + CapCut 계정 (TikTok / 구글 / 이메일)<br>• 1회 세팅: `bash scripts/shorts-setup.sh` → `shorts miri-login` `shorts capcut-login`</td></tr>
+<tr><td><b>장점과 솔직한 한계는?</b></td><td>🟢 업로드·미디어 임포트·export는 안정 자동.<br>🟡 미리캔버스·CapCut Web 의 레이아웃 좌표 API 는 비공개 — 정밀한 드래그 배치는 `SHORTS_HEADED=1` 헤드모드로 1분만 손으로.<br>🟢 단순 슬라이드쇼는 아래 ffmpeg 폴백으로 **완전 무인** 가능.</td></tr>
+</table>
+
+## 5분 빠른 시작 (TL;DR)
+
+```bash
+# 1회
+bash scripts/shorts-setup.sh
+shorts miri-login            # 미리캔버스 로그인 → 창 닫기
+shorts capcut-login          # CapCut 로그인 → 창 닫기
+
+# 이후 매번
+shorts run "여행 감성 풍경"
+# → ~/openclaw-shorts/out/여행-감성-풍경/shorts.mp4
+```
 
 ---
 

docs/GUIDE-WEB-FETCH.md

@@ -2,9 +2,29 @@
 
 [← README 로 돌아가기](../README.md) · [README (English)](../README.en.md)
 
+> **한 줄 요약.** OpenClaw 는 기본적으로 외부 인터넷을 차단(`isolated`)합니다. 필요한 시점에만 잠깐 `online` 으로 열어 실시간 데이터를 가져오고 다시 잠금니다. 더 쉬운 방식은 이 가이드 §8 의 `surf` 명령 — 한 줄로 검색 → 마크다운 브리프를 1회용 Docker 샌드박스 안에서 만듭니다.
 
-> 🇰🇷 OpenClaw 가 인터넷에서 코스피 종가·뉴스 기사·환율 같은 정보를 가져오는 방법.
-> 🇬🇧 How to let OpenClaw fetch live information (KOSPI, news headlines, FX rates...) from the internet.
+<table>
+<tr><td><b>누구에게 좋은가요?</b></td><td>• 매일 코스피 종가·뉴스 요약을 부담 없이 받고 싶은 일반 사용자<br>• 논문·리서치·FX 같은 실시간 데이터를 LLM 입력으로 쓰고 싶은 개발자<br>• 보안이 중요한 환경에서 웹 접근을 명시적 토글로 관리하고자 하는 팀</td></tr>
+<tr><td><b>무엇이 필요한가요?</b></td><td>• OpenClaw 설치 완료 (`./openclaw doctor` 결과 OK)<br>• 인터넷 연결<br>• (`surf` 만) Docker Desktop 실행 중 + `bash scripts/surf-setup.sh` 1회 실행</td></tr>
+<tr><td><b>조심할 점은?</b></td><td>• 웹 페이지는 악의적 프롬프트를 포함할 수 있으므로 (**간접 프롬프트 인젝션**), 작업 직후 다시 `isolated` 로 잠그고 RSS·공식 API 를 우선하세요. 작업하는 동안에도 컨테이너는 read-only + 127.0.0.1 전용 바인딩이라 호스트 파일 시스템과 식별자는 그대로 보호됩니다.</td></tr>
+</table>
+
+## 5분 빠른 시작 (TL;DR)
+
+```bash
+# 더 쉽고 안전한 길: 1회용 샌드박스 컨테이너
+bash scripts/surf-setup.sh                           # 1회
+surf "오늘 코스피 종가와 거래대금"             # 이후 매번
+# → ~/openclaw-surf/out/오늘-코스피-종가...-YYYYMMDD-HHMM.md
+
+# 전통적 길: OpenClaw 컨테이너 자체를 online 으로 잠시 전환
+./openclaw network online --restart
+#  … 원하는 질문을 OpenClaw UI 에서 수행 …
+./openclaw network isolated --restart                # 작업 끝나면 잠그기
+```
+
+---
 
 이 가이드는 [GUIDE-OPENCLAW.md](GUIDE-OPENCLAW.md) 의 짧은 "웹에서 가져오기" 단락을 **실전 예시·안전 패턴·트러블슈팅** 까지 확장합니다.