Quick Start · 핵심 · 문서 · Claude Code Skill

**한국어** | [English](README.en.md)

## 快速开始 ### 给人 ``` # Homebrew brew tap JungHoonGhae/openkakao brew install openkakao-cli # 1. 认证信息存储 openkakao-cli login --save # 2. 聊天室列表 openkakao-cli chats # 3. 消息读取 openkakao-cli read -n 20 # 4. 消息发送（LOCO write — 需要 opt-in：safety.allow_loco_write = true） openkakao-cli send "Hello from CLI!" # 安全的本地读取替代方案（无服务器通信） openkakao-cli local-chats openkakao-cli local-read ``` 필요할 때만 예전 cache-backed 경로를 강제합니다. ``` openkakao-cli chats --rest openkakao-cli read --rest openkakao-cli members --rest ``` ### 给代理 ``` # 安全的本地数据库读取（无服务器通信） openkakao-cli local-chats --json openkakao-cli local-read --json # 运行前预览 openkakao-cli send "message" --dry-run --json # 结构化输出 openkakao-cli --json chats openkakao-cli --json read -n 20 # 实时事件监控 openkakao-cli watch --json # 连接至本地 hook 或 webhook 流程 openkakao-cli --unattended --allow-watch-side-effects watch \ --hook-cmd 'jq . > /tmp/openkakao-event.json' ``` Claude Code에서 바로 쓰려면: ``` npx skills add JungHoonGhae/skills@openkakao-cli ``` ## 核心 - macOS 카카오톡 앱에서 인증 정보 추출 - 채팅, 메시지, 멤버, 친구, 프로필 조회 - LOCO 기반 메시지 전송, 실시간 watch, 미디어 처리 - `--json` 출력으로 `jq`, `cron`, SQLite, LLM 흐름과 연결 가능 - `watch`, `hook`, `webhook`로 로컬 자동화와 에이전트 워크플로에 연결 가능 - `friends --local`, `profile --local`, `profile --chat-id`로 일부 조회 복구 가능 - `local-chats`, `local-read`, `local-search`로 로컬 DB에서 안전하게 읽기 (서버 통신 없음) - `--dry-run`으로 실행 전 미리보기 - `send --me`로 나와의 채팅에 바로 전송 (테스트용) - LOCO write 기본 비활성 — `safety.allow_loco_write = true`로 opt-in ## 这种情况非常适合 - 채팅 기록을 JSON으로 읽어서 다른 도구로 넘기고 싶을 때 - 카카오톡을 로컬 스크립트나 운영 도구의 입력 채널로 쓰고 싶을 때 - watch 이벤트를 hook이나 webhook으로 받아 후속 작업을 실행하고 싶을 때 - 사람이 직접 쓰는 CLI와 AI가 호출하는 로컬 인터페이스를 같이 두고 싶을 때 ## 安全模式 v1.1.0부터 LOCO write 작업(send, delete, edit, react)은 **기본 비활성**입니다. 계정 보호를 위해 서버에 쓰기 요청을 보내는 명령은 명시적 opt-in이 필요합니다. ``` # ~/.config/openkakao/config.toml [safety] allow_loco_write = true ``` 읽기 전용 작업은 항상 사용 가능합니다: | 명령 | 설명 | 서버 통신 | |------|------|-----------| | `local-chats` | 로컬 DB 채팅 목록 | 없음 | | `local-read ` | 로컬 DB 메시지 읽기 | 없음 | | `local-search "keyword"` | 로컬 DB 검색 | 없음 | | `chats --rest` | REST API 채팅 목록 | REST | | `read --rest` | REST API 메시지 읽기 | REST | | `send ... --dry-run` | 전송 미리보기 | 없음 | ## 要求 | Requirement | Notes | |-------------|-------| | macOS | 카카오톡 데스크탑 앱 설치 및 로그인 필요 | | Rust >= 1.75 | 소스 빌드 시 | ## 安装 ### Homebrew ``` brew tap JungHoonGhae/openkakao brew install openkakao-cli ``` ### 从源码 ``` git clone https://github.com/JungHoonGhae/openkakao-cli.git cd openkakao/openkakao-cli cargo install --path . ``` ## 文档 - 문서 사이트: https://openkakao.vercel.app/ - 빠른 시작: https://openkakao.vercel.app/docs/getting-started/quickstart/ - CLI 레퍼런스: https://openkakao.vercel.app/docs/cli/overview/ - 자동화 개요: https://openkakao.vercel.app/docs/automation/overview/ - LLM / agent 워크플로: https://openkakao.vercel.app/docs/automation/llm-agent-workflows/ - watch 패턴: https://openkakao.vercel.app/docs/automation/watch-patterns/ - 프로토콜 문서: https://openkakao.vercel.app/docs/protocol/overview/ Reverse engineering / local app-state diff: ``` openkakao-cli profile-hints --local-graph --json openkakao-cli profile-hints --app-state --json > /tmp/profile-before.json openkakao-cli profile-hints --app-state --app-state-diff /tmp/profile-before.json --json ``` ## Claude Code Skill ``` npx skills add JungHoonGhae/skills@openkakao-cli ``` ## 开发 ``` cd openkakao-cli cargo build --release ``` 자세한 사용법, 운영 메모, 프로토콜 설명은 문서 사이트에 정리되어 있습니다. ## 支持 이 프로젝트가 도움이 되셨다면 응원해 주세요: ## 贡献 버그 제보와 PR 환영합니다. ## 许可证 MIT

标签：Agent, AI集成, API安全, Beta, Claude Code, CLI, Codex, Cursor, Homebrew安装, Hook, JSON输出, KakaoTalk, LOCO, MIT License, OpenClaw, Rust, SEO, Watch模式, Webhook, WiFi技术, 力导向图, 可视化界面, 威胁情报, 开发者工具, 开源, 快速启动, 文档, 文档结构分析, 桌面应用, 终端工具, 网络流量审计, 聊天应用, 通知系统, 非官方