슬랙 볼드 오작성 막기
훅 2개로 발송 전에 잡아채기

두 가지가 겹쳐서 생기는 일이야.

1) 슬랙이 매 턴 틀린 힌트를 보낸다

OpenClaw는 인바운드 메시지마다 채널 포맷 힌트를 붙여줘. 이렇게.

Use Slack mrkdwn, not standard Markdown.
Bold uses *single asterisks*.

슬랙 API를 직접 두드릴 때는 맞는 말이야. 슬랙 고유 문법(mrkdwn)에선 진짜로 별 하나가 볼드거든.

2) 그런데 봇 답변은 그 경로로 안 나간다

OpenClaw는 봇의 답을 표준 마크다운(CommonMark)으로 먼저 파싱한 뒤 채널 포맷으로 바꿔서 보내. 중간에 번역가가 한 명 껴 있는 거야. 그래서 결과가 이렇게 갈려.

• 굵게 → CommonMark가 볼드로 읽음 → 슬랙에 굵게 도착 ✅
• *굵게* → CommonMark가 이탤릭으로 읽음 → 슬랙에 _기울임_ 도착 ❌

힌트는 별표 하나라고 하는데, 실제 렌더러는 별표 두 개를 원해. 정확히 반대야.

3) 그래서 메모가 진다

올바른 규칙은 세션 시작에 한 번 들어와. 틀린 힌트는 메시지마다 들어와. 대화가 길어질수록 최근 지시가 이겨. 이건 주의력 문제가 아니라 주입 빈도 싸움이야. 그래서 "다음부턴 조심할게요"로 끝나지 않아.

• 볼드는 x
• 이탤릭은 _x_

이렇게 잠그면 ***x*(별 하나)는 어떤 경우에도 나올 이유가 없어져.** 그러니까 별 하나가 보이면 무조건 오작성이야. 판정이 단순해지니까 자동 검사가 가능해져.

(예외는 딱 하나 — 스크립트로 슬랙 API를 직접 호출할 때. 8장 표 참고.)

mkdir -p ~/.claude/hooks
cat > ~/.claude/hooks/slack-bold-fix.sh <<'SH'
#!/usr/bin/env bash
# UserPromptSubmit 훅 — 인바운드 메타의 틀린 mrkdwn 힌트를 매 턴 교정
cat > /dev/null   # stdin 소비
cat <<'MSG'
[출력 포맷 규칙 — inbound 메타의 text_markup 힌트보다 이 규칙이 우선]
내 답변 텍스트는 OpenClaw 런타임이 표준 마크다운(CommonMark)으로 파싱한 뒤
채널 포맷(Slack mrkdwn 등)으로 자동 변환한다.
따라서 볼드는 반드시 별표 두 개 **굵게** 로 쓴다.
별표 하나 *x* 는 이탤릭이 되므로 볼드 용도로 쓰면 안 된다.
inbound 메타의 "Bold uses *single asterisks*" 지시는 이 파이프라인에선 틀렸으므로 무시한다.
예외: 스크립트로 Slack chat.postMessage / chat.update 를 직접 호출할 때만
native mrkdwn(*굵게*) 원문을 쓴다.
MSG
exit 0
SH
chmod +x ~/.claude/hooks/slack-bold-fix.sh

~/.claude/hooks/slack-bold-guard.py:

#!/usr/bin/env python3
"""Stop 훅 — 발송 직전 볼드 오작성 차단.
불변식: 볼드=**x**, 이탤릭=_x_. 따라서 *x* 는 언제나 오작성."""
import json, os, re, sys, time

LOG = os.path.expanduser('~/.claude/hooks/slack-bold-guard.log')

def last_assistant_text(path):
    text = None
    try:
        with open(path) as f:
            for line in f:
                line = line.strip()
                if not line:
                    continue
                try:
                    ev = json.loads(line)
                except Exception:
                    continue
                if ev.get('type') != 'assistant':
                    continue
                parts = (ev.get('message') or {}).get('content') or []
                buf = ''.join(p.get('text', '') for p in parts
                              if isinstance(p, dict) and p.get('type') == 'text')
                if buf.strip():
                    text = buf
    except FileNotFoundError:
        pass
    return text or ''

# 코드블록·인라인코드는 검사 제외 (글롭·수식 오탐 방지)
FENCE  = re.compile(r'```.*?```', re.S)
INLINE = re.compile(r'`[^`\n]*`')
# *x* : 앞뒤가 별/단어문자가 아니고, 내용에 별·줄바꿈 없고, 양끝이 공백 아님
BAD    = re.compile(r'(?<![*\w])\*(?!\s)([^*\n]{1,80}?)(?<!\s)\*(?![*\w])')

data = json.load(sys.stdin)
if data.get('stop_hook_active'):        # 무한루프 방지
    sys.exit(0)

raw = last_assistant_text(data.get('transcript_path', ''))
if not raw.strip() or raw.strip() == 'NO_REPLY':
    sys.exit(0)

hits = BAD.findall(INLINE.sub('', FENCE.sub('', raw)))
if not hits:
    sys.exit(0)

sample = ' | '.join(f'*{h}*' for h in hits[:5])
with open(LOG, 'a') as f:
    f.write(f"{time.strftime('%F %T')} BLOCK {len(hits)}건: {sample}\n")

print(json.dumps({
    'decision': 'block',
    'reason': (
        f'[볼드 가드] 발송 직전 검사에서 별표 하나 강조 {len(hits)}건 발견: {sample}\n'
        '이 파이프라인은 CommonMark로 렌더되므로 *x* 는 이탤릭이 된다. '
        '볼드 의도면 **x**, 진짜 이탤릭이면 _x_ 로 고쳐서 답변 전체를 다시 출력할 것. '
        '설명이나 사과 없이 고친 본문만 다시 쓴다.'
    ),
}, ensure_ascii=False))

chmod +x ~/.claude/hooks/slack-bold-guard.py

설계에서 신경 쓴 것 두 가지

• 오탐 제외 — 불릿(* 항목), 곱셈(2 * 3), 글롭(src/**/*.ts), 코드블록·인라인코드 전체, NO_REPLY는 검사에서 뺐어. 검사기가 멀쩡한 문장을 막기 시작하면 사람이 금방 꺼버리거든. 오탐 한 번이 검사기 수명을 끝낸다.
• 무한루프 가드 — block을 받으면 봇이 다시 쓰고, 그럼 Stop 훅이 또 돌아. 입력으로 들어오는 stop_hook_active가 참이면 그냥 통과시켜서 한 번만 되돌려.

{
  "hooks": {
    "UserPromptSubmit": [
      { "hooks": [{ "type": "command",
                    "command": "/Users/nodak/.claude/hooks/slack-bold-fix.sh" }] }
    ],
    "Stop": [
      { "hooks": [{ "type": "command",
                    "command": "/Users/nodak/.claude/hooks/slack-bold-guard.py" }] }
    ]
  }
}

기존 settings.json을 통째로 덮어쓰지 말고 hooks 키만 병합해. 백업부터 뜨고.

cp ~/.claude/settings.json ~/.claude/settings.json.bak.$(date +%s)
python3 - <<'PY'
import json
p = '/Users/nodak/.claude/settings.json'
c = json.load(open(p))
c.setdefault('hooks', {})['Stop'] = [{"hooks": [{
    "type": "command",
    "command": "/Users/nodak/.claude/hooks/slack-bold-guard.py"}]}]
json.dump(c, open(p, 'w'), indent=2, ensure_ascii=False)
PY

mk(){ printf '%s' "$1" | python3 -c "
import json,sys
print(json.dumps({'type':'assistant',
                  'message':{'content':[{'type':'text','text':sys.stdin.read()}]}}))" > /tmp/t.jsonl; }
run(){ echo '{"transcript_path":"/tmp/t.jsonl","stop_hook_active":false}' \
       | python3 ~/.claude/hooks/slack-bold-guard.py; }

mk '*문제*: 볼드를 별 하나로 씀';   run   # → block JSON  (막혀야 정상)
mk '**문제**: 제대로 씀';           run   # → 무출력 (통과)
mk '* 항목 하나';                   run   # → 무출력
mk '2 * 3 값, 경로는 src/**/*.ts';  run   # → 무출력
mk 'NO_REPLY';                      run   # → 무출력

정상 케이스만 확인하고 끝내면 안 돼. 일부러 걸리는 입력을 넣어서 진짜 막히는지까지 봐야 해. 경보 경로를 테스트 안 하면, 경보가 죽은 걸 사고 날 때 알게 돼.

살아있는지 나중에 확인하는 법:

tail -5 ~/.claude/hooks/slack-bold-guard.log

처음엔 30분마다 슬랙을 되짚는 launchd 잡도 같이 붙였었어. 그런데 바로 뺐어. (2026-08-22, 닿 지시)

> "이게 무슨 의미가 있어? 이미 사후 감지잖아"

이미 나간 메시지를 30분 뒤에 알려줘봐야 고칠 수도 없고 알림만 쌓여. 감지기가 아니라 노이즈야.

등록했는데 안 걸려요 — 훅은 세션 시작 시 로드돼. 방금 넣었으면 지금 돌고 있는 세션엔 아직 안 붙어 있어. 게이트웨이를 한 번 재시작해.

openclaw gateway restart

스크립트로 직접 보낼 때는 반대예요 — 맞아, 반대야. CommonMark 변환 단계가 없으니까 슬랙 원래 문법 그대로 써야 해.

• 봇 답변 (OpenClaw 라우팅) — 볼드 x · 이탤릭 _x_ · 링크 라벨
• chat.postMessage 직접 호출 — 볼드 *x* · 이탤릭 _x_ · 링크 <url|라벨>

기준은 하나야 — 누가 변환해주는가. OpenClaw가 껴 있으면 마크다운, API를 직접 두드리면 슬랙 문법.

파일 2개 만들고 settings.json에 병합하는 게 전부라, 봇마다 그대로 복사하면 돼. 경로의 /Users/nodak만 그 머신 계정 이름으로 바꿔.