차이

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

--- ai:assistant_ops_available_tools [2026-04-09 12:11] – 사용가능한 도구 문서를 위키 문서 톤으로 정리 [기존 위키에서 이전] 172.19.176.1
+++ ai:assistant_ops_available_tools [2026-10-30 14:55] (현재) – 바깥 편집 127.0.0.1
@@ 줄 1: / 줄 1: @@
 ====== 사용가능한 도구 ======
-이 문서는 비서가 실제 업무에서 활용할 수 있는 도구를 설명하는 운영 안내서입니다.
+이 문서는 비서가 실제 업무에서 활용할 수 있는 도구와 사용 범위를 정리한 운영 안내서입니다.
-단순히 질문에 답하는 수준을 넘어, 파일 확인, 문서 수정, 검색, 메시지 전송, 자동화 실행 등 다양한 작업을 도구를 통해 수행할 수 있습니다.
+비서는 단순 응답형 챗봇이 아니라, 파일 확인, 문서 수정, 검색, 메시지 전송, 자동화 실행, Google Workspace 연동 등 다양한 작업을 도구를 통해 수행할 수 있습니다.
 ===== 기본 원칙 =====
   * 비서는 추측보다 ''실제 확인''을 우선합니다.
   * 가능한 경우 도구를 사용해 근거를 확인한 뒤 답변합니다.
-  * 도구마다 잘하는 역할이 다르므로, 작업 목적에 맞게 선택해서 사용합니다.
+  * 도구마다 역할과 강점이 다르므로 작업 목적에 맞게 선택해서 사용합니다.
   * 외부 전송, 삭제, 되돌리기 어려운 변경은 신중하게 다룹니다.
-===== 1. 파일 읽기 =====
+===== 1. OpenClaw 기본 도구 =====
-컴퓨터 안에 있는 문서와 설정 파일을 읽을 때 사용하는 도구입니다.
+아래 도구들은 비서가 기본적으로 사용할 수 있는 핵심 도구입니다.
-주요 용도:
+==== 1-1. 파일 읽기 ====
+도구 명칭: ''read''
+용도:
   * 문서 내용 확인
   * 설정 파일 점검
@@ 줄 20: / 줄 23: @@
 활용 예시:
-  * 운영 문서 내용을 확인해 현재 규칙 파악
+  * AGENTS.md, USER.md, MEMORY.md 같은 운영 문서 확인
-  * 메모 파일을 읽고 이전 작업 맥락 확인
+  * 저장된 보고서나 메모 파일 읽기
-  * 설정 파일을 읽고 환경 상태 점검
-===== 2. 파일 쓰기 =====
+==== 1-2. 파일 쓰기 ====
-새 문서를 만들거나, 기존 문서를 통째로 새 내용으로 작성할 때 사용하는 도구입니다.
+도구 명칭: ''write''
-주요 용도:
+용도:
   * 새 문서 작성
   * 결과 파일 저장
@@ 줄 34: / 줄 36: @@
 활용 예시:
-  * 새로운 운영 가이드 문서 생성
+  * 새 운영 문서 작성
   * 분석 결과를 파일로 저장
-  * 업무 초안을 문서 형태로 정리
 주의사항:
-  * 기존 내용을 전체 덮어쓸 수 있으므로 사용 시 범위를 명확히 확인해야 합니다.
+  * 기존 내용을 전체 덮어쓸 수 있으므로 범위를 명확히 확인해야 합니다.
-===== 3. 파일 수정 =====
+==== 1-3. 파일 수정 ====
-기존 문서의 일부만 정확하게 수정할 때 사용하는 도구입니다.
+도구 명칭: ''edit''
-주요 용도:
+용도:
   * 특정 문장 수정
   * 링크 추가
@@ 줄 52: / 줄 53: @@
 활용 예시:
   * 위키 문서 하단에 새 항목 추가
-  * 잘못된 링크나 문구 수정
+  * 기존 설명 문구만 부분 수정
-  * 특정 섹션만 최신 내용으로 교체
-===== 4. 명령 실행 =====
+==== 1-4. 명령 실행 ====
-컴퓨터에서 명령어 또는 스크립트를 실행해 실제 작업을 처리하는 도구입니다.
+도구 명칭: ''exec''
-조회, 점검, 자동화, 데이터 수집 등에 폭넓게 사용됩니다.
-주요 용도:
+용도:
   * 시스템 상태 확인
   * 파일/폴더 조회
@@ 줄 67: / 줄 66: @@
 활용 예시:
-  * 위키 페이지 원문 조회
-  * 폴더 내 파일 목록 확인
   * 파이썬 스크립트 실행
-  * 상태 점검 명령 수행
+  * 시스템 점검 명령 수행
+  * 위키 페이지 원문 조회
 주의사항:
   * 강력한 도구이므로 파급효과가 있는 명령은 신중하게 다뤄야 합니다.
-===== 5. 실행 작업 관리 =====
+==== 1-5. 실행 작업 관리 ====
-오래 걸리는 작업이나 백그라운드에서 실행 중인 작업의 상태를 관리하는 도구입니다.
+도구 명칭: ''process''
-주요 용도:
+용도:
   * 실행 상태 확인
   * 중간 로그 조회
@@ 줄 85: / 줄 83: @@
 활용 예시:
-  * 장시간 실행 중인 작업의 진행 상황 확인
+  * 오래 걸리는 백그라운드 작업 진행 상황 확인
-  * 백그라운드 프로세스 출력 로그 점검
-===== 6. 웹 검색 =====
+==== 1-6. 웹 검색 ====
-인터넷에서 최신 정보나 참고 자료를 찾는 도구입니다.
+도구 명칭: ''web_search''
-주요 용도:
+용도:
   * 최신 정보 검색
   * 기사, 블로그, 문서 탐색
   * 공식 사이트 및 참고 자료 확인
-  * 여러 검색 결과 비교
 활용 예시:
   * 특정 서비스의 최신 변경사항 확인
   * 공식 문서나 보도자료 탐색
-  * 외부 참고 링크 수집
-주의사항:
+==== 1-7. 웹페이지 읽기 ====
-  * 검색 결과는 출처 신뢰도를 함께 검토해야 합니다.
+도구 명칭: ''web_fetch''
-===== 7. 웹페이지 읽기 =====
+용도:
-웹페이지 본문을 읽고 필요한 내용을 추출할 때 사용하는 도구입니다.
-주요 용도:
   * 기사 본문 확인
   * 안내 페이지 요약
@@ 줄 115: / 줄 107: @@
 활용 예시:
-  * 검색 결과로 찾은 문서의 실제 본문 확인
+  * 검색 결과로 찾은 문서의 실제 본문 검토
-  * 공지사항 페이지 핵심 내용 요약
-  * 외부 문서의 주요 문단 검토
-===== 8. 브라우저 =====
+==== 1-8. 브라우저 ====
-브라우저 화면을 직접 열고, 페이지 구조를 확인하거나 버튼 클릭·입력 같은 상호작용이 필요할 때 사용하는 도구입니다.
+도구 명칭: ''browser''
-주요 용도:
+용도:
   * 웹페이지 열기
   * 화면 상태 확인
@@ 줄 130: / 줄 120: @@
 활용 예시:
-  * 로그인된 환경에서 화면 확인
+  * 웹 UI 구조 확인
-  * 특정 메뉴나 버튼 위치 파악
+  * 로그인된 브라우저 화면 점검
-  * 웹 UI 동작 점검
-주의사항:
+==== 1-9. 캔버스 ====
-  * 로그인, 권한, 개인정보가 관련된 작업은 특히 더 신중하게 처리해야 합니다.
+도구 명칭: ''canvas''
+용도:
+  * 화면 표시
+  * 화면 내용 확인
+  * 시각적 상태 점검
-===== 9. 메시지 전송 =====
+==== 1-10. 메시지 전송 ====
-채팅방이나 사용자에게 메시지, 반응, 알림 등을 보낼 때 사용하는 도구입니다.
+도구 명칭: ''message''
-주요 용도:
+용도:
   * 작업 결과 보고
   * 안내 메시지 전송
   * 이모지 반응 남기기
-  * 필요 시 알림 발송
+  * 알림 발송
 활용 예시:
-  * 작업 완료 내용 전달
+  * 채팅방에 완료 보고 전송
-  * 다른 세션 또는 채널에 공지 전송
+  * 특정 메시지에 반응 추가
-  * 메시지에 반응 추가
 주의사항:
-  * 외부로 나가는 행동이므로, 사용자를 대신해 의사 표현을 하는 상황에서는 특히 주의가 필요합니다.
+  * 외부로 나가는 행동이므로 사용자를 대신한 의사 표현에는 주의가 필요합니다.
-===== 10. 기억 검색 =====
+==== 1-11. 음성 변환 ====
-이전에 기록해둔 메모, 장기 기억, 운영 맥락을 다시 찾을 때 사용하는 도구입니다.
+도구 명칭: ''tts''
-주요 용도:
+용도:
+  * 텍스트를 음성으로 변환
+  * 듣기용 안내 생성
+==== 1-12. 기억 검색 ====
+도구 명칭: ''memory_search'', ''memory_get''
+용도:
   * 이전 결정사항 확인
   * 사용자 선호 복기
   * 과거 작업 맥락 확인
-  * 기록 기반 사실 조회
 활용 예시:
-  * 예전에 정리해둔 기준이나 합의사항 확인
+  * 예전에 정리해둔 기준이나 메모 다시 확인
-  * 사용자 말투, 선호, 반복 요청사항 참고
-  * 최근 작업 흐름 재확인
-===== 11. 보조 세션 / 에이전트 =====
+==== 1-13. 세션 / 보조 에이전트 관리 ====
-복잡하거나 시간이 오래 걸리는 작업을 별도 세션으로 분리해 처리할 때 사용하는 도구입니다.
+도구 명칭: ''sessions_spawn'', ''sessions_send'', ''sessions_list'', ''sessions_history'', ''sessions_yield'', ''subagents'', ''agents_list''
-주요 용도:
+용도:
   * 보조 세션 생성
   * 별도 작업 위임
@@ 줄 180: / 줄 177: @@
   * 긴 조사 작업을 별도 세션에 맡기기
   * 코딩 또는 분석 작업을 분리 실행
-  * 메인 대화와 별개로 보조 작업 병행
-===== 12. 음성 변환 =====
+==== 1-14. 상태 확인 ====
-텍스트를 음성으로 변환해 전달할 때 사용하는 도구입니다.
+도구 명칭: ''session_status''
-주요 용도:
+용도:
-  * 안내 음성 생성
+  * 현재 시간 확인
-  * 짧은 메시지 음성 전달
+  * 세션 상태 확인
-  * 듣기용 콘텐츠 제작
+  * 모델 및 실행 환경 점검
+===== 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 조회, 추가, 수정, 내보내기
 활용 예시:
-  * 간단한 안내를 음성으로 전달
+  * 공유 드라이브에서 파일 찾아서 PDF로 내보내기
-  * 설명 문장을 음성 파일로 변환
+  * 안 읽은 메일 확인
+  * 캘린더 일정 생성
+  * 스프레드시트 데이터 읽기 및 업데이트
-===== 13. 캔버스 =====
+주의사항:
-화면이나 시각적 인터페이스를 띄우고 확인할 때 사용하는 도구입니다.
+  * 인증이 필요한 도구이며, 에이전트별 설정 분리가 중요합니다.
+  * TOOLS.md에 적힌 환경변수와 인증 절차를 따라야 합니다.
-주요 용도:
+==== 2-2. MySQL 조회 ====
-  * 화면 표시
+도구 명칭: ''mysql''
-  * 화면 내용 확인
-  * 시각적 상태 점검
-===== 14. 상태 확인 =====
+설명:
-현재 세션 상태, 시간, 모델 설정 등 운영에 필요한 기본 정보를 확인할 때 사용하는 도구입니다.
+  * 회사 내부 sales 데이터베이스를 조회할 때 사용하는 도구입니다.
-주요 용도:
+주요 기능:
-  * 현재 시간 확인
+  * 테이블 조회
-  * 세션 상태 확인
+  * 조건 검색
-  * 모델 및 실행 환경 점검
+  * 집계 조회
+  * CSV 추출
+중요 원칙:
+  * 읽기 전용으로 사용합니다.
+  * INSERT, UPDATE, DELETE, DROP, ALTER, TRUNCATE 같은 변경 작업은 수행하지 않습니다.
+  * 쿼리 작성 전에는 반드시 스키마 문서를 확인합니다.
+==== 2-3. Python 스크립트 ====
+도구 명칭: ''python3''
+설명:
+  * 데이터 정리, 자동화, 간단한 프로그램 제작에 활용합니다.
+주요 활용:
+  * 텍스트/CSV/엑셀 처리
+  * API 호출
+  * 자동화 스크립트 작성
+  * 데이터 변환 및 가공
+관련 라이브러리 예시:
+  * ''pandas'' : 표 데이터 처리
+  * ''requests'' : 웹/API 요청
+  * ''bs4 (BeautifulSoup)'' : HTML 분석
+  * ''playwright'' : 브라우저 자동화
+==== 2-4. 웹 스크래핑 ====
+관련 도구 명칭: ''requests'', ''BeautifulSoup'', ''playwright''
+설명:
+  * 웹페이지 구조를 분석하고 필요한 데이터를 추출할 때 사용합니다.
+주요 기능:
+  * HTML 구조 분석
+  * 반복 데이터 추출
+  * CSV 저장
+  * JS 렌더링 페이지 수집
+주의사항:
+  * 고정 선택자를 무조건 신뢰하지 않고 매번 구조를 확인합니다.
+  * 과도한 요청은 피하고, robots.txt 및 정책을 고려합니다.
+==== 2-5. 인스타그램 수집 ====
+도구 명칭: ''instagrapi''
+설명:
+  * 인스타그램 게시물, 댓글, 계정 게시물 등을 수집할 때 활용할 수 있는 Python 기반 도구입니다.
+주요 기능:
+  * 게시물 댓글 수집
+  * 특정 계정 게시물 수집
+  * 해시태그 게시물 수집
+주의사항:
+  * 과도한 수집은 계정 제한 위험이 있으므로 속도와 양을 조절해야 합니다.
-===== 비서가 주로 잘하는 작업 =====
+===== 3. 비서가 주로 잘하는 작업 =====
 위 도구들을 조합하면 비서는 아래와 같은 업무를 안정적으로 지원할 수 있습니다.
@@ 줄 216: / 줄 285: @@
   * 위키 수정 및 초안 작성
   * 인터넷 조사 및 자료 수집
+  * Google Workspace 문서/메일/시트 처리
   * 파일 확인 및 기록 관리
   * 운영 문서 업데이트
   * 여러 자료를 기반으로 한 요약 정리
   * 반복 작업의 부분 자동화
+  * 데이터 조회 및 정리
-===== 운영상 주의할 작업 =====
+===== 4. 운영상 주의할 작업 =====
 도구를 사용할 수 있다고 해서 모든 작업을 즉시 수행하는 것은 아닙니다.
 특히 아래 유형은 더 신중하게 판단해야 합니다.
@@ 줄 229: / 줄 300: @@
   * 사용자를 대신한 공식적 표현
   * 민감 정보 처리
+  * 데이터 변경 작업
   * 되돌리기 어려운 변경
-===== 요약 =====
+===== 5. 요약 =====
-비서는 다양한 도구를 활용해 ''읽기'', ''쓰기'', ''수정'', ''검색'', ''실행'', ''전달'' 작업을 수행할 수 있습니다.
+비서는 ''read'', ''write'', ''edit'', ''exec'' 같은 기본 도구와,
+''gog'', ''mysql'', ''python3'' 같은 외부 도구를 상황에 맞게 활용할 수 있습니다.
 따라서 단순 응답형 비서가 아니라, 실제 운영 업무를 보조하는 실행형 디지털 비서로 이해하면 됩니다.