docs: add arabic publish workflow
This commit is contained in:
Peter Steinberger
parent
1c1e8e80ae
commit
b5b5b78f29
20
.github/workflows/translate-ar.yml
vendored
Normal file
20
.github/workflows/translate-ar.yml
vendored
Normal file
@ -0,0 +1,20 @@
|
||||
name: Translate ar
|
||||
|
||||
on:
|
||||
repository_dispatch:
|
||||
types:
|
||||
- translate-ar-release
|
||||
schedule:
|
||||
- cron: "47 6 * * *"
|
||||
workflow_dispatch:
|
||||
|
||||
permissions:
|
||||
contents: write
|
||||
|
||||
jobs:
|
||||
translate:
|
||||
uses: ./.github/workflows/translate-locale-reusable.yml
|
||||
with:
|
||||
locale: ar
|
||||
locale_slug: ar
|
||||
secrets: inherit
|
||||
@ -97,7 +97,7 @@ jobs:
|
||||
from pathlib import Path
|
||||
|
||||
source_hash_re = re.compile(r'^x-i18n:\n(?: .*\n)*? source_hash: ([0-9a-f]{64})$', re.M)
|
||||
generated_dirs = {"zh-CN", "ja-JP", "es", "pt-BR", "ko", "de", "fr"}
|
||||
generated_dirs = {"zh-CN", "ja-JP", "es", "pt-BR", "ko", "de", "fr", "ar"}
|
||||
locale = os.environ["LOCALE"]
|
||||
pending_path = Path(".openclaw-sync") / f"docs-i18n-{os.environ['LOCALE_SLUG']}.txt"
|
||||
|
||||
|
||||
@ -9,11 +9,11 @@ Source of truth lives in [`openclaw/openclaw`](https://github.com/openclaw/openc
|
||||
1. English docs are authored in `openclaw/openclaw`.
|
||||
2. `openclaw/openclaw/.github/workflows/docs-sync-publish.yml` mirrors the docs tree into this repo.
|
||||
3. This repo stores the published docs tree plus generated locale output.
|
||||
4. `openclaw/docs/.github/workflows/translate-zh-cn.yml`, `translate-ja-jp.yml`, `translate-es.yml`, `translate-pt-br.yml`, `translate-ko.yml`, `translate-de.yml`, and `translate-fr.yml` refresh the generated locale trees on a staggered daily schedule, on manual dispatch, and after release dispatches from `openclaw/openclaw`.
|
||||
4. `openclaw/docs/.github/workflows/translate-zh-cn.yml`, `translate-ja-jp.yml`, `translate-es.yml`, `translate-pt-br.yml`, `translate-ko.yml`, `translate-de.yml`, `translate-fr.yml`, and `translate-ar.yml` refresh the generated locale trees on a staggered daily schedule, on manual dispatch, and after release dispatches from `openclaw/openclaw`.
|
||||
|
||||
## Translation behavior
|
||||
|
||||
- zh-CN, ja-JP, es, pt-BR, ko, de, and fr pages are generated output.
|
||||
- zh-CN, ja-JP, es, pt-BR, ko, de, fr, and ar pages are generated output.
|
||||
- Each translated page stores `x-i18n.source_hash`.
|
||||
- The translate workflow computes a pending file list before calling the model.
|
||||
- If no English source hashes changed, the workflow skips the expensive translation step entirely.
|
||||
@ -25,7 +25,7 @@ Source of truth lives in [`openclaw/openclaw`](https://github.com/openclaw/openc
|
||||
|
||||
- Do not treat this repo as the primary place for English doc edits.
|
||||
- Make English doc changes in `openclaw/openclaw`, then let sync copy them here.
|
||||
- Generated locale pages in `docs/zh-CN/**`, `docs/ja-JP/**`, `docs/es/**`, `docs/pt-BR/**`, `docs/ko/**`, `docs/de/**`, and `docs/fr/**` are generated output.
|
||||
- Generated locale pages in `docs/zh-CN/**`, `docs/ja-JP/**`, `docs/es/**`, `docs/pt-BR/**`, `docs/ko/**`, `docs/de/**`, `docs/fr/**`, and `docs/ar/**` are generated output.
|
||||
- `.openclaw-sync/source.json` records which `openclaw/openclaw` commit this mirror was synced from.
|
||||
|
||||
## Secrets
|
||||
|
||||
@ -11,13 +11,7 @@ Generated locale trees and live translation memory now live in the publish repo:
|
||||
|
||||
- English docs are authored in `openclaw/openclaw`.
|
||||
- The source docs tree lives under `docs/`.
|
||||
<<<<<<< HEAD
|
||||
- The source repo no longer keeps committed generated locale trees such as `docs/zh-CN/**`, `docs/ja-JP/**`, `docs/es/**`, `docs/pt-BR/**`, `docs/ko/**`, `docs/de/**`, or `docs/fr/**`.
|
||||
||||||| parent of 15ada7e (docs: add generated locale scaffolding)
|
||||
- The source repo no longer keeps committed `docs/zh-CN/**`.
|
||||
=======
|
||||
- The source repo no longer keeps committed generated locale trees such as `docs/zh-CN/**`, `docs/ja-JP/**`, `docs/es/**`, `docs/pt-BR/**`, `docs/ko/**`, `docs/de/**`, or `docs/fr/**`.
|
||||
>>>>>>> 15ada7e (docs: add generated locale scaffolding)
|
||||
- The source repo no longer keeps committed generated locale trees such as `docs/zh-CN/**`, `docs/ja-JP/**`, `docs/es/**`, `docs/pt-BR/**`, `docs/ko/**`, `docs/de/**`, `docs/fr/**`, or `docs/ar/**`.
|
||||
|
||||
## End-to-end flow
|
||||
|
||||
@ -27,7 +21,7 @@ Generated locale trees and live translation memory now live in the publish repo:
|
||||
4. The sync script rewrites the publish `docs/docs.json` so the generated locale picker blocks exist there even though they are no longer committed in the source repo.
|
||||
5. `openclaw/docs/.github/workflows/translate-zh-cn.yml` refreshes `docs/zh-CN/**` once a day, on demand, and after source-repo release dispatches.
|
||||
6. `openclaw/docs/.github/workflows/translate-ja-jp.yml` does the same for `docs/ja-JP/**`.
|
||||
7. `openclaw/docs/.github/workflows/translate-es.yml`, `translate-pt-br.yml`, `translate-ko.yml`, `translate-de.yml`, and `translate-fr.yml` do the same for `docs/es/**`, `docs/pt-BR/**`, `docs/ko/**`, `docs/de/**`, and `docs/fr/**`.
|
||||
7. `openclaw/docs/.github/workflows/translate-es.yml`, `translate-pt-br.yml`, `translate-ko.yml`, `translate-de.yml`, `translate-fr.yml`, and `translate-ar.yml` do the same for `docs/es/**`, `docs/pt-BR/**`, `docs/ko/**`, `docs/de/**`, `docs/fr/**`, and `docs/ar/**`.
|
||||
|
||||
## Why the split exists
|
||||
|
||||
@ -38,10 +32,10 @@ Generated locale trees and live translation memory now live in the publish repo:
|
||||
## Files in this folder
|
||||
|
||||
- `glossary.<lang>.json` — preferred term mappings used as prompt guidance.
|
||||
- `de-navigation.json`, `es-navigation.json`, `fr-navigation.json`, `ja-navigation.json`, `ko-navigation.json`, `pt-BR-navigation.json`, `zh-Hans-navigation.json` — Mintlify locale picker blocks reinserted into the publish repo during sync.
|
||||
- `ar-navigation.json`, `de-navigation.json`, `es-navigation.json`, `fr-navigation.json`, `ja-navigation.json`, `ko-navigation.json`, `pt-BR-navigation.json`, `zh-Hans-navigation.json` — Mintlify locale picker blocks reinserted into the publish repo during sync.
|
||||
- `<lang>.tm.jsonl` — translation memory keyed by workflow + model + text hash.
|
||||
|
||||
In this repo, generated locale TM files such as `docs/.i18n/zh-CN.tm.jsonl`, `docs/.i18n/ja-JP.tm.jsonl`, `docs/.i18n/es.tm.jsonl`, `docs/.i18n/pt-BR.tm.jsonl`, `docs/.i18n/ko.tm.jsonl`, `docs/.i18n/de.tm.jsonl`, and `docs/.i18n/fr.tm.jsonl` are intentionally no longer committed.
|
||||
In this repo, generated locale TM files such as `docs/.i18n/zh-CN.tm.jsonl`, `docs/.i18n/ja-JP.tm.jsonl`, `docs/.i18n/es.tm.jsonl`, `docs/.i18n/pt-BR.tm.jsonl`, `docs/.i18n/ko.tm.jsonl`, `docs/.i18n/de.tm.jsonl`, `docs/.i18n/fr.tm.jsonl`, and `docs/.i18n/ar.tm.jsonl` are intentionally no longer committed.
|
||||
|
||||
## Glossary format
|
||||
|
||||
@ -67,7 +61,7 @@ Fields:
|
||||
- If the pending count is `0`, the expensive translation step is skipped entirely.
|
||||
- If there are pending files, the workflow translates only those files.
|
||||
- The publish workflow retries transient model-format failures, but unchanged files stay skipped because the same hash check runs on each retry.
|
||||
- The source repo also dispatches zh-CN, ja-JP, es, pt-BR, ko, de, and fr refreshes after published GitHub releases so release docs can catch up without waiting for the daily cron.
|
||||
- The source repo also dispatches zh-CN, ja-JP, es, pt-BR, ko, de, fr, and ar refreshes after published GitHub releases so release docs can catch up without waiting for the daily cron.
|
||||
|
||||
## Operational notes
|
||||
|
||||
|
||||
18
docs/.i18n/ar-navigation.json
Normal file
18
docs/.i18n/ar-navigation.json
Normal file
@ -0,0 +1,18 @@
|
||||
{
|
||||
"language": "ar",
|
||||
"tabs": [
|
||||
{
|
||||
"tab": "ابدأ",
|
||||
"groups": [
|
||||
{
|
||||
"group": "نظرة عامة",
|
||||
"pages": ["ar/index"]
|
||||
},
|
||||
{
|
||||
"group": "الخطوات الأولى",
|
||||
"pages": ["ar/start/getting-started", "ar/start/wizard"]
|
||||
}
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
0
docs/.i18n/ar.tm.jsonl
Normal file
0
docs/.i18n/ar.tm.jsonl
Normal file
5
docs/.i18n/glossary.ar.json
Normal file
5
docs/.i18n/glossary.ar.json
Normal file
@ -0,0 +1,5 @@
|
||||
[
|
||||
{ "source": "CLI", "target": "CLI" },
|
||||
{ "source": "Mintlify", "target": "Mintlify" },
|
||||
{ "source": "OpenClaw", "target": "OpenClaw" }
|
||||
]
|
||||
203
docs/ar/index.md
Normal file
203
docs/ar/index.md
Normal file
@ -0,0 +1,203 @@
|
||||
---
|
||||
read_when:
|
||||
- تقديم OpenClaw للقادمين الجدد
|
||||
summary: OpenClaw هي بوابة متعددة القنوات لوكلاء الذكاء الاصطناعي وتعمل على أي نظام تشغيل.
|
||||
title: OpenClaw
|
||||
x-i18n:
|
||||
generated_at: "2026-04-05T11:36:25Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 9c29a8d9fc41a94b650c524bb990106f134345560e6d615dac30e8815afff481
|
||||
source_path: index.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# OpenClaw 🦞
|
||||
|
||||
<p align="center">
|
||||
<img
|
||||
src="/assets/openclaw-logo-text-dark.png"
|
||||
alt="OpenClaw"
|
||||
width="500"
|
||||
class="dark:hidden"
|
||||
/>
|
||||
<img
|
||||
src="/assets/openclaw-logo-text.png"
|
||||
alt="OpenClaw"
|
||||
width="500"
|
||||
class="hidden dark:block"
|
||||
/>
|
||||
</p>
|
||||
|
||||
> _"اقشر! اقشر!"_ — كركند فضائي، على الأرجح
|
||||
|
||||
<p align="center">
|
||||
<strong>بوابة تعمل على أي نظام تشغيل لوكلاء الذكاء الاصطناعي عبر Discord وGoogle Chat وiMessage وMatrix وMicrosoft Teams وSignal وSlack وTelegram وWhatsApp وZalo والمزيد.</strong><br />
|
||||
أرسل رسالة، واحصل على رد من وكيل من جيبك. شغّل Gateway واحدًا عبر القنوات المضمنة، وإضافات القنوات المجمعة، وWebChat، وعُقد الأجهزة المحمولة.
|
||||
</p>
|
||||
|
||||
<Columns>
|
||||
<Card title="ابدأ" href="/start/getting-started" icon="rocket">
|
||||
ثبّت OpenClaw وشغّل Gateway خلال دقائق.
|
||||
</Card>
|
||||
<Card title="شغّل الإعداد التمهيدي" href="/start/wizard" icon="sparkles">
|
||||
إعداد موجّه باستخدام `openclaw onboard` وتدفّقات الاقتران.
|
||||
</Card>
|
||||
<Card title="افتح واجهة التحكم" href="/web/control-ui" icon="layout-dashboard">
|
||||
شغّل لوحة التحكم في المتصفح للمحادثة والإعدادات والجلسات.
|
||||
</Card>
|
||||
</Columns>
|
||||
|
||||
## ما هو OpenClaw؟
|
||||
|
||||
OpenClaw هو **Gateway مستضاف ذاتيًا** يربط تطبيقات الدردشة المفضلة لديك وواجهات القنوات — القنوات المضمنة بالإضافة إلى إضافات القنوات المجمعة أو الخارجية مثل Discord وGoogle Chat وiMessage وMatrix وMicrosoft Teams وSignal وSlack وTelegram وWhatsApp وZalo والمزيد — بوكلاء برمجة بالذكاء الاصطناعي مثل Pi. أنت تشغّل عملية Gateway واحدة على جهازك الخاص (أو على خادم)، فتتحول إلى جسر بين تطبيقات المراسلة لديك ومساعد ذكاء اصطناعي متاح دائمًا.
|
||||
|
||||
**لمن هو؟** للمطورين والمستخدمين المتقدمين الذين يريدون مساعدًا شخصيًا بالذكاء الاصطناعي يمكنهم مراسلته من أي مكان — من دون التخلي عن التحكم في بياناتهم أو الاعتماد على خدمة مستضافة.
|
||||
|
||||
**ما الذي يميّزه؟**
|
||||
|
||||
- **مستضاف ذاتيًا**: يعمل على أجهزتك ووفق قواعدك
|
||||
- **متعدد القنوات**: يخدم Gateway واحد القنوات المضمنة بالإضافة إلى إضافات القنوات المجمعة أو الخارجية في الوقت نفسه
|
||||
- **مصمم أصلًا للوكلاء**: مبني لوكلاء البرمجة مع استخدام الأدوات والجلسات والذاكرة والتوجيه متعدد الوكلاء
|
||||
- **مفتوح المصدر**: مرخّص بموجب MIT ويقوده المجتمع
|
||||
|
||||
**ماذا تحتاج؟** Node 24 (موصى به)، أو Node 22 LTS (`22.14+`) للتوافق، ومفتاح API من المزوّد الذي تختاره، و5 دقائق. للحصول على أفضل جودة وأمان، استخدم أقوى نموذج متاح من الجيل الأحدث.
|
||||
|
||||
## كيف يعمل
|
||||
|
||||
```mermaid
|
||||
flowchart LR
|
||||
A["تطبيقات الدردشة + الإضافات"] --> B["Gateway"]
|
||||
B --> C["وكيل Pi"]
|
||||
B --> D["CLI"]
|
||||
B --> E["واجهة التحكم على الويب"]
|
||||
B --> F["تطبيق macOS"]
|
||||
B --> G["عُقد iOS وAndroid"]
|
||||
```
|
||||
|
||||
يُعد Gateway المصدر الوحيد للحقيقة للجلسات والتوجيه واتصالات القنوات.
|
||||
|
||||
## الإمكانات الأساسية
|
||||
|
||||
<Columns>
|
||||
<Card title="بوابة متعددة القنوات" icon="network">
|
||||
Discord وiMessage وSignal وSlack وTelegram وWhatsApp وWebChat والمزيد باستخدام عملية Gateway واحدة.
|
||||
</Card>
|
||||
<Card title="قنوات الإضافات" icon="plug">
|
||||
تضيف الإضافات المجمعة Matrix وNostr وTwitch وZalo والمزيد في الإصدارات الحالية العادية.
|
||||
</Card>
|
||||
<Card title="توجيه متعدد الوكلاء" icon="route">
|
||||
جلسات معزولة لكل وكيل أو مساحة عمل أو مرسل.
|
||||
</Card>
|
||||
<Card title="دعم الوسائط" icon="image">
|
||||
أرسل واستقبل الصور والصوت والمستندات.
|
||||
</Card>
|
||||
<Card title="واجهة التحكم على الويب" icon="monitor">
|
||||
لوحة تحكم في المتصفح للمحادثة والإعدادات والجلسات والعُقد.
|
||||
</Card>
|
||||
<Card title="عُقد الأجهزة المحمولة" icon="smartphone">
|
||||
اقترن بعُقد iOS وAndroid لسير عمل Canvas والكاميرا والميزات الصوتية.
|
||||
</Card>
|
||||
</Columns>
|
||||
|
||||
## بدء سريع
|
||||
|
||||
<Steps>
|
||||
<Step title="ثبّت OpenClaw">
|
||||
```bash
|
||||
npm install -g openclaw@latest
|
||||
```
|
||||
</Step>
|
||||
<Step title="أجرِ الإعداد التمهيدي وثبّت الخدمة">
|
||||
```bash
|
||||
openclaw onboard --install-daemon
|
||||
```
|
||||
</Step>
|
||||
<Step title="ابدأ الدردشة">
|
||||
افتح واجهة التحكم في متصفحك وأرسل رسالة:
|
||||
|
||||
```bash
|
||||
openclaw dashboard
|
||||
```
|
||||
|
||||
أو صِل قناة ([Telegram](/channels/telegram) هي الأسرع) وابدأ الدردشة من هاتفك.
|
||||
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
هل تحتاج إلى إعداد التثبيت والتطوير الكامل؟ راجع [البدء](/start/getting-started).
|
||||
|
||||
## لوحة التحكم
|
||||
|
||||
افتح واجهة التحكم في المتصفح بعد بدء Gateway.
|
||||
|
||||
- الإعداد المحلي الافتراضي: [http://127.0.0.1:18789/](http://127.0.0.1:18789/)
|
||||
- الوصول عن بُعد: [واجهات الويب](/web) و[Tailscale](/gateway/tailscale)
|
||||
|
||||
<p align="center">
|
||||
<img src="/whatsapp-openclaw.jpg" alt="OpenClaw" width="420" />
|
||||
</p>
|
||||
|
||||
## الإعدادات (اختياري)
|
||||
|
||||
توجد الإعدادات في `~/.openclaw/openclaw.json`.
|
||||
|
||||
- إذا **لم تفعل شيئًا**، يستخدم OpenClaw ملف Pi الثنائي المجمّع في وضع RPC مع جلسات لكل مرسل.
|
||||
- إذا أردت تقييده، فابدأ بـ `channels.whatsapp.allowFrom` وقواعد الإشارة (للمجموعات).
|
||||
|
||||
مثال:
|
||||
|
||||
```json5
|
||||
{
|
||||
channels: {
|
||||
whatsapp: {
|
||||
allowFrom: ["+15555550123"],
|
||||
groups: { "*": { requireMention: true } },
|
||||
},
|
||||
},
|
||||
messages: { groupChat: { mentionPatterns: ["@openclaw"] } },
|
||||
}
|
||||
```
|
||||
|
||||
## ابدأ من هنا
|
||||
|
||||
<Columns>
|
||||
<Card title="محاور التوثيق" href="/start/hubs" icon="book-open">
|
||||
جميع الوثائق والأدلة، منظّمة حسب حالة الاستخدام.
|
||||
</Card>
|
||||
<Card title="الإعدادات" href="/gateway/configuration" icon="settings">
|
||||
إعدادات Gateway الأساسية والرموز وإعدادات المزوّد.
|
||||
</Card>
|
||||
<Card title="الوصول عن بُعد" href="/gateway/remote" icon="globe">
|
||||
أنماط الوصول عبر SSH وtailnet.
|
||||
</Card>
|
||||
<Card title="القنوات" href="/channels/telegram" icon="message-square">
|
||||
إعداد خاص بالقنوات لـ Feishu وMicrosoft Teams وWhatsApp وTelegram وDiscord والمزيد.
|
||||
</Card>
|
||||
<Card title="العُقد" href="/nodes" icon="smartphone">
|
||||
عُقد iOS وAndroid مع الاقتران وCanvas والكاميرا وإجراءات الجهاز.
|
||||
</Card>
|
||||
<Card title="المساعدة" href="/help" icon="life-buoy">
|
||||
الإصلاحات الشائعة ونقطة الدخول إلى استكشاف الأخطاء وإصلاحها.
|
||||
</Card>
|
||||
</Columns>
|
||||
|
||||
## تعرّف على المزيد
|
||||
|
||||
<Columns>
|
||||
<Card title="قائمة الميزات الكاملة" href="/concepts/features" icon="list">
|
||||
إمكانات القنوات والتوجيه والوسائط كاملة.
|
||||
</Card>
|
||||
<Card title="توجيه متعدد الوكلاء" href="/concepts/multi-agent" icon="route">
|
||||
عزل مساحات العمل والجلسات لكل وكيل.
|
||||
</Card>
|
||||
<Card title="الأمان" href="/gateway/security" icon="shield">
|
||||
الرموز وقوائم السماح وعناصر التحكم في الأمان.
|
||||
</Card>
|
||||
<Card title="استكشاف الأخطاء وإصلاحها" href="/gateway/troubleshooting" icon="wrench">
|
||||
تشخيصات Gateway والأخطاء الشائعة.
|
||||
</Card>
|
||||
<Card title="نبذة وشكر وتقدير" href="/reference/credits" icon="info">
|
||||
أصول المشروع والمساهمون والترخيص.
|
||||
</Card>
|
||||
</Columns>
|
||||
151
docs/ar/start/getting-started.md
Normal file
151
docs/ar/start/getting-started.md
Normal file
@ -0,0 +1,151 @@
|
||||
---
|
||||
read_when:
|
||||
- الإعداد لأول مرة من الصفر
|
||||
- تريد أسرع طريق إلى محادثة تعمل بالفعل
|
||||
summary: ثبّت OpenClaw وابدأ أول محادثة لك خلال دقائق.
|
||||
title: البدء
|
||||
x-i18n:
|
||||
generated_at: "2026-04-05T11:36:39Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: c43eee6f0d3f593e3cf0767bfacb3e0ae38f51a2615d594303786ae1d4a6d2c3
|
||||
source_path: start/getting-started.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# البدء
|
||||
|
||||
ثبّت OpenClaw، وشغّل الإعداد التمهيدي، وابدأ الدردشة مع مساعدك المدعوم بالذكاء الاصطناعي — كل ذلك خلال نحو 5 دقائق. في النهاية سيكون لديك Gateway قيد التشغيل، ومصادقة مُعدّة، وجلسة دردشة عاملة.
|
||||
|
||||
## ما الذي تحتاج إليه
|
||||
|
||||
- **Node.js** — يُوصى بـ Node 24 (كما أن Node 22.14+ مدعوم أيضًا)
|
||||
- **مفتاح API** من موفّر نماذج (Anthropic أو OpenAI أو Google أو غيرها) — سيطلبه منك الإعداد التمهيدي
|
||||
|
||||
<Tip>
|
||||
تحقق من إصدار Node لديك باستخدام `node --version`.
|
||||
**لمستخدمي Windows:** كل من Windows الأصلي وWSL2 مدعومان. يُعد WSL2 أكثر استقرارًا ويُنصح به للحصول على التجربة الكاملة. راجع [Windows](/platforms/windows).
|
||||
هل تحتاج إلى تثبيت Node؟ راجع [إعداد Node](/install/node).
|
||||
</Tip>
|
||||
|
||||
## إعداد سريع
|
||||
|
||||
<Steps>
|
||||
<Step title="ثبّت OpenClaw">
|
||||
<Tabs>
|
||||
<Tab title="macOS / Linux">
|
||||
```bash
|
||||
curl -fsSL https://openclaw.ai/install.sh | bash
|
||||
```
|
||||
<img
|
||||
src="/assets/install-script.svg"
|
||||
alt="عملية برنامج التثبيت النصي"
|
||||
className="rounded-lg"
|
||||
/>
|
||||
</Tab>
|
||||
<Tab title="Windows (PowerShell)">
|
||||
```powershell
|
||||
iwr -useb https://openclaw.ai/install.ps1 | iex
|
||||
```
|
||||
</Tab>
|
||||
</Tabs>
|
||||
|
||||
<Note>
|
||||
طرق تثبيت أخرى (Docker وNix وnpm): [التثبيت](/install).
|
||||
</Note>
|
||||
|
||||
</Step>
|
||||
<Step title="شغّل الإعداد التمهيدي">
|
||||
```bash
|
||||
openclaw onboard --install-daemon
|
||||
```
|
||||
|
||||
يرشدك المعالج خلال اختيار موفّر نموذج، وتعيين مفتاح API، وتهيئة Gateway. يستغرق ذلك نحو دقيقتين.
|
||||
|
||||
راجع [الإعداد التمهيدي (CLI)](/start/wizard) للحصول على المرجع الكامل.
|
||||
|
||||
</Step>
|
||||
<Step title="تحقق من أن Gateway يعمل">
|
||||
```bash
|
||||
openclaw gateway status
|
||||
```
|
||||
|
||||
يجب أن ترى أن Gateway يستمع على المنفذ 18789.
|
||||
|
||||
</Step>
|
||||
<Step title="افتح لوحة التحكم">
|
||||
```bash
|
||||
openclaw dashboard
|
||||
```
|
||||
|
||||
سيؤدي هذا إلى فتح واجهة التحكم في متصفحك. إذا تم تحميلها، فهذا يعني أن كل شيء يعمل.
|
||||
|
||||
</Step>
|
||||
<Step title="أرسل أول رسالة لك">
|
||||
اكتب رسالة في دردشة واجهة التحكم، ويُفترض أن تحصل على رد من الذكاء الاصطناعي.
|
||||
|
||||
هل تريد الدردشة من هاتفك بدلًا من ذلك؟ أسرع قناة للإعداد هي
|
||||
[Telegram](/channels/telegram) (مجرد رمز bot مميز). راجع [القنوات](/channels)
|
||||
للاطلاع على جميع الخيارات.
|
||||
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
<Accordion title="متقدم: تحميل إصدار مخصص من واجهة التحكم">
|
||||
إذا كنت تحتفظ بإصدار مترجم أو مخصص من لوحة التحكم، فوجّه
|
||||
`gateway.controlUi.root` إلى دليل يحتوي على الأصول الثابتة
|
||||
المضمّنة و`index.html`.
|
||||
|
||||
```bash
|
||||
mkdir -p "$HOME/.openclaw/control-ui-custom"
|
||||
# انسخ ملفاتك الثابتة المضمّنة إلى ذلك الدليل.
|
||||
```
|
||||
|
||||
ثم عيّن:
|
||||
|
||||
```json
|
||||
{
|
||||
"gateway": {
|
||||
"controlUi": {
|
||||
"enabled": true,
|
||||
"root": "$HOME/.openclaw/control-ui-custom"
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
أعد تشغيل gateway ثم أعد فتح لوحة التحكم:
|
||||
|
||||
```bash
|
||||
openclaw gateway restart
|
||||
openclaw dashboard
|
||||
```
|
||||
|
||||
</Accordion>
|
||||
|
||||
## ماذا تفعل بعد ذلك
|
||||
|
||||
<Columns>
|
||||
<Card title="صِل قناة" href="/channels" icon="message-square">
|
||||
Discord وFeishu وiMessage وMatrix وMicrosoft Teams وSignal وSlack وTelegram وWhatsApp وZalo والمزيد.
|
||||
</Card>
|
||||
<Card title="الاقتران والأمان" href="/channels/pairing" icon="shield">
|
||||
تحكم فيمن يمكنه مراسلة وكيلك.
|
||||
</Card>
|
||||
<Card title="هيّئ Gateway" href="/gateway/configuration" icon="settings">
|
||||
النماذج والأدوات وsandbox والإعدادات المتقدمة.
|
||||
</Card>
|
||||
<Card title="تصفح الأدوات" href="/tools" icon="wrench">
|
||||
المتصفح وexec والبحث على الويب وSkills والإضافات.
|
||||
</Card>
|
||||
</Columns>
|
||||
|
||||
<Accordion title="متقدم: متغيرات البيئة">
|
||||
إذا كنت تشغّل OpenClaw كحساب خدمة أو تريد مسارات مخصصة:
|
||||
|
||||
- `OPENCLAW_HOME` — الدليل الرئيسي لحل المسارات الداخلية
|
||||
- `OPENCLAW_STATE_DIR` — تجاوز دليل الحالة
|
||||
- `OPENCLAW_CONFIG_PATH` — تجاوز مسار ملف الإعدادات
|
||||
|
||||
المرجع الكامل: [متغيرات البيئة](/help/environment).
|
||||
</Accordion>
|
||||
134
docs/ar/start/wizard.md
Normal file
134
docs/ar/start/wizard.md
Normal file
@ -0,0 +1,134 @@
|
||||
---
|
||||
read_when:
|
||||
- تشغيل الإعداد التمهيدي عبر CLI أو تهيئته
|
||||
- إعداد جهاز جديد
|
||||
sidebarTitle: 'Onboarding: CLI'
|
||||
summary: 'الإعداد التمهيدي عبر CLI: إعداد موجّه للبوابة ومساحة العمل والقنوات وSkills'
|
||||
title: الإعداد التمهيدي (CLI)
|
||||
x-i18n:
|
||||
generated_at: "2026-04-05T11:37:03Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 81e33fb4f8be30e7c2c6e0024bf9bdcf48583ca58eaf5fff5afd37a1cd628523
|
||||
source_path: start/wizard.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# الإعداد التمهيدي (CLI)
|
||||
|
||||
يُعد الإعداد التمهيدي عبر CLI الطريقة **الموصى بها** لإعداد OpenClaw على macOS،
|
||||
وLinux، أو Windows (عبر WSL2؛ موصى به بشدة).
|
||||
وهو يهيّئ Gateway محليًا أو اتصالًا بـ Gateway بعيد، بالإضافة إلى القنوات وSkills،
|
||||
وإعدادات مساحة العمل الافتراضية ضمن تدفق موجّه واحد.
|
||||
|
||||
```bash
|
||||
openclaw onboard
|
||||
```
|
||||
|
||||
<Info>
|
||||
أسرع طريقة لأول محادثة: افتح واجهة التحكم (لا حاجة إلى إعداد قناة). شغّل
|
||||
`openclaw dashboard` وابدأ الدردشة في المتصفح. الوثائق: [لوحة التحكم](/web/dashboard).
|
||||
</Info>
|
||||
|
||||
لإعادة التهيئة لاحقًا:
|
||||
|
||||
```bash
|
||||
openclaw configure
|
||||
openclaw agents add <name>
|
||||
```
|
||||
|
||||
<Note>
|
||||
لا يعني `--json` وضع عدم التفاعل تلقائيًا. بالنسبة إلى السكربتات، استخدم `--non-interactive`.
|
||||
</Note>
|
||||
|
||||
<Tip>
|
||||
يتضمن الإعداد التمهيدي عبر CLI خطوة للبحث على الويب يمكنك فيها اختيار موفّر
|
||||
مثل Brave أو DuckDuckGo أو Exa أو Firecrawl أو Gemini أو Grok أو Kimi أو MiniMax Search،
|
||||
أو Ollama Web Search أو Perplexity أو SearXNG أو Tavily. تتطلب بعض الموفّرات
|
||||
مفتاح API، بينما لا يتطلب بعضها الآخر أي مفتاح. يمكنك أيضًا تهيئة ذلك لاحقًا باستخدام
|
||||
`openclaw configure --section web`. الوثائق: [أدوات الويب](/tools/web).
|
||||
</Tip>
|
||||
|
||||
## QuickStart مقابل Advanced
|
||||
|
||||
يبدأ الإعداد التمهيدي بخيار **QuickStart** (الإعدادات الافتراضية) مقابل **Advanced** (تحكم كامل).
|
||||
|
||||
<Tabs>
|
||||
<Tab title="QuickStart (الإعدادات الافتراضية)">
|
||||
- Gateway محلي (loopback)
|
||||
- مساحة العمل الافتراضية (أو مساحة عمل موجودة)
|
||||
- منفذ Gateway **18789**
|
||||
- مصادقة Gateway باستخدام **Token** (يُنشأ تلقائيًا، حتى على loopback)
|
||||
- سياسة الأدوات الافتراضية للإعدادات المحلية الجديدة: `tools.profile: "coding"` (يتم الاحتفاظ بأي profile صريح موجود)
|
||||
- إعداد عزل الرسائل المباشرة الافتراضي: يكتب الإعداد التمهيدي المحلي `session.dmScope: "per-channel-peer"` عندما لا يكون معيّنًا. التفاصيل: [مرجع إعداد CLI](/start/wizard-cli-reference#outputs-and-internals)
|
||||
- إتاحة Tailscale **معطلة**
|
||||
- تكون الرسائل المباشرة في Telegram وWhatsApp افتراضيًا ضمن **قائمة السماح** (سيُطلب منك رقم هاتفك)
|
||||
</Tab>
|
||||
<Tab title="Advanced (تحكم كامل)">
|
||||
- يكشف كل خطوة (الوضع، مساحة العمل، Gateway، القنوات، daemon، Skills).
|
||||
</Tab>
|
||||
</Tabs>
|
||||
|
||||
## ما الذي يهيئه الإعداد التمهيدي
|
||||
|
||||
**الوضع المحلي (الافتراضي)** يرشدك خلال هذه الخطوات:
|
||||
|
||||
1. **النموذج/المصادقة** — اختر أي موفّر/تدفق مصادقة مدعوم (مفتاح API، أو OAuth، أو مصادقة يدوية خاصة بالموفّر)، بما في ذلك Custom Provider
|
||||
(متوافق مع OpenAI، أو متوافق مع Anthropic، أو Unknown مع اكتشاف تلقائي). اختر نموذجًا افتراضيًا.
|
||||
ملاحظة أمنية: إذا كان هذا الوكيل سيشغّل أدوات أو يعالج محتوى webhook/hooks، ففضّل أقوى نموذج متاح من الجيل الأحدث، وأبقِ سياسة الأدوات صارمة. تكون الفئات الأضعف/الأقدم أسهل في حقن المطالبات فيها.
|
||||
بالنسبة إلى عمليات التشغيل غير التفاعلية، يخزّن `--secret-input-mode ref` مراجع مدعومة بالبيئة داخل ملفات تعريف المصادقة بدلًا من قيم مفاتيح API النصية الصريحة.
|
||||
في وضع `ref` غير التفاعلي، يجب تعيين متغير البيئة الخاص بالموفّر؛ ويفشل التمرير المضمن لعلامات المفتاح من دون متغير البيئة هذا مباشرة.
|
||||
في عمليات التشغيل التفاعلية، يتيح لك اختيار وضع المرجع السري الإشارة إما إلى متغير بيئة أو إلى مرجع موفّر مُهيأ (`file` أو `exec`) مع تحقق تمهيدي سريع قبل الحفظ.
|
||||
بالنسبة إلى Anthropic، يوفّر الإعداد التمهيدي/التهيئة التفاعلية **Anthropic Claude CLI** كخيار احتياطي محلي و**مفتاح Anthropic API** كمسار الإنتاج الموصى به. أصبح Anthropic setup-token متاحًا أيضًا مرة أخرى كمسار OpenClaw قديم/يدوي، مع توقّع **Extra Usage** الخاص بـ OpenClaw في الفوترة لدى Anthropic.
|
||||
2. **مساحة العمل** — موقع ملفات الوكيل (الافتراضي `~/.openclaw/workspace`). يملأ ملفات bootstrap الأولية.
|
||||
3. **Gateway** — المنفذ، وعنوان الربط، ووضع المصادقة، وإتاحة Tailscale.
|
||||
في وضع token التفاعلي، اختر تخزين token النصي الصريح الافتراضي أو انتقل إلى SecretRef.
|
||||
مسار SecretRef الخاص بـ token في الوضع غير التفاعلي: `--gateway-token-ref-env <ENV_VAR>`.
|
||||
4. **القنوات** — قنوات الدردشة المضمنة والمجمعة مثل BlueBubbles وDiscord وFeishu وGoogle Chat وMattermost وMicrosoft Teams وQQ Bot وSignal وSlack وTelegram وWhatsApp والمزيد.
|
||||
5. **Daemon** — يثبّت LaunchAgent (على macOS)، أو وحدة systemd للمستخدم (على Linux/WSL2)، أو Scheduled Task أصليًا في Windows مع بديل لكل مستخدم في مجلد Startup.
|
||||
إذا كانت مصادقة token تتطلب token وكان `gateway.auth.token` مُدارًا عبر SecretRef، فإن تثبيت daemon يتحقق منه لكنه لا يستمر في حفظ token الذي تم حلّه داخل بيانات بيئة الخدمة التابعة للمشرف.
|
||||
إذا كانت مصادقة token تتطلب token وكان SecretRef المهيأ لـ token غير قابل للحل، فسيُحظر تثبيت daemon مع إرشادات قابلة للتنفيذ.
|
||||
إذا كان كل من `gateway.auth.token` و`gateway.auth.password` مهيأين وكانت `gateway.auth.mode` غير معيّنة، فسيُحظر تثبيت daemon حتى يتم تعيين الوضع صراحة.
|
||||
6. **فحص السلامة** — يشغّل Gateway ويتحقق من أنه يعمل.
|
||||
7. **Skills** — يثبّت Skills الموصى بها والاعتماديات الاختيارية.
|
||||
|
||||
<Note>
|
||||
إن إعادة تشغيل الإعداد التمهيدي **لا** تمسح أي شيء ما لم تختر **Reset** صراحةً (أو تمرر `--reset`).
|
||||
يستخدم `--reset` في CLI افتراضيًا النطاقات config وcredentials وsessions؛ استخدم `--reset-scope full` لتضمين مساحة العمل.
|
||||
إذا كانت الإعدادات غير صالحة أو تحتوي على مفاتيح قديمة، فسيطلب منك الإعداد التمهيدي تشغيل `openclaw doctor` أولًا.
|
||||
</Note>
|
||||
|
||||
**الوضع البعيد** يهيّئ العميل المحلي فقط للاتصال بـ Gateway موجود في مكان آخر.
|
||||
وهو **لا** يثبت أو يغيّر أي شيء على المضيف البعيد.
|
||||
|
||||
## إضافة وكيل آخر
|
||||
|
||||
استخدم `openclaw agents add <name>` لإنشاء وكيل منفصل له مساحة العمل الخاصة به،
|
||||
وجلساته، وملفات تعريف المصادقة الخاصة به. يؤدي التشغيل من دون `--workspace` إلى بدء الإعداد التمهيدي.
|
||||
|
||||
ما الذي يعيّنه:
|
||||
|
||||
- `agents.list[].name`
|
||||
- `agents.list[].workspace`
|
||||
- `agents.list[].agentDir`
|
||||
|
||||
ملاحظات:
|
||||
|
||||
- تتبع مساحات العمل الافتراضية النمط `~/.openclaw/workspace-<agentId>`.
|
||||
- أضف `bindings` لتوجيه الرسائل الواردة (يمكن للإعداد التمهيدي تنفيذ ذلك).
|
||||
- علامات الوضع غير التفاعلي: `--model` و`--agent-dir` و`--bind` و`--non-interactive`.
|
||||
|
||||
## المرجع الكامل
|
||||
|
||||
للاطلاع على تفصيلات خطوة بخطوة ومخرجات الإعدادات، راجع
|
||||
[مرجع إعداد CLI](/start/wizard-cli-reference).
|
||||
وللحصول على أمثلة غير تفاعلية، راجع [أتمتة CLI](/start/wizard-cli-automation).
|
||||
وللمرجع التقني الأعمق، بما في ذلك تفاصيل RPC، راجع
|
||||
[مرجع الإعداد التمهيدي](/reference/wizard).
|
||||
|
||||
## الوثائق ذات الصلة
|
||||
|
||||
- مرجع أوامر CLI: [`openclaw onboard`](/cli/onboard)
|
||||
- نظرة عامة على الإعداد التمهيدي: [نظرة عامة على الإعداد التمهيدي](/start/onboarding-overview)
|
||||
- الإعداد التمهيدي لتطبيق macOS: [الإعداد التمهيدي](/start/onboarding)
|
||||
- طقس التشغيل الأول للوكيل: [التهيئة الأولية للوكيل](/start/bootstrapping)
|
||||
@ -2414,6 +2414,29 @@
|
||||
]
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"language": "ar",
|
||||
"tabs": [
|
||||
{
|
||||
"tab": "ابدأ",
|
||||
"groups": [
|
||||
{
|
||||
"group": "نظرة عامة",
|
||||
"pages": [
|
||||
"ar/index"
|
||||
]
|
||||
},
|
||||
{
|
||||
"group": "الخطوات الأولى",
|
||||
"pages": [
|
||||
"ar/start/getting-started",
|
||||
"ar/start/wizard"
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
|
||||
Loading…
Reference in New Issue
Block a user