# Bạn là người dùng OpenClaw — kết nối website A với Teddy

Mục tiêu: trên OpenClaw **chỉ cần** website URL + username + Application Password. Tool tự **detect Agent Pipeline** đã bật chưa.

---

## Phần 1 — Trên website A (một lần)

1. Cài / cập nhật plugin **Teddy**, kích hoạt.  
2. **Teddy → Settings** → bật **Agent Pipeline** (`Use audited agent pipeline`).  
3. **Users → Profile** (user sẽ dùng với OpenClaw) → **Application Passwords**  
   - Tên: `openclaw`  
   - **Add** → **copy** chuỗi (chỉ hiện một lần).  

Không cần JWT, SSH, hay FTP.

Kiểm tra nhanh (tuỳ chọn): mở  
`https://SITE-A/wp-json/teddy/v1/domain-tools`  
→ thấy **401** (yêu cầu đăng nhập) = Pipeline **đã bật**.  
→ **404** = chưa bật Pipeline / chưa cài Teddy.

---

## Phần 2 — Trên máy OpenClaw (chỉ 3 field)

Teddy plugin trên disk phải có folder `mcp-server/` + `openclaw/` (có trong zip Teddy).

### Cách A — Lệnh đơn giản (khuyến nghị)

```bash
cd /path/to/teddy/mcp-server && npm install
cd ../openclaw
npm link    # một lần → có lệnh teddy-openclaw

teddy-openclaw connect
```

Nhập lần lượt:

1. `https://site-a.example`  
2. username  
3. Application Password  

Wizard sẽ:

- Detect site có mở được không  
- Detect **Agent Pipeline on/off**  
- Thử đăng nhập  
- Ghi MCP vào `~/.openclaw/openclaw.json`  
- Cài skill `teddy`  
- Chạy `openclaw mcp doctor … --probe`  

Hoặc một dòng:

```bash
teddy-openclaw connect \
  --url https://site-a.example \
  --username editor \
  --password "xxxx xxxx xxxx xxxx xxxx xxxx"
```

Chỉ kiểm tra, chưa ghi config:

```bash
teddy-openclaw diagnose --url https://site-a.example
teddy-openclaw diagnose --url https://site-a.example --username editor --password "…"
```

### Cách B — Plugin trong OpenClaw (form cấu hình)

```bash
openclaw plugins install /path/to/teddy/openclaw --force
```

Rồi mở Control UI / config plugin **Teddy WordPress**, điền:

| Field | Ví dụ |
|-------|--------|
| siteUrl | `https://site-a.example` |
| username | `editor` |
| applicationPassword | `xxxx …` |
| serverName | `teddy` (mặc định) |
| profile | `manager` |

Gateway startup sẽ sync MCP. Tool `teddy_connection_status` dùng để diagnose trong chat.

---

## Phần 3 — Dùng sau khi nối

Session mới / restart gateway nếu cần, rồi hỏi agent:

- “Briefing site hôm nay” → `teddy__teddy_site_briefing`  
- “Comment đang chờ duyệt” → `teddy__teddy_comment_list`  

Tool nguy hiểm: agent gửi preview + token → bạn `approve <token>`.

---

## Lỗi thường gặp

| Hiện tượng | Việc cần làm trên website A |
|------------|-----------------------------|
| `agent_pipeline: off` / 404 | Bật Agent Pipeline trong Teddy Settings |
| Auth failed | Tạo lại Application Password, đúng username |
| Cannot reach site | URL sai / firewall / SSL (local: `--insecure`) |

---

## Tóm tắt một câu

**Website A:** Teddy + Agent Pipeline + App Password.  
**OpenClaw:** `teddy-openclaw connect` (hoặc form plugin) với 3 field — còn lại tự detect.