Community translations by veiseule.ai — Help improve them on Crowdin
Skip to main content

آن بورڈنگ وزارڈ حوالہ

  1. یہ openclaw onboard CLI ویزرڈ کے لیے مکمل حوالہ ہے۔
  2. اعلیٰ سطحی جائزے کے لیے، دیکھیں Onboarding Wizard۔

فلو کی تفصیلات (لوکل موڈ)

49. - اگر ~/.openclaw/openclaw.json موجود ہو تو Keep / Modify / Reset منتخب کریں۔ 50. - ویزرڈ کو دوبارہ چلانے سے کچھ بھی صاف نہیں ہوتا جب تک کہ آپ واضح طور پر Reset منتخب نہ کریں (یا --reset پاس نہ کریں)۔ - اگر کنفیگ غلط ہو یا اس میں لیگیسی کیز شامل ہوں تو وزارڈ رک جاتا ہے اور آپ سے کہتا ہے کہ آگے بڑھنے سے پہلے openclaw doctor چلائیں۔ - ری سیٹ میں trash استعمال ہوتا ہے (rm کبھی نہیں) اور اسکوپس فراہم کیے جاتے ہیں: - صرف کنفیگ - کنفیگ + اسناد + سیشنز - مکمل ری سیٹ (ورک اسپیس بھی ہٹا دی جاتی ہے)
 - Anthropic API key (تجویز کردہ): اگر موجود ہو تو ANTHROPIC_API_KEY استعمال کرتا ہے یا کلید مانگتا ہے، پھر اسے ڈیمون کے استعمال کے لیے محفوظ کر لیتا ہے۔ - Anthropic OAuth (Claude Code CLI): macOS پر وزارڈ Keychain آئٹم "Claude Code-credentials" چیک کرتا ہے ("Always Allow" منتخب کریں تاکہ launchd اسٹارٹس بلاک نہ ہوں)؛ Linux/Windows پر اگر موجود ہو تو ~/.claude/.credentials.json دوبارہ استعمال کرتا ہے۔ - Anthropic ٹوکن (setup-token پیسٹ کریں): کسی بھی مشین پر claude setup-token چلائیں، پھر ٹوکن پیسٹ کریں (آپ اسے نام دے سکتے ہیں؛ خالی = ڈیفالٹ). - OpenAI Code (Codex) سبسکرپشن (Codex CLI): اگر ~/.codex/auth.json موجود ہو تو وزارڈ اسے دوبارہ استعمال کر سکتا ہے۔ - OpenAI Code (Codex) سبسکرپشن (OAuth): براؤزر فلو؛ code#state پیسٹ کریں. - جب ماڈل سیٹ نہ ہو یا openai/* ہو تو agents.defaults.model کو openai-codex/gpt-5.2 پر سیٹ کرتا ہے۔ - OpenAI API key: اگر موجود ہو تو OPENAI_API_KEY استعمال کرتا ہے یا کلید مانگتا ہے، پھر اسے ~/.openclaw/.env میں محفوظ کرتا ہے تاکہ launchd اسے پڑھ سکے۔ - xAI (Grok) API key: XAI_API_KEY کے لیے پرامپٹ کرتا ہے اور xAI کو ماڈل فراہم کنندہ کے طور پر کنفیگر کرتا ہے۔ - OpenCode Zen (ملٹی ماڈل پراکسی): OPENCODE_API_KEY (یا OPENCODE_ZEN_API_KEY، اسے https://opencode.ai/auth سے حاصل کریں) کے لیے پرامپٹ کرتا ہے. - API key: آپ کے لیے کلید محفوظ کرتا ہے۔ - Vercel AI Gateway (ملٹی-ماڈل پراکسی): AI_GATEWAY_API_KEY کے لیے پرامپٹ کرتا ہے۔ - مزید تفصیل: Vercel AI Gateway - Cloudflare AI Gateway: اکاؤنٹ ID، گیٹ وے ID، اور CLOUDFLARE_AI_GATEWAY_API_KEY کے لیے پرامپٹ کرتا ہے۔ - مزید تفصیل: Cloudflare AI Gateway - MiniMax M2.1: کنفیگ خودکار طور پر لکھی جاتی ہے۔ - مزید تفصیل: MiniMax - Synthetic (Anthropic-compatible): SYNTHETIC_API_KEY کے لیے پرامپٹ کرتا ہے۔ - مزید تفصیل: Synthetic - Moonshot (Kimi K2): کنفیگ خودکار طور پر لکھی جاتی ہے۔ - Kimi Coding: کنفیگ خودکار طور پر لکھی جاتی ہے۔ - مزید تفصیل: Moonshot AI (Kimi + Kimi Coding) - Skip: ابھی کوئی آتھنٹیکیشن کنفیگر نہیں کی جاتی۔ - دریافت شدہ آپشنز میں سے ڈیفالٹ ماڈل منتخب کریں (یا فراہم کنندہ/ماڈل دستی طور پر درج کریں)۔ - وزارڈ ماڈل چیک چلاتا ہے اور اگر کنفیگر کیا گیا ماڈل نامعلوم ہو یا آتھنٹیکیشن غائب ہو تو وارن کرتا ہے۔ - OAuth اسناد ~/.openclaw/credentials/oauth.json میں محفوظ ہوتی ہیں؛ auth پروفائلز ~/.openclaw/agents/<agentId>/agent/auth-profiles.json میں محفوظ ہوتے ہیں (API کیز + OAuth). - مزید تفصیل: /concepts/oauth
ہیڈلیس/سرور مشورہ: براؤزر والی مشین پر OAuth مکمل کریں، پھر ~/.openclaw/credentials/oauth.json (یا $OPENCLAW_STATE_DIR/credentials/oauth.json) کو گیٹ وے ہوسٹ پر کاپی کریں۔ - ڈیفالٹ ~/.openclaw/workspace (کنفیگریبل)۔ - ایجنٹ کے بوٹسٹریپ مرحلے کے لیے درکار ورک اسپیس فائلیں تیار کرتا ہے۔ - مکمل ورک اسپیس لے آؤٹ + بیک اپ گائیڈ: Agent workspace
 - پورٹ، بائنڈ، آتھ موڈ، ٹیل اسکیل ایکسپوژر۔ - آتھ کی سفارش: لوپ بیک کے لیے بھی Token برقرار رکھیں تاکہ لوکل WS کلائنٹس کو آتھنٹیکیٹ کرنا پڑے۔ - آتھ صرف اسی صورت میں غیر فعال کریں جب آپ ہر لوکل پروسیس پر مکمل بھروسہ رکھتے ہوں۔ - نان-لوپ بیک بائنڈز کے لیے بھی آتھ درکار ہے۔ - WhatsApp: اختیاری QR لاگ اِن۔ - Telegram: بوٹ ٹوکن۔ - Discord: بوٹ ٹوکن۔ - Google Chat: سروس اکاؤنٹ JSON + ویب ہوک آڈیئنس۔ - Mattermost (پلگ اِن): بوٹ ٹوکن + بیس URL۔ - Signal: اختیاری signal-cli انسٹال + اکاؤنٹ کنفیگ۔ - BlueBubbles: iMessage کے لیے تجویز کردہ؛ سرور URL + پاس ورڈ + ویب ہوک۔ - iMessage: لیگیسی imsg CLI پاتھ + DB ایکسس۔ - DM سیکیورٹی: ڈیفالٹ پیئرنگ ہے۔ پہلا DM ایک کوڈ بھیجتا ہے؛ openclaw pairing approve <channel><code> کے ذریعے منظوری دیں یا allowlists استعمال کریں۔ or use allowlists. </Step> <Step title="Daemon install"> - macOS: LaunchAgent - لاگ اِن شدہ یوزر سیشن درکار؛ ہیڈلیس کے لیے کسٹم LaunchDaemon استعمال کریں (شپ نہیں کیا گیا)۔ - Linux (اور Windows بذریعہ WSL2): systemd یوزر یونٹ - وزارڈloginctl enable-linger کے ذریعے لِنگرنگ فعال کرنے کی کوشش کرتا ہے تاکہ لاگ آؤٹ کے بعد بھی گیٹ وے چلتا رہے۔ - sudo کے لیے پرامپٹ ہو سکتا ہے (/var/lib/systemd/lingerلکھتا ہے)؛ پہلے sudo کے بغیر کوشش کرتا ہے۔ - **Runtime انتخاب:** Node (تجویز کردہ؛ WhatsApp/Telegram کے لیے درکار)۔ Bun **تجویز نہیں کیا جاتا**۔ </Step> <Step title="Health check"> - گیٹ وے شروع کرتا ہے (اگر ضرورت ہو) اورopenclaw healthچلاتا ہے۔ - ٹِپ:openclaw status --deep` اسٹیٹس آؤٹ پٹ میں گیٹ وے ہیلتھ پروبز شامل کرتا ہے (قابلِ رسائی گیٹ وے درکار)۔ - دستیاب اسکلز پڑھتا ہے اور تقاضوں کی جانچ کرتا ہے۔ - آپ کو نوڈ مینیجر منتخب کرنے دیتا ہے: npm / pnpm (bun کی سفارش نہیں کی جاتی). - اختیاری ڈیپنڈنسیز انسٹال کرتا ہے (کچھ macOS پر Homebrew استعمال کرتی ہیں)۔ - خلاصہ + اگلے اقدامات، جن میں اضافی خصوصیات کے لیے iOS/Android/macOS ایپس شامل ہیں.

اگر کوئی GUI دریافت نہ ہو، تو وزرڈ براؤزر کھولنے کے بجائے Control UI کے لیے SSH پورٹ-فارورڈ ہدایات پرنٹ کرتا ہے۔ If the Control UI assets are missing, the wizard attempts to build them; fallback is pnpm ui:build (auto-installs UI deps).

نان اِنٹرایکٹو موڈ

آن بورڈنگ کو خودکار یا اسکرپٹ کرنے کے لیے --non-interactive استعمال کریں:

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice apiKey \
  --anthropic-api-key "$ANTHROPIC_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback \
  --install-daemon \
  --daemon-runtime node \
  --skip-skills

مشین‑ریڈیبل خلاصہ کے لیے --json شامل کریں۔

--json does not imply non-interactive mode. Use --non-interactive (and --workspace) for scripts.

bash openclaw onboard --non-interactive \ --mode local \ --auth-choice gemini-api-key \ --gemini-api-key "$GEMINI_API_KEY" \ --gateway-port 18789 \ --gateway-bind loopback bash openclaw onboard --non-interactive \ --mode local \ --auth-choice zai-api-key \ --zai-api-key "$ZAI_API_KEY" \ --gateway-port 18789 \ --gateway-bind loopback bash openclaw onboard --non-interactive \ --mode local \ --auth-choice ai-gateway-api-key \ --ai-gateway-api-key "$AI_GATEWAY_API_KEY" \ --gateway-port 18789 \ --gateway-bind loopback bash openclaw onboard --non-interactive \ --mode local \ --auth-choice cloudflare-ai-gateway-api-key \ --cloudflare-ai-gateway-account-id "your-account-id" \ --cloudflare-ai-gateway-gateway-id "your-gateway-id" \ --cloudflare-ai-gateway-api-key "$CLOUDFLARE_AI_GATEWAY_API_KEY" \ --gateway-port 18789 \ --gateway-bind loopback bash openclaw onboard --non-interactive \ --mode local \ --auth-choice moonshot-api-key \ --moonshot-api-key "$MOONSHOT_API_KEY" \ --gateway-port 18789 \ --gateway-bind loopback bash openclaw onboard --non-interactive \ --mode local \ --auth-choice synthetic-api-key \ --synthetic-api-key "$SYNTHETIC_API_KEY" \ --gateway-port 18789 \ --gateway-bind loopback bash openclaw onboard --non-interactive \ --mode local \ --auth-choice opencode-zen \ --opencode-zen-api-key "$OPENCODE_API_KEY" \ --gateway-port 18789 \ --gateway-bind loopback

ایجنٹ شامل کریں (نان اِنٹرایکٹو)

openclaw agents add work \
  --workspace ~/.openclaw/workspace-work \
  --model openai/gpt-5.2 \
  --bind whatsapp:biz \
  --non-interactive \
  --json

Gateway وزارڈ RPC

The Gateway exposes the wizard flow over RPC (wizard.start, wizard.next, wizard.cancel, wizard.status). Clients (macOS app, Control UI) can render steps without re‑implementing onboarding logic.

Signal سیٹ اپ (signal-cli)

وزارڈ GitHub ریلیزز سے signal-cli انسٹال کر سکتا ہے:

  • مناسب ریلیز اثاثہ ڈاؤن لوڈ کرتا ہے۔
  • اسے ~/.openclaw/tools/signal-cli/<version>/ کے تحت محفوظ کرتا ہے۔
  • آپ کی کنفیگ میں channels.signal.cliPath لکھتا ہے۔

نوٹس:

  • JVM بلڈز کے لیے Java 21 درکار ہے۔
  • جہاں دستیاب ہو، نیٹو بلڈز استعمال کیے جاتے ہیں۔
  • Windows WSL2 استعمال کرتا ہے؛ signal-cli انسٹال WSL کے اندر Linux فلو کے مطابق ہوتی ہے۔

وزارڈ کیا لکھتا ہے

~/.openclaw/openclaw.json میں عام فیلڈز:

  • agents.defaults.workspace
  • agents.defaults.model / models.providers (اگر Minimax منتخب ہو)
  • gateway.* (موڈ، bind، auth، tailscale)
  • channels.telegram.botToken, channels.discord.token, channels.signal.*, channels.imessage.*
  • چینل allowlists (Slack/Discord/Matrix/Microsoft Teams) جب آپ پرامپٹس کے دوران opt in کریں (نام جہاں ممکن ہو IDs میں resolve ہوتے ہیں)۔
  • skills.install.nodeManager
  • wizard.lastRunAt
  • wizard.lastRunVersion
  • wizard.lastRunCommit
  • wizard.lastRunCommand
  • wizard.lastRunMode

openclaw agents add، agents.list[] اور اختیاری bindings لکھتا ہے۔

WhatsApp credentials go under ~/.openclaw/credentials/whatsapp/<accountId>/. Sessions are stored under ~/.openclaw/agents/<agentId>/sessions/.

Some channels are delivered as plugins. When you pick one during onboarding, the wizard will prompt to install it (npm or a local path) before it can be configured.

متعلقہ دستاویزات

veiseule.ai — Community translations maintained by John Kelly. Improve translations on Crowdin.