# AI 연동 설정

## 글 작성 (Writer)

### 우선순위 (Fallback 순서)
1. **Claude Opus 4.6** (Primary) — cliproxy 프록시 경유
2. **Gemini 2.5 Flash** (Fallback 1) — Google AI API 직접 호출
3. **Groq llama-3.3-70b** (Fallback 2) — Groq API 직접 호출

Primary가 실패하거나 빈 응답이면 자동으로 다음 순서로 전환됩니다.

### 설정 파일
`config/engine.json`

```json
"writing": {
  "provider": "claude",
  "fallback_chain": ["gemini", "groq"],
  "options": {
    "claude": {
      "api_key_env": "ANTHROPIC_API_KEY",
      "base_url": "http://192.168.0.17:8317/api/provider/claude",
      "model": "claude-opus-4-6",
      "max_tokens": 4096,
      "temperature": 0.7
    },
    "gemini": {
      "api_key_env": "GEMINI_API_KEY",
      "model": "gemini-2.5-flash",
      "max_tokens": 4096,
      "temperature": 0.7
    },
    "groq": {
      "api_key_env": "GROQ_API_KEY",
      "model": "llama-3.3-70b-versatile",
      "max_tokens": 4096,
      "temperature": 0.7
    }
  }
}
```

### 환경변수 (.env)

| 변수명 | 설명 |
|--------|------|
| `ANTHROPIC_API_KEY` | cliproxy API 키 (`Jinie4eva!`) |
| `ANTHROPIC_BASE_URL` | cliproxy 내부 URL (`http://192.168.0.17:8317/api/provider/claude`) |
| `GEMINI_API_KEY` | Google AI API 키 |
| `GROQ_API_KEY` | Groq API 키 |

---

## cliproxy 설정

- **서비스**: NAS에서 Docker 컨테이너로 실행 (`CLIProxyAPI`)
- **내부 포트**: `8317`
- **외부 도메인**: `cliproxy.gru.farm`
- **내부 접근 URL**: `http://192.168.0.17:8317`

> **주의**: NAS 컨테이너에서 `cliproxy.gru.farm`(외부 도메인)으로 호출하면 헤어핀 NAT 문제로 401 오류가 발생합니다. 반드시 내부 IP(`192.168.0.17:8317`)로 연결해야 합니다.

---

## 텔레그램 대화 기능

텔레그램에서 봇에게 말을 걸면 Claude Opus 4.6으로 응답합니다.
Fallback 없이 Claude 단독 사용 (글 작성과 별개).

- **모델**: `claude-opus-4-6`
- **호출 경로**: `ANTHROPIC_BASE_URL` → cliproxy → Claude
- **구현 위치**: `bots/scheduler.py` → `handle_message()`

---

## 구현 위치

| 기능 | 파일 |
|------|------|
| Writer 클래스 (Claude/Gemini/Groq/Fallback) | `bots/engine_loader.py` |
| 글 작성 호출 | `bots/scheduler.py` → `_call_openclaw()` |
| 텔레그램 대화 | `bots/scheduler.py` → `handle_message()` |