OpenClaw স্বায়ত্তশাসিত এজেন্ট গাইড: আর্কিটেকচার, ডকার ও খরচ

### দ্রুত উত্তর: OpenClaw কী এবং কেন এটি অনন্য?

OpenClaw হলো একটি ওপেন-সোর্স স্বায়ত্তশাসিত ব্যক্তিগত AI অ্যাসিস্ট্যান্ট, যা ডিকপল্ড Gateway আর্কিটেকচার, ২০টির বেশি মেসেজিং প্ল্যাটফর্ম ইন্টিগ্রেশন এবং স্যান্ডবক্সড মাল্টি-এজেন্ট এক্সিকিউশন সমর্থন করে। প্রতি মাসে $২০–$৫০ মূল্যের বন্ধ SaaS এজেন্টের বিপরীতে, OpenClaw-এ কোনো সাবস্ক্রিপশন ফি নেই ($০) এবং সরাসরি API সংযোগের মাধ্যমে প্রতি রানে গড়ে মাত্র $০.০০৩–$০.০৪২ খরচ হয়।

১. ভূমিকা: ২০২৬ সালে OpenClaw-এর অবস্থান ও প্রয়োজনীয়তা

২০২৬ সালে কৃত্রিম বুদ্ধিমত্তা এজেন্টের জগতে এক বৈপ্লবিক রূপান্তর ঘটেছে: সাধারণ চ্যাট উইন্ডো থেকে ২৪/৭ ব্যাকগ্রাউন্ডে সক্রিয় স্বায়ত্তশাসিত কাজের ধারায় রূপান্তর। যেখানে Claude Code এবং OpenAI Codex মূলত স্থানীয় ডেভেলপার টার্মিনালে সীমাবদ্ধ, সেখানে OpenClaw (পূর্বে openclaw.ai) একাধিক মেসেজিং প্ল্যাটফর্ম, স্বয়ংক্রিয় ক্রন জব এবং নিরাপদ মাল্টি-এজেন্ট পরিচালনা করার সেরা ওপেন-সোর্স ব্যক্তিগত AI সহায়ক হিসেবে প্রতিষ্ঠিত হয়েছে।

OpenClaw তিনটি প্রধান স্তম্ভের ওপর নির্মিত:

1. ডিকপল্ড গেটওয়ে প্রোটোকল (Gateway Protocol): পোর্ট 18789-এ চলমান একটি মূল ব্যাকগ্রাউন্ড সার্ভিস, যা চ্যানেলের মেসেজ রাউটিং, সেশনের তথ্য সংরক্ষণ, ক্রন জব শিডিউলিং এবং ওয়েবহুক নিয়ন্ত্রণ করে।
2. চ্যানেল-নিরপেক্ষ বহুমুখী সংযোগ: Telegram, WhatsApp (Baileys), Discord (Bot API + Gateway), Slack (Bolt SDK), Signal, iMessage, Matrix এবং WebChat-এর মতো ২০টির বেশি মাধ্যমে সরাসরি যুক্ত হওয়ার সক্ষমতা।
3. মডুলার স্কিল এবং স্যান্ডবক্স নিরাপত্তা: ClawHub থেকে প্রাপ্ত Markdown ভিত্তিক স্কিল স্ট্যান্ডার্ড (SKILL.md) এবং ডকার কন্টেইনারে POSIX অনুমতি সীমাবদ্ধ করে শেল কমান্ড চালানোর সুরক্ষিত ব্যবস্থা।

২. আর্কিটেকচার বিশ্লেষণ: Gateway, চ্যানেল এবং ওয়ার্কস্পেস

OpenClaw-এর মূল শক্তি হলো এর পৃথক ক্লায়েন্ট-সার্ভার কন্ট্রোল প্লেন। কেন্দ্রীয় ব্যাকগ্রাউন্ড সার্ভিস (OpenClaw Gateway) WebSocket এবং Unix ডোমেন সকেটের মাধ্যমে বিভিন্ন ইন্টারফেস ও চ্যাট API-এর সঙ্গে যোগাযোগ রক্ষা করে।

+-----------------------------------------------------------------------------------+
|                            বহিঃস্থ মেসেজিং চ্যানেলসমূহ                            |
|   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        |
|  - ব্যক্তিগত CRM |                  |  - Jira / Linear |         |  - ক্লাউড ও SSH   |
+------------------+                  +------------------+         +-------------------+
       |                                      |                              |
       +--------------------------------------+------------------------------+
                                          |
                                          v
+-----------------------------------------------------------------------------------+
|                         মাল্টি-এজেন্ট স্যান্ডবক্স এক্সিকিউশন লেয়ার               |
|  - ডকার কন্টেইনার আইসোলেশন (`mode: non-main` / `mode: all`)                       |
|  - POSIX সুবিধা বাতিলকরণ (`cap_drop: ALL`, সাধারণ ব্যবহারকারী UID 10001)          |
|  - রিড-অনলি ভলিউম (`:ro`) এবং মেমরি ভিত্তিক Tmpfs (`/tmp:noexec`)                 |
|  - ClawHub স্কিলস রানটাইম (`SKILL.md` পার্সিং ও বাইনারি টেস্টিং)                  |
+-----------------------------------------------------------------------------------+

ওয়ার্কস্পেস ডিরেক্টরি কাঠামো

প্রতিটি এজেন্টের কার্যক্রম ~/.openclaw/ ফোল্ডারের অধীনে স্পষ্টভাবে পরিচালিত হয়:

~/.openclaw/
├── openclaw.json          # মূল ডিক্লেয়ারেটিভ কনফিগারেশন (JSON5)
├── cron.json              # শিডিউল করা ক্রন কাজের তালিকা
├── state/                 # SQLite সেশন ডাটাবেজ ও ক্যাশ
├── skills/                # গ্লোবালি শেয়ার করা স্কিলস
└── workspace/             # এজেন্টের কাজের মূল ডিরেক্টরি
    ├── AGENTS.md          # সার্বিক পরিচালনা ও আচরণ সংক্রান্ত নিয়ম
    ├── SOUL.md            # ব্যক্তিত্ব, কথা বলার ধরন এবং নিরাপত্তা সীমা
    ├── TOOLS.md           # লোকাল টুল সংক্রান্ত বিস্তারিত নির্দেশিকা
    └── skills/            # ওয়ার্কস্পেসের নিজস্ব স্কিলস
        └── repo-analyzer/
            └── SKILL.md   # কার্যকরী স্কিলের বিবরণ

Gateway পরিচালনার মূল কমান্ডসমূহ

# Gateway-এর অবস্থা, পোর্ট ও মেমরি ব্যবহার পরীক্ষা করুন
openclaw gateway status

# ব্যাকগ্রাউন্ডে Gateway ডেমন চালু করুন
openclaw gateway start

# বিস্তারিত ডিবাগ লগ সহ ফোরগ্রাউন্ডে চালু করুন
openclaw gateway --port 18789 --verbose

# সিস্টেম ডায়াগনস্টিক ও কনফিগারেশন যাচাই করুন
openclaw doctor

# অনুমতি ও পাথ সংক্রান্ত সমস্যা স্বয়ংক্রিয়ভাবে সমাধান করুন
openclaw doctor --fix

৩. প্রোডাকশন ডকার সেলফ-হোস্টিং ডিপ্লয়মেন্ট গাইড

টার্মিনাল ক্ষমতা সম্পন্ন কোনো 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",
}

৪. মাল্টি-এজেন্ট পরিচালনা ও স্যান্ডবক্স নিরাপত্তা

মেসেজ নীতি ও স্যান্ডবক্স আইসোলেশন মোড

1. মেসেজ যাচাই নীতি (DM Policy):

• pairing (ডিফল্ট): অপরিচিত প্রেরকদের একটি যাচাই কোড পাঠানো হয়, যা অ্যাডমিনের openclaw pairing approve কমান্ডের মাধ্যমে অনুমোদিত হতে হয়।
• allowlist: শুধুমাত্র allowFrom তালিকায় থাকা আইডিগুলো এজেন্টকে নির্দেশ দিতে পারে।
• open: সবার জন্য উন্মুক্ত (স্যান্ডবক্স all সহ শুধুমাত্র সাধারণ তথ্যপ্রদানকারী বটেই অনুমোদিত)।
• disabled: সরাসরি মেসেজ বন্ধ রেখে শুধু নির্ধারিত ক্রন নোটিফিকেশন পাঠানোর জন্য ব্যবহৃত হয়।

---
name: github-pr-analyzer
description: GitHub PR বিশ্লেষণ করে, স্বয়ংক্রিয় টেস্ট চালায় এবং রিভিউ তৈরি করে।
metadata: {
  "openclaw": {
    "requires": {
      "bins": ["gh", "jq", "git"],
      "env": ["GITHUB_TOKEN"],
      "config": ["sandbox.enabled"]
    },
    "os": ["linux", "darwin"],
    "always": false,
    "primaryEnv": "GITHUB_TOKEN"
  }
}
---

# GitHub PR অ্যানালাইসিস স্কিল

ব্যবহারকারী নির্দেশ দিলে বা ওয়েবহুক পেলে:
১. `gh pr diff <pr_number>` দিয়ে কোড পরিবর্তন সংগ্রহ করুন।
২. পরিবর্তিত ফাইল ও টেস্ট কাভারেজ যাচাই করুন।
৩. কোড রেফারেন্স সহ মার্কার্ডাউন ফরম্যাটে রিভিউ রিপোর্ট প্রস্তুত করুন।

# উপলভ্য স্কিলসমূহের তালিকা দেখুন
openclaw skills list

# অফিশিয়াল ClawHub রেজিস্ট্রি থেকে স্কিল ইন্সটল করুন
openclaw skills install web-researcher

# সরাসরি GitHub রিপোজিটরি থেকে স্কিল ডাউনলোড করুন
openclaw skills install git:github.com/openclaw-community/postgres-inspector@v1.4.0

# স্কিলের অনুমতি ও ডিজিটাল স্বাক্ষর যাচাই করুন
openclaw skills verify web-researcher

# সকল স্কিল একসাথে আপডেট করুন
openclaw skills update --all

# Gateway এবং সক্রিয় চ্যানেলের অবস্থা দেখুন
openclaw gateway status

# সরাসরি লাইভ লগ পর্যবেক্ষণ করুন
openclaw logs --follow --lines 50

# কনফিগারেশন ফাইল যাচাই করুন
openclaw config validate

# উচ্চ ক্ষমতাসম্পন্ন যুক্তি সহকারে কাজ করতে নির্দেশ দিন
openclaw agent --message "বর্তমান প্রজেক্টের নিরাপত্তা দুর্বলতা পরীক্ষা করো" --thinking high

# সরাসরি Telegram চ্যাটে নোটিফিকেশন পাঠান
openclaw message send --target "tg:987654321" --message "ডেপ্লয়মেন্ট সফলভাবে সম্পন্ন হয়েছে।"