rtk-setup

# RTK 설치 및 OpenClaw 통합 스킬 RTK(Rust Token Killer)를 설치하고, OpenClaw 에이전트들이 자동으로 RTK 명령어를 사용하도록 강제 설정한다. > **배경:** Claude Code 플러그인 방식(`openclaw plugins install`)은 OpenClaw과 호환되지 않는다. > OpenClaw에서는 AGENTS.md에 지침을 넣어 에이전트에게 강제해야 한다. ## 워크플로 ### STEP 1: RTK 바이너리 설치 확인 ```bash which rtk ``` - 설치됨 → STEP 2로 진행 - 미설치 → `brew install rtk` 실행. brew 없으면 curl 설치: ```bash curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh ``` 설치 후 버전 확인: ```bash rtk --version ``` ### STEP 2: RTK.md 생성 워크스페이스 루트에 `RTK.md` 파일을 생성한다. 이 파일이 에이전트들이 참조할 RTK 사용 규칙이다. `RTK.md` 내용: ```markdown # RTK 사용 규칙 (필수) 이 워크스페이스의 모든 에이전트는 아래 규칙을 **반드시** 따라야 한다. ## 핵심 원칙 Bash 도구로 명령어를 실행할 때, 아래 표의 명령어는 반드시 `rtk` 접두어를 붙여 실행한다. RTK는 출력을 압축하여 토큰 소비를 60-90% 줄인다. ## 필수 치환 표 | 기존 명령어 | RTK 명령어 | |------------|-----------| | `ls`, `tree` | `rtk ls` | | `cat`, `head`, `tail` | `rtk read` | | `grep`, `rg` | `rtk grep` | | `find` | `rtk find` | | `git status` | `rtk git status` | | `git log` | `rtk git log` | | `git diff` | `rtk git diff` | | `git push` | `rtk git push` | | `cargo build` | `rtk cargo build` | | `cargo test` | `rtk test cargo test` | | `npm run build` | `rtk err npm run build` | | `npm test` | `rtk test npm test` | | `docker ps` | `rtk docker ps` | | `kubectl get pods` | `rtk kubectl pods` | | `pip list` | `rtk pip list` | | `pnpm list` | `rtk pnpm list` | ## 예외 (RTK를 쓰지 않는 경우) - Claude Code 내장 도구 (Read, Grep, Glob) 사용 시 → RTK 불필요 - `cd`, `mkdir`, `rm`, `cp`, `mv` 등 출력이 없는 명령어 - 파이프(`|`)로 이미 필터링된 명령어 - 사용자가 명시적으로 원본 출력을 요청한 경우 ## 토큰 절약 현황 확인 세션 종료 전 또는 요청 시: ```bash rtk gain ``` ``` ### STEP 3: AGENTS.md에 RTK 강제 지침 삽입 워크스페이스의 `AGENTS.md` 파일에 아래 블록을 추가한다. 이미 RTK 관련 내용이 있으면 교체한다. 삽입할 블록: ```markdown ## RTK (Rust Token Killer) — 필수 **모든 에이전트는 Bash 명령어 실행 시 반드시 RTK를 사용해야 한다.** 상세 규칙은 `@RTK.md`를 참조하라. 이 규칙은 선택이 아니라 필수다. 요약: - `ls` → `rtk ls`, `cat` → `rtk read`, `grep` → `rtk grep` - `git status/log/diff/push` → `rtk git status/log/diff/push` - 빌드/테스트 → `rtk test ...`, `rtk err ...` - 내장 도구(Read, Grep, Glob)는 예외 **위반 시:** 토큰 낭비로 세션 비용이 불필요하게 증가한다. ``` ### STEP 4: 검증 1. RTK 바이너리 동작 확인: ```bash rtk ls . ``` 2. RTK.md 존재 확인: ```bash ls RTK.md ``` 3. AGENTS.md에 RTK 블록 존재 확인: ```bash grep -c "RTK" AGENTS.md ``` 4. 결과 보고: ``` ✅ RTK 설치 완료 (버전: X.X.X) ✅ RTK.md 생성 완료 ✅ AGENTS.md에 RTK 강제 지침 삽입 완료 → 이제 모든 에이전트가 RTK를 사용합니다. ``` ## 주의사항 - RTK는 Bash 도구에서 실행하는 쉘 명령에만 적용된다. Claude Code 내장 도구(Read, Grep, Glob 등)는 RTK와 무관하다. - `rtk init -g` 로 Claude Code 훅을 설치할 수도 있지만, OpenClaw ACP 환경에서는 훅이 작동하지 않으므로 AGENTS.md 지침 방식을 사용한다. - RTK.md는 워크스페이스별로 생성해야 한다. 글로벌 설정이 아님.