اوپن کلا خود مختار ایجنٹ گائیڈ: فن تعمیر، ڈاکر اور اخراجات

### فوری جواب: اوپن کلا کیا ہے اور یہ کیوں برتر ہے؟

اوپن کلا (OpenClaw) ایک اوپن سورس خود مختار ذاتی AI اسسٹنٹ ہے جو الگ تھلگ گیٹ وے (Gateway) فن تعمیر، 20 سے زائد میسجنگ چینلز اور سینڈ باکسڈ ملٹی ایجنٹ ماحول پر مبنی ہے۔ ماہانہ $20–$50 چارج کرنے والے کمرشل ساس ایجنٹس کے برعکس، اوپن کلا میں کوئی فیس نہیں ($0) اور براہ راست ماڈل API کے ذریعے اوسط فی ٹاسک لاگت صرف $0.003–$0.042 آتی ہے۔

1. جائزہ: 2026 میں اوپن کلا کی اہمیت اور تعارف

2026 میں AI ایجنٹ ٹیکنالوجی نے ایک اہم سنگ میل عبور کیا ہے: ایک بار کے چیٹ پیغامات سے مسلسل، ایونٹ کی بنیاد پر 24 گھنٹے خود مختار کام کرنے والے نظام کی جانب منتقلی۔ جہاں Claude Code اور OpenAI Codex مقامی ڈویلپر ٹرمینل پر مرکوز ہیں، وہیں OpenClaw (سابقہ openclaw.ai) متعدد میسجنگ پلیٹ فارمز، خودکار کرون شیڈولز اور محفوظ ملٹی ایجنٹ ماحول کو سنبھالنے والا سرکردہ اوپن سورس فریم ورک بن چکا ہے۔

اوپن کلا تین بنیادی ستونوں پر مشتمل ہے:

1. الگ تھلگ گیٹ وے پروٹوکول (Gateway Protocol): پورٹ 18789 پر کام کرنے والا مرکزی ڈیمن جو چینل روٹنگ، سیشن ڈیٹا، شیڈولنگ اور ویب ہکس کو منظم کرتا ہے۔
2. 20 سے زائد میسجنگ چینلز کی حمایت: Telegram، WhatsApp (Baileys)، Discord، Slack، Signal، iMessage، Matrix اور WebChat کے ساتھ مکمل رابطہ۔
3. ماڈیولر مہارتیں اور سینڈ باکس تحفظ: ClawHub رجسٹری سے Markdown پر مبنی اسکل معیار (SKILL.md) اور ڈاکر و POSIX پابندیوں کے ساتھ محفوظ رن ٹائم۔

2. اوپن کلا فن تعمیر: گیٹ وے، چینلز اور ورک اسپیس

اوپن کلا کی اصل طاقت اس کا منقسم کلائنٹ سرور نظام ہے۔ مرکزی سروس (OpenClaw Gateway) WebSocket اور Unix ڈومین ساکٹس کے ذریعے مختلف انٹرفیسز کے ساتھ جڑتی ہے۔

+-----------------------------------------------------------------------------------+
|                            بیرونی میسجنگ چینلز                                    |
|   Telegram  |  WhatsApp  |  Discord  |  Slack  |  Signal  |  iMessage  |  Matrix  |
+-----------------------------------------------------------------------------------+
                                          | (Webhook / WebSocket / Bot API)
                                          v
+-----------------------------------------------------------------------------------+
|                            OpenClaw Gateway (Port 18789)                          |
|  - ڈی ایم پیئرنگ اور الاؤ لسٹ تصدیقی انجن  - سیشن کانٹیکسٹ میموری اسٹوریج         |
|  - کرون شیڈیولر انجن (CronTab)            - ویب ہک انٹیک اور روٹنگ                |
|  - فوری ری لوڈ کانفیگ (Hybrid Watch)      - ماڈل فیل اوور اور خودکار تبدیلی       |
+-----------------------------------------------------------------------------------+
       |                                      |                              |
       v                                      v                              v
+------------------+                  +------------------+         +-------------------+
|  ایجنٹ: گھر      |                  |  ایجنٹ: کام      |         |  ایجنٹ: DevOps    |
|  - Workspace-Home|                  |  - Workspace-Work|         |  - Workspace-Ops  |
|  - SOUL.md       |                  |  - SOUL.md       |         |  - SOUL.md        |
|  - ذاتی امور     |                  |  - Jira / Linear |         |  - کلاؤڈ اور SSH  |
+------------------+                  +------------------+         +-------------------+
       |                                      |                              |
       +--------------------------------------+------------------------------+
                                          |
                                          v
+-----------------------------------------------------------------------------------+
|                         ملٹی ایجنٹ سینڈ باکس ماحول                                |
|  - ڈاکر کنٹینر مکمل تنہائی (`mode: non-main` / `mode: all`)                       |
|  - POSIX اختیارات کا خاتمہ (`cap_drop: ALL`، غیر مراعات یافتہ UID 10001)          |
|  - صرف پڑھنے کے لیے والیمز (`:ro`) اور عارضی Tmpfs میموری (`/tmp:noexec`)         |
|  - کلا ہب اسکلز انجن (`SKILL.md` پارسر اور بائنری جانچ)                           |
+-----------------------------------------------------------------------------------+

ورک اسپیس ڈائرکٹری کی ساخت

~/.openclaw/
├── openclaw.json          # بنیادی ترتیبات کی فائل (JSON5 فارمیٹ)
├── cron.json              # شیڈول شدہ کرون ٹاسکس
├── state/                 # سیشنز کے لیے SQLite ڈیٹا بیس
├── skills/                # گلوبل شیئر شدہ مہارتیں
└── workspace/             # ایجنٹ کی مرکزی ورک اسپیس
    ├── AGENTS.md          # ایجنٹ کے عمومی اصول اور ہدایات
    ├── SOUL.md            # شخصیت، لہجہ اور حفاظتی حدود
    ├── TOOLS.md           # لوکل ٹولز کے استعمال کی ہدایات
    └── skills/            # مخصوص مہارتیں
        └── repo-analyzer/
            └── SKILL.md   # مہارت کا وضاحتی کوڈ

گیٹ وے کے بنیادی احکامات

# گیٹ وے کی حالت، پورٹ اور میموری چیک کریں
openclaw gateway status

# گیٹ وے کو بیک گراؤنڈ میں شروع کریں
openclaw gateway start

# تفصیلی لاگز کے ساتھ سامنے چلائیں
openclaw gateway --port 18789 --verbose

# سسٹم کی مکمل جانچ کریں
openclaw doctor

# فائلوں کی اجازتیں خودکار طور پر درست کریں
openclaw doctor --fix

3. پروڈکشن ڈاکر سیلف ہوسٹنگ گائیڈ

کسی بھی AI ایجنٹ کو براہ راست ہوسٹ مشین پر شیل تک رسائی دینا شدید سیکیورٹی خطرات کا باعث بن سکتا ہے۔ اس کے لیے Docker Compose کا استعمال بہترین اور معیاری طریقہ ہے۔

پروڈکشن docker-compose.yml

version: "3.9"

services:
  openclaw-gateway:
    image: ghcr.io/openclaw/openclaw:latest
    container_name: openclaw-gateway
    restart: unless-stopped
    user: "10001:10001"
    security_opt:
      - no-new-privileges:true
    cap_drop:
      - ALL
    cap_add:
      - CHOWN
      - SETUID
      - SETGID
    environment:
      - NODE_ENV=production
      - OPENCLAW_HOME=/home/openclaw/.openclaw
      - OPENCLAW_STATE_DIR=/home/openclaw/.openclaw/state
      - OPENCLAW_GATEWAY_TOKEN=${OPENCLAW_GATEWAY_TOKEN}
      - OPENCLAW_GATEWAY_PASSWORD=${OPENCLAW_GATEWAY_PASSWORD}
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
      - OPENAI_API_KEY=${OPENAI_API_KEY}
      - DEEPSEEK_API_KEY=${DEEPSEEK_API_KEY}
    volumes:
      - openclaw-config:/home/openclaw/.openclaw
      - openclaw-workspace:/home/openclaw/.openclaw/workspace
      - /var/run/docker.sock:/var/run/docker.sock:ro
    ports:
      - "127.0.0.1:18789:18789"
    networks:
      - openclaw-net
    healthcheck:
      test: ["CMD", "openclaw", "health"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 20s

  openclaw-sandbox:
    image: ghcr.io/openclaw/sandbox-runner:latest
    container_name: openclaw-sandbox
    restart: always
    network_mode: none
    read_only: true
    tmpfs:
      - /tmp:rw,noexec,nosuid,size=256m
    security_opt:
      - no-new-privileges:true
    cap_drop:
      - ALL
    volumes:
      - openclaw-workspace:/workspace:rw
    environment:
      - RUNNER_UID=10001
      - RUNNER_GID=10001

volumes:
  openclaw-config:
    driver: local
  openclaw-workspace:
    driver: local

networks:
  openclaw-net:
    driver: bridge

پروڈکشن openclaw.json کنفیگریشن

{
  agents: {
    defaults: {
      workspace: "/home/openclaw/.openclaw/workspace",
      model: {
        primary: "anthropic/claude-sonnet-4-6",
        fallbacks: ["deepseek/deepseek-chat", "openai/gpt-5.4"],
      },
      thinking: "high",
      sandbox: {
        mode: "non-main", // off | non-main | all
        scope: "agent",   // session | agent | shared
        dockerImage: "ghcr.io/openclaw/sandbox-runner:latest",
        timeoutSeconds: 300,
        memoryLimitMb: 1024,
      },
    },
    list: [
      {
        id: "main",
        default: true,
        workspace: "/home/openclaw/.openclaw/workspace",
      },
      {
        id: "devops",
        workspace: "/home/openclaw/.openclaw/workspace-devops",
        sandbox: { mode: "all" },
      },
    ],
  },
  channels: {
    telegram: {
      enabled: true,
      botToken: "7123456789:AAFq_example_token_secret",
      dmPolicy: "pairing", // pairing | allowlist | open | disabled
      allowFrom: ["tg:987654321"],
    },
    discord: {
      enabled: true,
      botToken: "MTI4OTexampleDiscordBotToken",
      dmPolicy: "allowlist",
      allowFrom: ["dc:382910394857291029"],
    },
  },
  cron: {
    enabled: true,
    maxConcurrentRuns: 4,
  },
  hotReload: "hybrid",
}

4. ملٹی ایجنٹ مینجمنٹ اور سینڈ باکس سیکیورٹی

پیغامات کی پالیسیاں اور سینڈ باکس موڈز

1. پیغامات کی پالیسی (DM Policy):

• pairing (طے شدہ): نامعلوم افراد کو تصدیقی کوڈ ملتا ہے جسے ایڈمنسٹریٹر openclaw pairing approve سے منظور کرتا ہے۔
• allowlist: صرف منتخب کردہ کھاتوں کو کمانڈ چلانے کی اجازت ہوتی ہے۔
• open: ہر صارف کے لیے کھلا (صرف عوامی بوٹس کے لیے موزوں، سینڈ باکس all لازمی ہے)۔
• disabled: براہ راست پیغامات مکمل بند۔

---
name: github-pr-analyzer
description: گٹ ہب پی آر کا تجزیہ کرتا ہے، ٹیسٹ چلاتا ہے اور ریویو سمری تیار کرتا ہے۔
metadata: {
  "openclaw": {
    "requires": {
      "bins": ["gh", "jq", "git"],
      "env": ["GITHUB_TOKEN"],
      "config": ["sandbox.enabled"]
    },
    "os": ["linux", "darwin"],
    "always": false,
    "primaryEnv": "GITHUB_TOKEN"
  }
}
---

# گٹ ہب پی آر کا جائزہ لینے کی مہارت

جب صارف کال کرے یا ویب ہک ٹرگر ہو:
1. `gh pr diff <pr_number>` کی مدد سے کوڈ کے فرق کو دیکھیں۔
2. تبدیل شدہ فائلوں اور ٹیسٹ کوریج کا جائزہ لیں۔
3. مارک ڈاؤن فارمیٹ میں تفصیلی جائزہ رپورٹ مرتب کریں۔

# موجودہ مہارتوں کی فہرست دیکھیں
openclaw skills list

# آفیشل کلا ہب رجسٹری سے اسکل انسٹال کریں
openclaw skills install web-researcher

# براہ راست گٹ ہب ریپوزیٹری سے اسکل حاصل کریں
openclaw skills install git:github.com/openclaw-community/postgres-inspector@v1.4.0

# مہارت کے ڈیجیٹل دستخط اور اجازتیں چیک کریں
openclaw skills verify web-researcher

# تمام مہارتوں کو اپ ڈیٹ کریں
openclaw skills update --all

# گیٹ وے اور کنکشنز کی حالت معلوم کریں
openclaw gateway status

# لائیو لاگز پر نظر رکھیں
openclaw logs --follow --lines 50

# ترتیبات کی درستی چیک کریں
openclaw config validate

# گہری سوچ والے موڈ کے ساتھ ٹاسک انجام دیں
openclaw agent --message "پروجیکٹ کی سیکیورٹی اور ڈیپینڈنسیز کا معائنہ کریں" --thinking high

# ٹیلیگرام پر نوٹیفکیشن ارسال کریں
openclaw message send --target "tg:987654321" --message "ڈپلائمنٹ کامیابی سے مکمل ہو گئی۔"