IronClaw

مساعدك الشخصي الآمن للذكاء الاصطناعي، دائمًا إلى جانبك

English | 简体中文 | Русский | 日本語 | 한국어

بداية سريعة لـ Reborn • الفلسفة • الميزات • التثبيت • الإعدادات • الأمان • المعمارية

---

بداية سريعة لـ IronClaw Reborn

إن إعادة ولادة IronClaw (IronClaw Reborn) هي بيئة التشغيل المستقلة على الفرع reborn-integration. إنها تستخدم الثنائي المنفصل ironclaw-reborn من الحزمة ironclaw_reborn_cli وجذر حالة منفصل لـ Reborn. إنها لا تستخدم دليل الحالة القديم ironclaw كجذر التكوين.

بالنسبة للثنائي الأقدم ironclaw، انظر التثبيت و استخدام IronClaw القديم.

بناء أو تشغيل الثنائي

من جذر المستودع:```bash cargo run -q -p ironclaw_reborn_cli --bin ironclaw-reborn -- --help

أو قم ببنائه أولاً:```bash
cargo build -p ironclaw_reborn_cli --bin ironclaw-reborn
./target/debug/ironclaw-reborn --help

المنزل الافتراضي لـ Reborn هو $HOME/.ironclaw/reborn. قم بتجاوزه بمسار مطلق عندما تريد حالة معزولة:```bash export IRONCLAW_REBORN_HOME="$PWD/.reborn-home" cargo run -q -p ironclaw_reborn_cli --bin ironclaw-reborn -- config path

`config path` و `doctor` هما تشخيصان آمنان؛ يبلغان عن المسار الرئيسي المُحلّ، والملف الشخصي، و `config.toml`، و `providers.json`، و `v1_state: not-used`.
لا يقومان بإنشاء حالة Reborn أو ملفات تهيئة أولية.

### تكوين مسار النموذج

الطريقة الأصلية لسطر الأوامر لتكوين مسار النموذج الافتراضي لـ Reborn هي:```bash
export IRONCLAW_REBORN_HOME="$PWD/.reborn-home"
cargo run -q -p ironclaw_reborn_cli --bin ironclaw-reborn -- models set-provider openai --model gpt-5-mini

يؤدي ذلك إلى كتابة $IRONCLAW_REBORN_HOME/config.toml مع [llm.default] واسم متغير البيئة الخاص ببيانات اعتماد المزوّد. تحقق منه باستخدام:```bash cargo run -q -p ironclaw_reborn_cli --bin ironclaw-reborn -- models status cargo run -q -p ironclaw_reborn_cli --bin ironclaw-reborn -- models list openai

بالنسبة لـ OpenAI، قم بتعيين القيمة السرية في البيئة قبل البدء:```bash
export OPENAI_API_KEY="sk-..."
cargo run -q -p ironclaw_reborn_cli --bin ironclaw-reborn -- run --message "hello"

احذف --message أو استخدم repl لجلسة stdin تفاعلية:```bash cargo run -q -p ironclaw_reborn_cli --bin ironclaw-reborn -- repl

### `config.toml` شكل

`config init` ينشئ ملفات بداية قابلة للتعديل:```bash
cargo run -q -p ironclaw_reborn_cli --bin ironclaw-reborn -- config init

يكتب:

• $IRONCLAW_REBORN_HOME/config.toml
• $IRONCLAW_REBORN_HOME/providers.json

يبدو نموذج توجيه تم تكوينه بشكل أدنى كالتالي:```toml [llm.default] provider_id = "openai" model = "gpt-5-mini" api_key_env = "OPENAI_API_KEY"

`config.toml` may also include optional sections such as `[boot]`,
`[identity]`, `[runner]`, and `[skills]`; `config init` writes commented
guidance for the supported fields.

If `config.toml` is missing, the first stateful runtime start through `run`,
`repl`, or `serve` seeds a sparse file with `api_version` and the safe
`local-dev` boot profile. Read-only commands and `run --dry-run` stay
side-effect-free. One-off environment selections such as
`IRONCLAW_REBORN_PROFILE=local-dev-yolo` are not persisted into the seeded
file.

Important: `api_key_env` is the name of an environment variable, not the secret
itself. Reborn rejects inline secret-shaped values in `config.toml` and
`providers.json`.

Production storage uses the same env-only pattern. A production Reborn config
may name the PostgreSQL URL variable, but must not contain the raw URL:```toml
[storage]
backend = "postgres"
url_env = "IRONCLAW_REBORN_POSTGRES_URL"
secret_master_key_env = "IRONCLAW_REBORN_SECRET_MASTER_KEY"
# Optional; defaults to 2. Keep below the PostgreSQL server or managed
# session-pool cap after reserving capacity for restarts and operator sessions.
pool_max_size = 2

[policy]
deployment_mode = "hosted_multi_tenant"
default_profile = "secure_default"

قم بتعيين IRONCLAW_REBORN_POSTGRES_URL في بيئة العملية، وقم بتعيين IRONCLAW_REBORN_SECRET_MASTER_KEY إلى مادة مفتاح تشفير مستقلة. يجب على مزودي PostgreSQL المُدار عن بُعد استخدام TLS، على سبيل المثال بإضافة sslmode=require. يتطلب تشغيل run في الإنتاج أيضًا قسم [policy] صريح. تدعم شريحة الإطلاق الأولى في الإنتاج سياسات وقت التشغيل التي لا تتطلب ربط عملية بحاوية المستأجر (tenant-sandbox).

بمجرد وجود [llm.default]، يختار هذا الإعداد المزود. LLM_BACKEND هو مجرد fallback للبيئة عندما لا يتم تكوين فتحة LLM افتراضية. لتبديل المزودين بعد كتابة الإعدادات، استخدم models set-provider <provider> أو حرّر [llm.default].provider_id.

اختيار النموذج باستخدام البيئة فقط

إذا كان $IRONCLAW_REBORN_HOME/config.toml غير موجود أو لا يحتوي على [llm.default]، يمكن لـ Reborn حل LLM من متغيرات البيئة. لا يتضمن الإعداد الأولي المزروع (seeded config) [llm.default]، لذلك يستمر اختيار النموذج باستخدام البيئة فقط في العمل:```bash export IRONCLAW_REBORN_HOME="$PWD/.reborn-env-only" export LLM_BACKEND=openai export OPENAI_API_KEY="sk-..." cargo run -q -p ironclaw_reborn_cli --bin ironclaw-reborn -- run --message "hello"

متغيرات البيئة الشائعة للمزوّد:

| المزوّد | المحدّد | البيئة المطلوبة |
| --- | --- | --- |
| OpenAI | `LLM_BACKEND=openai` | `OPENAI_API_KEY`؛ اختياري `OPENAI_MODEL`، `OPENAI_BASE_URL` |
| Anthropic | `LLM_BACKEND=anthropic` | `ANTHROPIC_API_KEY`؛ اختياري `ANTHROPIC_MODEL`، `ANTHROPIC_BASE_URL` |
| متوافق مع OpenAI | `LLM_BACKEND=openai_compatible` | `LLM_BASE_URL`؛ اختياري `LLM_API_KEY`، `LLM_MODEL` |
| OpenRouter | `LLM_BACKEND=openrouter` | `OPENROUTER_API_KEY`؛ اختياري `OPENROUTER_MODEL` |
| Ollama | `LLM_BACKEND=ollama` | لا يوجد مفتاح؛ اختياري `OLLAMA_BASE_URL`، `OLLAMA_MODEL` |
| Codex auth | `LLM_BACKEND=openai_codex` | `LLM_USE_CODEX_AUTH=true` أو `CODEX_AUTH_PATH`؛ اختياري `OPENAI_CODEX_MODEL` |

استخدم `models list <provider>` لرؤية بيانات المزوّد الدقيقة المجمّعة في
الفرع الحالي.

### متغيرات بدء التشغيل