차이

문서의 선택한 두 판 사이의 차이를 보여줍니다.

--- ai:assistant_ops_available_tools [2026-04-09 12:08] – 사용가능한 도구 문서를 쉬운 설명으로 보강 [기존 위키에서 이전] 172.19.176.1
+++ ai:assistant_ops_available_tools [2026-10-30 14:55] (현재) – 바깥 편집 127.0.0.1
@@ 줄 1: / 줄 1: @@
 ====== 사용가능한 도구 ======
-이 페이지는 비서가 어떤 도구를 써서 일을 도와줄 수 있는지 아주 쉽게 설명하는 안내서입니다.
+이 문서는 비서가 실제 업무에서 활용할 수 있는 도구와 사용 범위를 정리한 운영 안내서입니다.
+비서는 단순 응답형 챗봇이 아니라, 파일 확인, 문서 수정, 검색, 메시지 전송, 자동화 실행, Google Workspace 연동 등 다양한 작업을 도구를 통해 수행할 수 있습니다.
-비서를 사람처럼 생각하면, 도구는 비서의 ''손'', ''눈'', ''메모장'', ''인터넷 검색창'' 같은 것입니다.
+===== 기본 원칙 =====
-즉, 비서는 말만 하는 존재가 아니라, 실제로 여러 도구를 써서 확인하고 정리하고 기록할 수 있습니다.
+  * 비서는 추측보다 ''실제 확인''을 우선합니다.
+  * 가능한 경우 도구를 사용해 근거를 확인한 뒤 답변합니다.
+  * 도구마다 역할과 강점이 다르므로 작업 목적에 맞게 선택해서 사용합니다.
+  * 외부 전송, 삭제, 되돌리기 어려운 변경은 신중하게 다룹니다.
-===== 먼저 이해하면 좋은 점 =====
+===== 1. OpenClaw 기본 도구 =====
-  * 비서는 ''아는 척만 하는 것''보다, 실제 도구로 확인해서 답하는 것을 우선합니다.
+아래 도구들은 비서가 기본적으로 사용할 수 있는 핵심 도구입니다.
-  * 어떤 도구는 ''읽기''를 잘하고,
-  * 어떤 도구는 ''쓰기''를 잘하고,
-  * 어떤 도구는 ''검색''을 잘하고,
-  * 어떤 도구는 ''다른 사람에게 보내기''를 잘합니다.
-  * 하지만 아무 일이나 마음대로 하는 것은 아닙니다.
-  * 특히 ''삭제'', ''외부 전송'', ''되돌리기 어려운 작업''은 조심해서 다룹니다.
-===== 1. 파일 읽기 도구 =====
+==== 1-1. 파일 읽기 ====
-이 도구는 컴퓨터 안에 있는 글 파일을 읽는 데 사용합니다.
+도구 명칭: ''read''
-쉽게 말하면:
+용도:
-  * 서랍 속 문서를 꺼내서 읽는 손과 같습니다.
-  * 메모장, 설정 파일, 안내문, 기록 파일 등을 볼 수 있습니다.
-할 수 있는 일:
   * 문서 내용 확인
   * 설정 파일 점검
-  * 메모 읽기
+  * 업무 메모 및 기록 확인
-  * 오늘 작업 기록 확인
+  * 운영 문서, 가이드, 로그 확인
-  * 필요한 정보가 어디에 적혀 있는지 찾기
-예시:
+활용 예시:
-  * ''SOUL.md'' 같은 성격 문서 읽기
+  * AGENTS.md, USER.md, MEMORY.md 같은 운영 문서 확인
-  * ''USER.md'' 같은 사용자 정보 문서 읽기
+  * 저장된 보고서나 메모 파일 읽기
-  * ''MEMORY.md'' 같은 장기 기억 문서 읽기
-  * 업무용 텍스트 파일 내용 확인
-어린이식 비유:
+==== 1-2. 파일 쓰기 ====
-  * 책장에 있는 책을 꺼내서 읽는 것과 비슷합니다.
+도구 명칭: ''write''
-===== 2. 파일 쓰기 도구 =====
+용도:
-이 도구는 새 문서를 만들거나, 문서 내용을 통째로 새로 써 넣을 때 사용합니다.
+  * 새 문서 작성
+  * 결과 파일 저장
+  * 초안 문서 생성
+  * 정리본 작성
-쉽게 말하면:
+활용 예시:
-  * 빈 공책에 새 글을 쓰는 도구입니다.
+  * 새 운영 문서 작성
-  * 또는 오래된 종이를 새 종이로 갈아끼우는 것과 비슷합니다.
+  * 분석 결과를 파일로 저장
-할 수 있는 일:
+주의사항:
-  * 새 문서 만들기
+  * 기존 내용을 전체 덮어쓸 수 있으므로 범위를 명확히 확인해야 합니다.
-  * 정리 문서 작성
-  * 초안 작성
-  * 결과 저장
-  * 기록 파일 만들기
-예시:
+==== 1-3. 파일 수정 ====
-  * 새 가이드 문서 만들기
+도구 명칭: ''edit''
-  * 작업 결과를 텍스트 파일로 저장하기
-  * 보고용 초안 문서 만들기
-주의할 점:
+용도:
-  * 기존 내용을 통째로 덮어쓸 수 있으므로 조심해서 사용해야 합니다.
+  * 특정 문장 수정
+  * 링크 추가
+  * 문단 교체
+  * 오타 및 표현 정리
-===== 3. 파일 수정 도구 =====
+활용 예시:
-이 도구는 이미 있는 문서의 일부만 정확하게 고칠 때 사용합니다.
+  * 위키 문서 하단에 새 항목 추가
+  * 기존 설명 문구만 부분 수정
-쉽게 말하면:
+==== 1-4. 명령 실행 ====
-  * 공책 전체를 다시 쓰는 것이 아니라,
+도구 명칭: ''exec''
-  * 틀린 문장 한 줄만 지우고 바르게 고쳐 쓰는 것입니다.
-할 수 있는 일:
+용도:
-  * 문장 일부 수정
+  * 시스템 상태 확인
-  * 링크 추가
+  * 파일/폴더 조회
-  * 오타 수정
+  * 위키 원문 가져오기
-  * 특정 문단 바꾸기
+  * 스크립트 실행
+  * 간단한 자동화 처리
-예시:
+활용 예시:
-  * 문서 맨 아래에 새 항목 추가
+  * 파이썬 스크립트 실행
-  * 잘못된 단어를 올바른 단어로 고치기
+  * 시스템 점검 명령 수행
-  * 제목이나 설명 문구만 바꾸기
+  * 위키 페이지 원문 조회
-어린이식 비유:
+주의사항:
-  * 문제집에서 틀린 답만 지우개로 지우고 다시 쓰는 것과 같습니다.
+  * 강력한 도구이므로 파급효과가 있는 명령은 신중하게 다뤄야 합니다.
-===== 4. 명령 실행 도구 =====
+==== 1-5. 실행 작업 관리 ====
-이 도구는 컴퓨터에게 직접 일을 시키는 도구입니다.
+도구 명칭: ''process''
-쉽게 말하면:
+용도:
-  * "컴퓨터야, 이 일 해줘" 하고 말하는 버튼입니다.
+  * 실행 상태 확인
-  * 조금 더 강한 도구라서, 확인이나 조회, 자동화 작업에 많이 씁니다.
+  * 중간 로그 조회
+  * 작업 종료
+  * 추가 입력 전달
-할 수 있는 일:
+활용 예시:
-  * 프로그램 실행
+  * 오래 걸리는 백그라운드 작업 진행 상황 확인
-  * 서버 상태 확인
-  * 위키 내용 가져오기
-  * 목록 조회
-  * 데이터 확인
-  * 자동화 스크립트 실행
-예시:
+==== 1-6. 웹 검색 ====
-  * 위키 페이지 원문 불러오기
+도구 명칭: ''web_search''
-  * 시스템 상태 확인하기
-  * 폴더 안 파일 목록 확인하기
-  * 간단한 파이썬 스크립트 실행하기
-주의할 점:
+용도:
-  * 강력한 도구이므로 위험한 명령은 함부로 쓰면 안 됩니다.
+  * 최신 정보 검색
-  * 삭제나 외부 변경이 들어가는 일은 특히 더 조심해야 합니다.
+  * 기사, 블로그, 문서 탐색
+  * 공식 사이트 및 참고 자료 확인
-===== 5. 실행 중인 작업 관리 도구 =====
+활용 예시:
-어떤 일은 한 번에 바로 끝나지 않습니다.
+  * 특정 서비스의 최신 변경사항 확인
-이 도구는 오래 걸리는 작업이 지금 어디까지 되었는지 살펴보는 데 사용합니다.
+  * 공식 문서나 보도자료 탐색
-쉽게 말하면:
+==== 1-7. 웹페이지 읽기 ====
-  * 요리가 아직 끓는 중인지 뚜껑 열어보는 것과 비슷합니다.
+도구 명칭: ''web_fetch''
-할 수 있는 일:
+용도:
-  * 작업이 끝났는지 확인
+  * 기사 본문 확인
-  * 중간 로그 보기
+  * 안내 페이지 요약
-  * 멈추기
+  * 문서 내용 추출
-  * 입력 더 보내기
+  * 검색 결과 후속 확인
-예시:
+활용 예시:
-  * 오래 걸리는 검색 작업 상태 확인
+  * 검색 결과로 찾은 문서의 실제 본문 검토
-  * 백그라운드 실행 중인 프로그램 진행 상황 확인
-===== 6. 웹 검색 도구 =====
+==== 1-8. 브라우저 ====
-이 도구는 인터넷에서 정보를 찾을 때 사용합니다.
+도구 명칭: ''browser''
-쉽게 말하면:
+용도:
-  * 검색창에 궁금한 것을 입력해서 자료를 찾는 것입니다.
+  * 웹페이지 열기
+  * 화면 상태 확인
+  * 버튼 클릭
+  * 입력칸 작성
+  * 스크린샷 확보
-할 수 있는 일:
+활용 예시:
-  * 최신 정보 찾기
+  * 웹 UI 구조 확인
-  * 기사, 블로그, 문서 찾기
+  * 로그인된 브라우저 화면 점검
-  * 공식 사이트 찾기
-  * 여러 결과 비교하기
-예시:
+==== 1-9. 캔버스 ====
-  * "오늘 날씨" 검색
+도구 명칭: ''canvas''
-  * "어떤 프로그램 사용법" 검색
-  * 공식 문서나 뉴스 찾기
-주의할 점:
+용도:
-  * 인터넷의 모든 정보가 다 맞는 것은 아니므로,
+  * 화면 표시
-  * 가능하면 믿을 만한 출처를 우선 확인합니다.
+  * 화면 내용 확인
+  * 시각적 상태 점검
-===== 7. 웹페이지 읽기 도구 =====
+==== 1-10. 메시지 전송 ====
-이 도구는 웹사이트에 들어가서 글 내용을 가져오는 도구입니다.
+도구 명칭: ''message''
-쉽게 말하면:
+용도:
-  * 인터넷 책 한 페이지를 펼쳐서 글만 쏙 읽어오는 것입니다.
+  * 작업 결과 보고
+  * 안내 메시지 전송
+  * 이모지 반응 남기기
+  * 알림 발송
-할 수 있는 일:
+활용 예시:
-  * 기사 본문 읽기
+  * 채팅방에 완료 보고 전송
-  * 안내 페이지 요약
+  * 특정 메시지에 반응 추가
-  * 문서 내용 확인
-  * 검색 결과에서 찾은 페이지 본문 확인
-예시:
+주의사항:
-  * 공지사항 페이지 내용 읽기
+  * 외부로 나가는 행동이므로 사용자를 대신한 의사 표현에는 주의가 필요합니다.
-  * 제품 설명 페이지 핵심 정리
-  * 사용법 문서 가져오기
-===== 8. 브라우저 도구 =====
+==== 1-11. 음성 변환 ====
-이 도구는 사람이 웹브라우저를 직접 쓰는 것처럼 웹페이지를 열고 살펴보는 도구입니다.
+도구 명칭: ''tts''
-쉽게 말하면:
+용도:
-  * 눈으로 화면을 보고 버튼도 누를 수 있는 도구입니다.
+  * 텍스트를 음성으로 변환
+  * 듣기용 안내 생성
-할 수 있는 일:
+==== 1-12. 기억 검색 ====
-  * 웹페이지 열기
+도구 명칭: ''memory_search'', ''memory_get''
-  * 화면 확인
-  * 특정 버튼 누르기
-  * 입력칸에 글 넣기
-  * 스크린샷 찍기
-예시:
+용도:
-  * 로그인된 브라우저 화면 확인
+  * 이전 결정사항 확인
-  * 웹사이트 구조 확인
+  * 사용자 선호 복기
-  * 버튼이나 메뉴 위치 찾기
+  * 과거 작업 맥락 확인
-주의할 점:
+활용 예시:
-  * 로그인이나 민감한 정보가 걸린 작업은 더 신중해야 합니다.
+  * 예전에 정리해둔 기준이나 메모 다시 확인
-===== 9. 메시지 보내기 도구 =====
+==== 1-13. 세션 / 보조 에이전트 관리 ====
-이 도구는 사람이나 채팅방에 메시지를 보내는 데 사용합니다.
+도구 명칭: ''sessions_spawn'', ''sessions_send'', ''sessions_list'', ''sessions_history'', ''sessions_yield'', ''subagents'', ''agents_list''
-쉽게 말하면:
+용도:
-  * 편지를 보내거나 메신저로 말을 전하는 기능입니다.
+  * 보조 세션 생성
+  * 별도 작업 위임
+  * 진행 상태 확인
+  * 필요 시 종료 또는 제어
-할 수 있는 일:
+활용 예시:
-  * 채팅 메시지 보내기
+  * 긴 조사 작업을 별도 세션에 맡기기
-  * 반응(이모지) 남기기
+  * 코딩 또는 분석 작업을 분리 실행
-  * 필요한 경우 알림 보내기
-예시:
+==== 1-14. 상태 확인 ====
-  * 작업 완료 보고 보내기
+도구 명칭: ''session_status''
-  * 다른 대화방에 안내 메시지 보내기
-  * 메시지에 반응 달기
-중요한 점:
+용도:
-  * 밖으로 나가는 행동이므로 조심해야 합니다.
+  * 현재 시간 확인
-  * 사용자를 대신해 말하는 상황에서는 특히 더 신중해야 합니다.
+  * 세션 상태 확인
+  * 모델 및 실행 환경 점검
-===== 10. 기억 찾기 도구 =====
+===== 2. TOOLS.md 기반 추가 도구 =====
-비서는 매 순간 모든 것을 머릿속에 완벽히 들고 있는 것이 아닙니다.
+비서는 OpenClaw 기본 도구 외에도 TOOLS.md에 정리된 외부 도구와 작업 방식을 활용할 수 있습니다.
-그래서 기록된 기억을 다시 찾는 도구가 있습니다.
-쉽게 말하면:
+==== 2-1. Google Workspace CLI ====
-  * 예전에 써둔 일기장이나 메모장을 다시 뒤지는 것입니다.
+도구 명칭: ''gog'' 또는 ''gogcli''
-할 수 있는 일:
+설명:
-  * 예전에 정리한 사실 찾기
+  * Google Workspace 작업을 명령줄에서 처리하는 도구입니다.
-  * 이전 결정사항 확인
+  * Gmail, Calendar, Drive, Chat, Docs, Sheets 등을 다룰 수 있습니다.
-  * 사용자 선호 확인
-  * 지난 작업 맥락 확인
-예시:
+주요 기능:
-  * "전에 뭘 하기로 했지?" 확인
+  * Google Drive 파일 검색, 다운로드, 업로드, 공유
-  * 사용자가 선호하는 말투 찾기
+  * Gmail 검색, 메일 발송, 스레드 조회
-  * 지난번 남긴 메모 확인
+  * Google Calendar 일정 조회, 생성, 응답
+  * Google Chat DM 및 스페이스 메시지 전송
+  * Google Docs 내용 읽기 및 내보내기
+  * Google Sheets 조회, 추가, 수정, 내보내기
-===== 11. 다른 보조 세션/에이전트 도구 =====
+활용 예시:
-어떤 일은 한 번에 혼자 하기보다, 보조 작업창을 따로 열어 맡기는 편이 더 좋을 때가 있습니다.
+  * 공유 드라이브에서 파일 찾아서 PDF로 내보내기
+  * 안 읽은 메일 확인
+  * 캘린더 일정 생성
+  * 스프레드시트 데이터 읽기 및 업데이트
-쉽게 말하면:
+주의사항:
-  * 큰 숙제를 할 때 작은 팀을 나눠서 맡기는 것과 비슷합니다.
+  * 인증이 필요한 도구이며, 에이전트별 설정 분리가 중요합니다.
+  * TOOLS.md에 적힌 환경변수와 인증 절차를 따라야 합니다.
-할 수 있는 일:
+==== 2-2. MySQL 조회 ====
-  * 보조 작업 세션 만들기
+도구 명칭: ''mysql''
-  * 다른 세션에 질문 보내기
-  * 진행 상황 확인
-  * 필요하면 중지하기
-예시:
+설명:
-  * 긴 조사 작업을 따로 맡기기
+  * 회사 내부 sales 데이터베이스를 조회할 때 사용하는 도구입니다.
-  * 코딩 작업을 별도 세션에서 돌리기
-  * 복잡한 분석을 분리해서 진행하기
-===== 12. 음성 읽기 도구 =====
+주요 기능:
-이 도구는 글을 소리로 읽어주는 기능입니다.
+  * 테이블 조회
+  * 조건 검색
+  * 집계 조회
+  * CSV 추출
-쉽게 말하면:
+중요 원칙:
-  * 글자를 목소리로 바꿔주는 스피커입니다.
+  * 읽기 전용으로 사용합니다.
+  * INSERT, UPDATE, DELETE, DROP, ALTER, TRUNCATE 같은 변경 작업은 수행하지 않습니다.
+  * 쿼리 작성 전에는 반드시 스키마 문서를 확인합니다.
-할 수 있는 일:
+==== 2-3. Python 스크립트 ====
-  * 안내문 음성으로 만들기
+도구 명칭: ''python3''
-  * 짧은 메시지를 소리로 전달하기
-  * 듣기 쉽게 읽어주기
-예시:
+설명:
-  * 간단한 알림을 음성으로 보내기
+  * 데이터 정리, 자동화, 간단한 프로그램 제작에 활용합니다.
-  * 이야기나 설명을 소리로 들려주기
-===== 13. 캔버스 도구 =====
+주요 활용:
-이 도구는 화면이나 작은 앱 같은 것을 띄워서 보여주는 데 쓰입니다.
+  * 텍스트/CSV/엑셀 처리
+  * API 호출
+  * 자동화 스크립트 작성
+  * 데이터 변환 및 가공
-쉽게 말하면:
+관련 라이브러리 예시:
-  * 칠판이나 전광판에 내용을 띄우는 것과 비슷합니다.
+  * ''pandas'' : 표 데이터 처리
+  * ''requests'' : 웹/API 요청
+  * ''bs4 (BeautifulSoup)'' : HTML 분석
+  * ''playwright'' : 브라우저 자동화
-할 수 있는 일:
+==== 2-4. 웹 스크래핑 ====
-  * 화면 띄우기
+관련 도구 명칭: ''requests'', ''BeautifulSoup'', ''playwright''
-  * 화면 안 내용 확인
-  * 화면 속 정보 읽기
-===== 14. 상태 확인 도구 =====
+설명:
-이 도구는 지금 세션 상태나 시간 같은 정보를 확인할 때 사용합니다.
+  * 웹페이지 구조를 분석하고 필요한 데이터를 추출할 때 사용합니다.
-쉽게 말하면:
+주요 기능:
-  * 시계와 상태판을 보는 것입니다.
+  * HTML 구조 분석
+  * 반복 데이터 추출
+  * CSV 저장
+  * JS 렌더링 페이지 수집
-할 수 있는 일:
+주의사항:
-  * 현재 시간 확인
+  * 고정 선택자를 무조건 신뢰하지 않고 매번 구조를 확인합니다.
-  * 세션 상태 확인
+  * 과도한 요청은 피하고, robots.txt 및 정책을 고려합니다.
-  * 사용 중인 모델이나 설정 확인
-===== 비서가 특히 잘하는 일 =====
+==== 2-5. 인스타그램 수집 ====
-위 도구들을 합치면 비서는 아래 같은 일을 잘할 수 있습니다.
+도구 명칭: ''instagrapi''
-  * 문서 읽고 정리하기
+설명:
-  * 위키 수정하기
+  * 인스타그램 게시물, 댓글, 계정 게시물 등을 수집할 때 활용할 수 있는 Python 기반 도구입니다.
-  * 새 안내문 만들기
-  * 인터넷 조사하기
-  * 파일 찾아보기
-  * 기록 남기기
-  * 여러 자료를 한 번에 모아 요약하기
-  * 정해진 형식으로 내용을 정리하기
-===== 비서가 조심해야 하는 일 =====
+주요 기능:
-비서가 도구를 쓸 수 있다고 해서, 아무 행동이나 다 바로 하는 것은 아닙니다.
+  * 게시물 댓글 수집
+  * 특정 계정 게시물 수집
+  * 해시태그 게시물 수집
+주의사항:
+  * 과도한 수집은 계정 제한 위험이 있으므로 속도와 양을 조절해야 합니다.
+===== 3. 비서가 주로 잘하는 작업 =====
+위 도구들을 조합하면 비서는 아래와 같은 업무를 안정적으로 지원할 수 있습니다.
+  * 문서 읽기 및 정리
+  * 위키 수정 및 초안 작성
+  * 인터넷 조사 및 자료 수집
+  * Google Workspace 문서/메일/시트 처리
+  * 파일 확인 및 기록 관리
+  * 운영 문서 업데이트
+  * 여러 자료를 기반으로 한 요약 정리
+  * 반복 작업의 부분 자동화
+  * 데이터 조회 및 정리
+===== 4. 운영상 주의할 작업 =====
+도구를 사용할 수 있다고 해서 모든 작업을 즉시 수행하는 것은 아닙니다.
+특히 아래 유형은 더 신중하게 판단해야 합니다.
-특히 아래는 조심합니다.
   * 파일 삭제
-  * 외부 사람에게 메시지 보내기
+  * 외부인 대상 메시지 발송
-  * 사용자 대신 공식 입장처럼 말하기
+  * 사용자를 대신한 공식적 표현
-  * 민감한 정보 다루기
+  * 민감 정보 처리
+  * 데이터 변경 작업
   * 되돌리기 어려운 변경
-===== 한 줄 요약 =====
+===== 5. 요약 =====
-비서는
+비서는 ''read'', ''write'', ''edit'', ''exec'' 같은 기본 도구와,
-  * ''읽는 도구''로 확인하고,
+''gog'', ''mysql'', ''python3'' 같은 외부 도구를 상황에 맞게 활용할 수 있습니다.
-  * ''쓰는 도구''로 기록하고,
+따라서 단순 응답형 비서가 아니라, 실제 운영 업무를 보조하는 실행형 디지털 비서로 이해하면 됩니다.
-  * ''검색 도구''로 찾고,
-  * ''실행 도구''로 실제 일을 처리하고,
-  * ''기억 도구''로 예전 맥락을 다시 꺼내며,
-  * ''메시지 도구''로 결과를 알려줄 수 있습니다.
-즉, 비서는 단순히 대답만 하는 존재가 아니라,
-''도구를 써서 실제로 일하는 디지털 비서''입니다.