> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# إضافة Zalo Personal

# Zalo Personal (إضافة)

دعم Zalo Personal لـ OpenClaw عبر إضافة، باستخدام `zca-cli` لأتمتة حساب مستخدم Zalo عادي.

> **تحذير:** قد تؤدي الأتمتة غير الرسمية إلى تعليق الحساب أو حظره. استخدمه على مسؤوليتك الخاصة.

## التسمية

معرّف القناة هو `zalouser` لجعل الأمر واضحًا بأن هذا يُؤتمت **حساب مستخدم Zalo شخصي** (غير رسمي). نُبقي `zalo` محجوزًا لتكامل محتمل مستقبلاً مع واجهة Zalo API الرسمية.

## أين يتم التشغيل

تعمل هذه الإضافة **داخل عملية Gateway**.

إذا كنت تستخدم Gateway عن بُعد، فقم بتثبيتها وتهيئتها على **الجهاز الذي يشغّل Gateway**، ثم أعد تشغيل Gateway.

## التثبيت

### الخيار A: التثبيت من npm

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/zalouser
```

أعد تشغيل Gateway بعد ذلك.

### الخيار B: التثبيت من مجلد محلي (للتطوير)

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install ./extensions/zalouser
cd ./extensions/zalouser && pnpm install
```

أعد تشغيل Gateway بعد ذلك.

## المتطلب المسبق: zca-cli

يجب أن يحتوي جهاز Gateway على `zca` على `PATH`:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
zca --version
```

## التهيئة

توجد تهيئة القناة ضمن `channels.zalouser` (وليس `plugins.entries.*`):

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  channels: {
    zalouser: {
      enabled: true,
      dmPolicy: "pairing",
    },
  },
}
```

## CLI

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw channels login --channel zalouser
openclaw channels logout --channel zalouser
openclaw channels status --probe
openclaw message send --channel zalouser --target <threadId> --message "Hello from OpenClaw"
openclaw directory peers list --channel zalouser --query "name"
```

## أداة الوكيل

اسم الأداة: `zalouser`

الإجراءات: `send`، `image`، `link`، `friends`، `groups`، `me`، `status`