요약 (TL;DR)
OpenClaw는 작업을 수행하기 위해 도구(Tools)와 기술(Skills)을 사용합니다. 도구는 낮은 수준의 기능(파일 읽기, 명령 실행, 웹 검색)이며, 기술은 여러 도구를 결합한 사전 구축된 워크플로우(코드 검토, 회의 요약)입니다. 이 가이드는 25가지 기본 도구, 53개 이상의 커뮤니티 기술, 이들을 활성화/비활성화하는 방법, 그리고 사용자 정의 기술을 생성하는 방법을 설명합니다.
도구(Tools) vs 기술(Skills): 차이점 이해하기
OpenClaw의 강력함은 두 가지 시스템이 함께 작동하는 데서 나옵니다:
도구(Tools) = OpenClaw가 할 수 있는 것 (기능)
기술(Skills) = OpenClaw가 하는 방법을 아는 것 (워크플로우)
도구를 신체의 '장기'로, 기술을 '학습된 행동'으로 생각해보세요. 도구는 OpenClaw에게 파일을 읽거나 명령을 실행하는 능력을 부여합니다. 기술은 코드 검토나 회의 요약과 같은 특정 작업을 위해 이러한 도구를 사용하는 방법을 가르칩니다.
예시: 코드 검토
기술 없이 (도구만 사용):
You: "이 PR을 검토해 줘"
OpenClaw: "파일을 읽고 웹을 검색할 수는 있지만, 코드를 검토하는 방법은 모릅니다. 더 구체적으로 설명해 주시겠어요?"
기술 사용:
You: "이 PR을 검토해 줘"
OpenClaw: [code_review 기술 사용]
- 변경된 파일 읽기 (read 도구)
- 흔한 실수 확인 (분석)
- 유사한 문제 검색 (web_search 도구)
- 댓글 작성 (github 도구)
기술은 복잡한 작업을 수행하기 위해 도구를 조율합니다.
25가지 기본 도구
도구는 OpenClaw에 내장되어 있습니다. OpenClaw가 수행하도록 신뢰하는 작업에 따라 도구를 활성화하거나 비활성화합니다.
파일 시스템 도구
1. read (읽기)
기능: 파일 내용 읽기
사용 사례: 코드 보기, 설정 확인, 로그 분석
보안: 읽기 전용, 파일 수정 불가
예시:
You: "package.json을 읽어줘"
OpenClaw: [파일 내용을 보여줍니다]
2. write (쓰기)
기능: 파일 생성 또는 수정
사용 사례: 코드 생성, 설정 업데이트, 문서 생성
보안: 파일을 덮어쓸 수 있으므로 주의해서 사용하세요
예시:
You: "'Hello World' 내용을 담은 test.txt 파일을 만들어줘"
OpenClaw: "완료. test.txt 파일이 생성되었습니다."
3. list (목록)
기능: 파일 및 디렉토리 목록 나열
사용 사례: 프로젝트 구조 탐색, 파일 찾기
보안: 읽기 전용
예시:
You: "src/ 디렉토리의 파일들을 나열해 줘"
OpenClaw: "src/ 에는 다음이 포함되어 있습니다:
- api/
- components/
- utils/
- index.js"
4. search (검색)
기능: 파일 내용 검색 (grep과 유사)
사용 사례: 코드 패턴 찾기, 함수 위치 파악
보안: 읽기 전용
예시:
You: "모든 JavaScript 파일에서 'TODO'를 검색해 줘"
OpenClaw: "12개의 일치 항목을 찾았습니다:
- src/api/users.js:45
- src/utils/helpers.js:23
..."
실행 도구
5. exec (실행)
기능: 셸 명령 실행
사용 사례: 테스트 실행, 프로젝트 빌드, 코드 배포
보안: 고위험—모든 명령을 실행할 수 있습니다
예시:
You: "npm test를 실행해 줘"
OpenClaw: [테스트를 실행하고 결과를 보여줍니다]
보안 참고: OpenClaw를 완전히 신뢰하는 경우에만 exec을 활성화하세요. rm -rf와 같은 파괴적인 명령을 실행할 수 있습니다.
6. python (파이썬)
기능: 파이썬 코드 실행
사용 사례: 데이터 분석, 스크립팅, 자동화
보안: 임의의 파이썬 코드를 실행할 수 있습니다
예시:
You: "[10, 20, 30, 40]의 평균을 계산해 줘"
OpenClaw: [파이썬 실행] "평균: 25"
7. node (노드)
기능: Node.js 코드 실행
사용 사례: JavaScript 스크립팅, API 호출
보안: 임의의 JavaScript를 실행할 수 있습니다
예시:
You: "https://api.example.com/users에서 데이터를 가져와 줘"
OpenClaw: [Node.js fetch 실행] "50명의 사용자를 가져왔습니다"
웹 도구
8. web_search (웹 검색)
기능: 인터넷 검색 (Google, Bing)
사용 사례: 연구, 사실 확인, 문서 찾기
보안: 낮은 위험—읽기 전용
예시:
You: "OpenClaw 문서를 검색해 줘"
OpenClaw: "찾은 결과:
1. docs.openclaw.ai - 공식 문서
2. github.com/openclaw - 저장소
..."
9. web_fetch (웹 가져오기)
기능: 웹 페이지 내용 다운로드
사용 사례: 데이터 스크랩, 기사 읽기, 사이트 모니터링
보안: 낮은 위험—읽기 전용
예시:
You: "https://example.com의 내용을 가져와 줘"
OpenClaw: [페이지 내용을 다운로드하여 보여줍니다]
10. web_screenshot (웹 스크린샷)
기능: 웹 페이지 스크린샷 캡처
사용 사례: 시각적 테스트, 모니터링, 문서화
보안: 낮은 위험
예시:
You: "https://myapp.com을 스크린샷 찍어줘"
OpenClaw: "스크린샷을 screenshots/myapp.png에 저장했습니다"
메모리 도구
11. memory (메모리)
기능: 세션 간 정보 저장 및 검색
사용 사례: 환경 설정 기억, 컨텍스트 저장
보안: 낮은 위험—로컬 저장소만 해당
예시:
You: "JavaScript보다 TypeScript를 선호한다는 것을 기억해 줘"
OpenClaw: "메모리에 저장되었습니다."
[나중에]
You: "새로운 API 엔드포인트를 생성해 줘"
OpenClaw: "TypeScript 엔드포인트를 생성 중입니다..." [기억된 선호도 사용]
12. context (컨텍스트)
기능: 대화 컨텍스트 관리
사용 사례: 다단계 작업 추적, 상태 유지
보안: 낮은 위험
예시:
You: "저는 사용자 인증 기능을 작업 중입니다"
OpenClaw: "알겠습니다. 이 컨텍스트를 대화에 유지하겠습니다."
You: "비밀번호 유효성 검사를 추가해 줘"
OpenClaw: [여전히 인증 작업을 하고 있음을 인지] "인증 기능에 유효성 검사를 추가하는 중입니다..."
예약 도구
13. schedule (예약)
기능: 반복 작업 생성 (cron과 유사)
사용 사례: 일일 보고서, 모니터링, 알림
보안: 중간 위험—작업을 자동으로 실행합니다
예시:
You: "매일 아침 8시에 Hacker News를 확인하고 상위 3개 게시물을 보내줘"
OpenClaw: "예약되었습니다. 매일 아침 8시에 이 작업을 실행하겠습니다."
14. heartbeat (하트비트)
기능: 일정 간격으로 백그라운드 작업 실행
사용 사례: 모니터링, 폴링, 주기적 확인
보안: 중간 위험
예시:
You: "5분마다 https://api.myapp.com을 모니터링해 줘"
OpenClaw: "하트비트가 시작되었습니다. 5분마다 확인하겠습니다."
통신 도구
15. email (이메일)
기능: 이메일 전송
사용 사례: 알림, 보고서, 경고
보안: 중간 위험—사용자를 대신하여 이메일을 보낼 수 있습니다
예시:
You: "오늘 배포 요약을 팀에 이메일로 보내줘"
OpenClaw: "team@company.com으로 이메일을 보냈습니다"
16. slack (슬랙)
기능: 슬랙 채널에 게시
사용 사례: 팀 알림, 경고, 업데이트
보안: 중간 위험
예시:
You: "#engineering에 '배포 완료'를 게시해 줘"
OpenClaw: "#engineering에 게시했습니다"
17. discord (디스코드)
기능: 디스코드 메시지 전송
사용 사례: 커뮤니티 업데이트, 봇 상호 작용
보안: 중간 위험
예시:
You: "#general에 '10분 후 서버 점검' 메시지를 보내줘"
OpenClaw: "#general에 메시지를 보냈습니다"
통합 도구
18. github (깃허브)
기능: GitHub와 상호 작용 (저장소, PR, 이슈)
사용 사례: 코드 검토, 이슈 관리, 배포
보안: 중간 위험—저장소를 수정할 수 있습니다
예시:
You: "이슈를 생성해 줘: '모바일 로그인 버그 수정'"
OpenClaw: "myapp 저장소에 이슈 #456을 생성했습니다"
19. jira (지라)
기능: Jira 작업 관리
사용 사례: 프로젝트 관리, 작업 추적
보안: 중간 위험
예시:
You: "나에게 할당된 작업이 무엇인가요?"
OpenClaw: "3가지 작업이 있습니다:
- PROJ-123: 인증 문제 해결
- PROJ-124: 문서 업데이트
- PROJ-125: 코드 검토"
20. database (데이터베이스)
기능: 데이터베이스 쿼리 (SQL, MongoDB)
사용 사례: 데이터 분석, 보고, 디버깅
보안: 고위험—데이터를 수정할 수 있습니다
예시:
You: "오늘 가입한 사용자는 몇 명인가요?"
OpenClaw: [데이터베이스 쿼리] "오늘 신규 사용자 47명"
유틸리티 도구
21. calculator (계산기)
기능: 계산 수행
사용 사례: 수학, 변환, 추정
보안: 위험 없음
예시:
You: "1,250달러의 15%를 계산해 줘"
OpenClaw: "187.50달러"
22. date_time (날짜 시간)
기능: 날짜 및 시간 처리
사용 사례: 예약, 시간대, 계산
보안: 위험 없음
예시:
You: "도쿄는 지금 몇 시인가요?"
OpenClaw: "오전 3시 45분 JST (2026년 3월 6일)"
23. image_gen (이미지 생성)
기능: 이미지 생성 (DALL-E, Stable Diffusion)
사용 사례: 썸네일, 목업, 삽화
보안: 낮은 위험—API 크레딧 비용 발생
예시:
You: "컴퓨터를 사용하는 로봇 이미지를 생성해 줘"
OpenClaw: [이미지 생성] "images/robot.png에 저장되었습니다"
24. pdf (PDF)
기능: PDF 생성 및 읽기
사용 사례: 보고서, 문서, 송장
보안: 낮은 위험
예시:
You: "report.md를 PDF로 변환해 줘"
OpenClaw: "report.pdf를 생성했습니다"
25. zip (압축)
기능: 파일 압축 및 압축 해제
사용 사례: 백업, 파일 전송, 아카이브
보안: 낮은 위험
예시:
You: "src/ 디렉토리를 압축해 줘"
OpenClaw: "src.zip (2.3 MB)을 생성했습니다"
도구 관리
활성화된 도구 보기
You: "어떤 도구들을 활성화했나요?"
OpenClaw: "활성화된 도구:
✓ read, write, list, search
✓ web_search, web_fetch
✓ memory, context
✓ schedule, heartbeat
✗ exec (비활성화됨)
✗ database (비활성화됨)"
도구 활성화
You: "exec 도구를 활성화해 줘"
OpenClaw: "⚠️ 경고: exec은 셸 명령 실행을 허용합니다. 강력하지만 위험합니다. 확실합니까?"
You: "네"
OpenClaw: "exec 도구 활성화됨"
도구 비활성화
You: "database 도구를 비활성화해 줘"
OpenClaw: "database 도구가 비활성화되었습니다. 더 이상 데이터베이스를 쿼리할 수 없습니다."
보안 모범 사례
최소한으로 시작:
필요한 도구만 활성화하세요. 나중에 언제든지 더 추가할 수 있습니다.
고위험 도구:
exec- 모든 명령 실행 가능database- 데이터 수정 가능email- 사용자를 대신하여 이메일 발송 가능
OpenClaw를 완전히 신뢰하는 경우에만 이들을 활성화하세요.
중간 위험 도구:
write- 파일 덮어쓰기 가능github- 저장소 수정 가능slack- 메시지 게시 가능
자동화가 필요할 때 이들을 활성화하되, 사용량을 모니터링하세요.
낮은 위험 도구:
read,list,search- 읽기 전용web_search,web_fetch- 외부 읽기 전용memory- 로컬 저장소
기본적으로 활성화해도 안전합니다.
53개 이상의 커뮤니티 기술
기술은 미리 만들어진 워크플로우입니다. 커뮤니티는 일반적인 작업을 위한 53개 이상의 기술을 만들었습니다.
개발 기술
code_review (코드 검토)
기능: 코드 품질, 버그, 스타일 검토
사용 도구: read, search, web_search, github
예시:
You: "PR #42를 검토해 줘"
OpenClaw: [코드를 분석하고, 문제를 확인하며, 댓글을 게시합니다]
debug_assistant (디버그 도우미)
기능: 오류 디버그 지원
사용 도구: read, search, exec, web_search
예시:
You: "이 오류를 디버그해 줘: TypeError: Cannot read property 'name' of undefined"
OpenClaw: [코드를 분석하고, 수정 사항을 제안합니다]
test_generator (테스트 생성기)
기능: 단위 테스트 생성
사용 도구: read, write, exec
예시:
You: "src/api/users.js에 대한 테스트를 생성해 줘"
OpenClaw: [포괄적인 테스트를 포함하는 테스트 파일을 생성합니다]
refactor_assistant (리팩터링 도우미)
기능: 코드 개선 사항 제안
사용 도구: read, write, search
예시:
You: "src/utils/helpers.js를 리팩터링해 줘"
OpenClaw: [개선 사항을 제안하고, 변경 사항을 적용합니다]
생산성 기술
meeting_summary (회의 요약)
기능: 회의를 요약하고 실행 항목 추출
사용 도구: memory, context
예시:
You: [회의록 전달]
OpenClaw: [실행 항목이 포함된 구조화된 요약을 생성합니다]
task_manager (작업 관리자)
기능: 여러 도구(Jira, Asana, Trello)에 걸쳐 작업 관리
사용 도구: jira, memory, schedule
예시:
You: "이번 주에 제가 할 일은 무엇인가요?"
OpenClaw: [연결된 모든 도구의 작업을 나열합니다]
email_assistant (이메일 도우미)
기능: 이메일 초안 작성 및 전송
사용 도구: email, memory
예시:
You: "내일 배포에 대한 이메일 초안을 팀에 보내줘"
OpenClaw: [전문적인 이메일을 생성합니다]
콘텐츠 기술
blog_writer (블로그 작성기)
기능: 블로그 게시물 작성
사용 도구: web_search, write, memory
예시:
You: "OpenClaw 사용 사례에 대한 블로그 게시물을 작성해 줘"
OpenClaw: [주제를 연구하고, 포괄적인 게시물을 작성합니다]
social_media_manager (소셜 미디어 관리자)
기능: 소셜 미디어 콘텐츠 생성
사용 도구: web_search, memory, slack
예시:
You: "새로운 기능에 대한 트위터 스레드를 만들어줘"
OpenClaw: [매력적인 스레드를 생성합니다]
video_script_writer (비디오 스크립트 작성기)
기능: 비디오 스크립트 작성
사용 도구: web_search, write, memory
예시:
You: "OpenClaw 설정에 대한 10분짜리 YouTube 스크립트를 작성해 줘"
OpenClaw: [구조화된 스크립트를 생성합니다]
모니터링 기술
api_monitor (API 모니터)
기능: API 상태 모니터링
사용 도구: web_fetch, heartbeat, slack
예시:
You: "https://api.myapp.com을 모니터링해 줘"
OpenClaw: [5분마다 API를 확인하고, 문제 발생 시 경고합니다]
error_tracker (오류 추적기)
기능: 오류 추적 및 분석
사용 도구: read, search, memory, slack
예시:
You: "오류 로그를 모니터링하고 새로운 오류가 발생하면 알려줘"
OpenClaw: [로그를 감시하고, 경고를 보냅니다]
deployment_watcher (배포 감시자)
기능: 배포 모니터링
사용 도구: github, exec, slack
예시:
You: "새로운 배포를 감시하고 스모크 테스트를 실행해 줘"
OpenClaw: [모니터링, 테스트, 보고합니다]
기술 설치
사용 가능한 기술 찾아보기
You: "사용 가능한 기술을 나열해 줘"
OpenClaw: "사용 가능한 기술:
**개발:**
- code_review
- debug_assistant
- test_generator
- refactor_assistant
**생산성:**
- meeting_summary
- task_manager
- email_assistant
**콘텐츠:**
- blog_writer
- social_media_manager
- video_script_writer
**모니터링:**
- api_monitor
- error_tracker
- deployment_watcher
'install skill [이름]'을 사용하여 기술을 추가하세요."
기술 설치
You: "code_review 기술을 설치해 줘"
OpenClaw: "code_review 기술을 설치 중...
필요한 도구:
✓ read (활성화됨)
✓ search (활성화됨)
✓ web_search (활성화됨)
✗ github (활성화되지 않음)
github 도구를 활성화하시겠습니까? (y/n)"
You: "y"
OpenClaw: "github 도구 활성화됨
✓ code_review 기술 설치 완료
사용해 보세요: 'PR #42를 검토해 줘'"
기술 제거
You: "blog_writer 기술을 제거해 줘"
OpenClaw: "blog_writer 기술이 제거되었습니다"
사용자 정의 기술 생성
기술은 워크플로우를 정의하는 YAML 파일입니다. 직접 만들 수 있습니다.
기술 구조
name: daily_standup
description: 일일 스탠드업 보고서를 생성합니다
tools:
- jira
- github
- slack
steps:
- action: query_jira
query: "assignee = currentUser() AND status = 'In Progress'"
- action: query_github
query: "author:me is:pr is:open"
- action: format_report
template: |
일일 스탠드업 보고서
**어제:**
{completed_tasks}
**오늘:**
{in_progress_tasks}
**방해 요인:**
{blockers}
- action: post_slack
channel: "#standup"
message: "{report}"
예시: 사용자 정의 백업 기술
name: backup_project
description: 프로젝트 파일을 클라우드 저장소에 백업합니다
tools:
- zip
- exec
steps:
- action: create_zip
source: "."
output: "backup-{date}.zip"
exclude:
- node_modules
- .git
- action: upload
command: "aws s3 cp backup-{date}.zip s3://my-backups/"
- action: notify
message: "✓ 백업 완료: backup-{date}.zip"
사용자 정의 기술 설치
# 기술을 ~/.openclaw/skills/backup_project.yaml에 저장
openclaw skill install ~/.openclaw/skills/backup_project.yaml
사용법:
You: "backup_project 기술을 실행해 줘"
OpenClaw: [백업 워크플로우 실행]
기술 조합
강력한 워크플로우를 위해 기술을 조합하세요.
예시: 자동화된 코드 검토 + 배포
You: "PR이 main에 병합되면, 코드를 검토하고, 테스트를 실행한 다음, 스테이징에 배포해 줘"
OpenClaw: "워크플로우 생성됨:
1. GitHub에서 main으로의 병합 모니터링
2. code_review 기술 실행
3. test_generator 기술 실행
4. 테스트 통과 시 deployment_watcher 기술 실행
5. #engineering 슬랙에 결과 게시
워크플로우 활성화됨."
예시: 콘텐츠 파이프라인
You: "매주 월요일 오전 9시에 인기 있는 AI 주제를 연구하고, 블로그 게시물을 작성하고, 트위터 스레드를 만들어줘"
OpenClaw: "워크플로우 생성됨:
1. 예약: 월요일 오전 9시
2. trend_monitor 기술 실행
3. blog_writer 기술 실행
4. social_media_manager 기술 실행
5. 승인을 위해 초안 발송
워크플로우 예약됨."
문제 해결
기술 설치 실패
오류: "필요한 도구 없음"
해결책: 먼저 필요한 도구를 활성화하세요:
You: "github, slack 도구를 활성화해 줘"
OpenClaw: "github 및 slack 활성화됨"
You: "code_review 기술을 설치해 줘"
OpenClaw: "✓ code_review 설치 완료"
기술이 예상대로 작동하지 않음
오류: "기술 실행 실패"
해결책: 기술 로그를 확인하세요:
You: "code_review 기술의 로그를 보여줘"
OpenClaw: [상세 실행 로그를 보여줍니다]
도구 권한 거부
오류: "권한 거부: exec 도구"
해결책: 도구를 활성화하세요:
You: "exec 도구를 활성화해 줘"
OpenClaw: "exec 도구 활성화됨"
모범 사례
1. 안전한 도구부터 시작
읽기 전용 도구부터 활성화하세요:
- read, list, search
- web_search, web_fetch
- memory
실행 도구(exec, write)는 필요할 때만 추가하세요.
2. 기술을 점진적으로 설치
53가지 기술을 한 번에 모두 설치하지 마세요. 즉각적인 문제를 해결하는 2~3가지부터 시작하세요.
3. 기술 코드 검토
커뮤니티 기술을 설치하기 전에 YAML 파일을 검토하여 어떤 작업을 수행하는지 이해하세요.
4. 사용량 모니터링
OpenClaw가 어떤 도구와 기술을 사용하는지 확인하세요:
You: "도구 사용 통계를 보여줘"
OpenClaw: "도구 사용량 (지난 7일):
- read: 342회
- web_search: 89회
- write: 45회
- exec: 12회"
5. 기술 별칭 생성
일반적인 명령을 단축하세요:
You: "'code_review 기술 실행'에 대한 별칭 'review'를 만들어줘"
OpenClaw: "별칭이 생성되었습니다. 'review'를 사용하여 code_review를 실행하세요."
자주 묻는 질문 (FAQ)
Q: 모든 도구를 비활성화할 수 있나요?
A: 네, 하지만 OpenClaw는 많은 것을 할 수 없을 것입니다. 작동하려면 최소한 메모리와 컨텍스트가 필요합니다.
Q: 기술은 안전한가요?
A: 커뮤니티 기술은 검토되지만, 설치하기 전에 항상 코드를 확인하세요. 악성 기술은 도구를 오용할 수 있습니다.
Q: 기존 기술을 수정할 수 있나요?
A: 네, 기술 YAML 파일을 ~/.openclaw/skills/로 복사하여 편집할 수 있습니다.
Q: 몇 개의 기술을 설치할 수 있나요?
A: 제한은 없지만, 너무 많은 기술은 OpenClaw의 속도를 저하시킬 수 있습니다. 사용하는 것만 설치하세요.
Q: 기술에 비용이 드나요?
A: 기술은 무료이지만, 비용이 드는 도구(예: image_gen은 API 크레딧 사용)를 사용할 수 있습니다.
Q: 사용자 정의 기술을 공유할 수 있나요?
A: 네, GitHub의 OpenClaw 커뮤니티 저장소에 게시할 수 있습니다.
Q: 기술이 작동하지 않으면 어떻게 해야 하나요?
A: 제거하고 기술 작성자에게 문제를 보고하세요.
Q: 기술이 내 파일에 액세스할 수 있나요?
A: read 또는 write 도구를 활성화한 경우에만 가능합니다. 기술은 도구 권한을 우회할 수 없습니다.
결론
도구는 OpenClaw에 기능을 제공합니다. 기술은 OpenClaw에 워크플로우를 가르칩니다. 이 둘은 함께 OpenClaw를 챗봇에서 자동화 강자로 변화시킵니다.
안전한 도구(read, web_search, memory)부터 시작하세요. 실제 문제를 해결하는 몇 가지 기술(code_review, meeting_summary)을 설치하세요. 자신감이 생기면 더 강력한 도구(exec, database)를 활성화하고 사용자 정의 기술을 만드세요.
25가지 도구와 53개 이상의 기술은 시작에 불과합니다. OpenClaw 커뮤니티는 매일 새로운 기능을 추가하고 있습니다. 에코시스템에 참여하고, 사용자 정의 기술을 공유하며, AI 자동화의 미래를 함께 만들어가세요.