Cầm tay chỉ việc

Dành cho ai?

Bạn chưa cần biết monorepo hay TypeScript. Làm đúng thứ tự dưới đây; bỏ qua bước không áp dụng (vd. bạn chỉ dùng OpenClaw thì không cần sửa claude_desktop_config.json).

Bước 0 — Chọn “cửa vào”

Bạn đang dùng…	Làm theo nhánh
OpenClaw (app/plugin)	Nhánh A — Bước 2A
Cursor / Claude Desktop / IDE có MCP	Nhánh B — Bước 2B

Cả hai nhánh đều cần token Haravan hợp lệ (Bước 1).

Bước 1 — Chuẩn bị shop và token

1. Xác định domain shop dạng ten-shop.myharavan.com (không thêm https://).
2. Trong Haravan admin, tạo private app token (ứng dụng riêng) với quyền đọc phù hợp nghiệp vụ của bạn.
3. Không dán token vào chat công khai; lưu vào cấu hình plugin hoặc biến môi trường máy bạn.

Chi tiết quyền và biến môi trường: Cài đặt & thiết lập.

Bước 2A — OpenClaw plugin (khuyến nghị)

1. Nếu package đã trên npm / ClawHub:

   openclaw plugins install @haravan-master/openclaw-haravan-ops-plugin

2. Nếu clone repo để dev / cài local:

   git clone https://github.com/tody-agent/openclaw-haravan.git
   cd openclaw-haravan
   npm install && npm run build
   openclaw plugins install -l ./packages/openclaw-haravan-plugin

3. Trong OpenClaw: bật plugin haravan-ops, điền shop và accessToken.
4. Mở chat, gõ một câu mẫu.

Hướng dẫn đầy đủ: Plugin Haravan Ops.

Bước 2B — MCP + skill

1. Clone repo, npm install && npm run build.
2. Thêm MCP server trỏ tới packages/mcp-server/dist/index.js với env:
   • HARAVAN_SHOP
   • HARAVAN_TOKEN
3. Gắn skill từ repo (xem SKILL.md trên GitHub hoặc thư mục skills/openclaw-haravan-ops/).

Chi tiết: Cài đặt & thiết lập.

Bước 3 — Câu hỏi đầu tiên (copy dùng ngay)

Dán một câu vào chat (tiếng Việt):

• “Hôm nay shop bán thế nào, có đơn nào cần chú ý không?”
• “Tóm tắt nhanh tồn kho: có variant âm hoặc sắp hết không?”

Kỳ vọng hợp lý: trợ lý tóm tắt & cảnh báo sớm, không thay báo cáo kế toán chính thức. Xem điều quan trọng cần biết.

Bước 4 — Đọc kết quả và hành động

1. Ghi nhận số liệu và cảnh báo (đơ trễ, tồn thấp, KM…).
2. Việc sửa trên production (đơn, giá, theme): làm trong Haravan admin hoặc chỉ dùng tool ghi khi bạn đã hiểu và xác nhận trong chat (nếu tool yêu cầu).

Bước 5 — Nếu không chạy

1. Plugin/MCP đã build chưa? (npm run build trong repo).
2. HARAVAN_SHOP / shop đúng domain chưa?
3. Token còn hạn, quyền đủ chưa?
4. Xem FAQ.

Bước 6 — Đi sâu theo nhu cầu

• Sử dụng theo vai trò — câu hỏi theo buổi / vai trò.
• Năng lực & use cases — xem ví dụ việc AI làm được.

Liên kết nhanh

• Bản đồ tài liệu · Personas · Cộng đồng