openclaw agents

अलग-अलग एजेंटों (वर्कस्पेस + प्रमाणीकरण + रूटिंग) को प्रबंधित करें। बिना किसी उपकमांड के openclaw agents चलाना openclaw agents list के बराबर है।

संबंधित:

• मल्टी-एजेंट रूटिंग
• एजेंट वर्कस्पेस
• Skills कॉन्फ़िगरेशन: स्किल दृश्यता कॉन्फ़िगरेशन।

उदाहरण

openclaw agents listopenclaw agents list --bindingsopenclaw agents add work --workspace ~/.openclaw/workspace-workopenclaw agents add work --workspace ~/.openclaw/workspace-work --bind telegram:*openclaw agents add ops --workspace ~/.openclaw/workspace-ops --bind telegram:ops --non-interactiveopenclaw agents bindingsopenclaw agents bind --agent work --bind telegram:opsopenclaw agents unbind --agent work --bind telegram:opsopenclaw agents set-identity --workspace ~/.openclaw/workspace --from-identityopenclaw agents set-identity --agent main --avatar avatars/openclaw.pngopenclaw agents delete work

कमांड सतह

agents list

विकल्प: --json, --bindings (केवल प्रति-एजेंट गणना/सारांश नहीं, बल्कि पूर्ण रूटिंग नियम शामिल करें)।

agents add [name]

विकल्प: --workspace <dir>, --model <id>, --agent-dir <dir>, --bind <channel[:accountId]> (दोहराया जा सकता है), --non-interactive, --json।

• कोई भी स्पष्ट ऐड फ़्लैग देने पर कमांड गैर-संवादात्मक पथ पर चला जाता है।
• गैर-संवादात्मक मोड में एजेंट का नाम और --workspace, दोनों आवश्यक हैं।
• main आरक्षित है और इसे नए एजेंट आईडी के रूप में उपयोग नहीं किया जा सकता।
• संवादात्मक मोड प्रमाणीकरण को केवल पोर्टेबल स्थिर क्रेडेंशियल (api_key और स्थिर token प्रोफ़ाइल) कॉपी करके आरंभ करता है, जब तक कि कोई क्रेडेंशियल copyToAgents: false के साथ इससे बाहर न हो जाए; OAuth रिफ़्रेश-टोकन प्रोफ़ाइल तब तक कॉपी नहीं की जातीं, जब तक कोई प्रदाता copyToAgents: true के साथ इसकी अनुमति न दे। कॉपी न होने पर OAuth केवल वास्तविक main एजेंट स्टोर से रीड-थ्रू इनहेरिटेंस के माध्यम से उपलब्ध रहता है। यदि कॉन्फ़िगर किया गया डिफ़ॉल्ट एजेंट main नहीं है, तो नए एजेंट पर OAuth प्रोफ़ाइल के लिए अलग से साइन इन करें।

agents bindings

विकल्प: --agent <id>, --json।

agents bind

विकल्प: --agent <id> (डिफ़ॉल्ट रूप से वर्तमान डिफ़ॉल्ट एजेंट), --bind <channel[:accountId]> (दोहराया जा सकता है), --json।

agents unbind

विकल्प: --agent <id> (डिफ़ॉल्ट रूप से वर्तमान डिफ़ॉल्ट एजेंट), --bind <channel[:accountId]> (दोहराया जा सकता है), --all, --json। या तो --all स्वीकार करता है या एक अथवा अधिक --bind मान, दोनों नहीं।

agents set-identity

विकल्प: --agent <id>, --workspace <dir>, --identity-file <path>, --from-identity, --name <name>, --theme <theme>, --emoji <emoji>, --avatar <value>, --json। नीचे पहचान सेट करें देखें।

agents delete <id>

विकल्प: --force, --json।

• main को हटाया नहीं जा सकता।
• --force के बिना संवादात्मक पुष्टि आवश्यक है (गैर-TTY सत्र में विफल होता है; --force के साथ दोबारा चलाएँ)।
• वर्कस्पेस, एजेंट स्थिति और सत्र ट्रांसक्रिप्ट डायरेक्टरियों को स्थायी रूप से हटाने के बजाय ट्रैश में भेजा जाता है। यदि ट्रैश उपलब्ध नहीं है, तब भी एजेंट कॉन्फ़िगरेशन हटाना सफल होता है और मैन्युअल सफ़ाई की आवश्यकता वाले पथों की सूचना देता है।
• जब Gateway उपलब्ध हो, तो हटाने की प्रक्रिया Gateway के माध्यम से रूट होती है, ताकि कॉन्फ़िगरेशन और सत्र-स्टोर की सफ़ाई में वही राइटर उपयोग हो जो रनटाइम ट्रैफ़िक में होता है। यदि Gateway उपलब्ध न हो, तो CLI ऑफ़लाइन स्थानीय पथ पर वापस चला जाता है।
• यदि किसी अन्य एजेंट का वर्कस्पेस समान पथ है, इस वर्कस्पेस के अंदर है या इस वर्कस्पेस को समाहित करता है, तो वर्कस्पेस बनाए रखा जाता है और --json, workspaceRetained, workspaceRetainedReason तथा workspaceSharedWith की सूचना देता है।

रूटिंग बाइंडिंग

आने वाले चैनल ट्रैफ़िक को किसी विशिष्ट एजेंट से स्थायी रूप से जोड़ने के लिए रूटिंग बाइंडिंग का उपयोग करें।

यदि आप प्रत्येक एजेंट के लिए अलग-अलग दृश्यमान स्किल भी चाहते हैं, तो openclaw.json में agents.defaults.skills और agents.entries.*.skills कॉन्फ़िगर करें। Skills कॉन्फ़िगरेशन और कॉन्फ़िगरेशन संदर्भ देखें।

बाइंडिंग सूचीबद्ध करें:

openclaw agents bindingsopenclaw agents bindings --agent workopenclaw agents bindings --json

बाइंडिंग जोड़ें:

openclaw agents bind --agent work --bind telegram:ops --bind discord:guild-a

एजेंट बनाते समय भी बाइंडिंग जोड़ सकते हैं:

openclaw agents add work --workspace ~/.openclaw/workspace-work --bind telegram:* --bind discord:*

यदि आप accountId (--bind <channel>) छोड़ देते हैं, तो OpenClaw इसे Plugin सेटअप हुक, बाध्य खाता बाइंडिंग या चैनल की कॉन्फ़िगर की गई खाता संख्या से निर्धारित करता है।

यदि आप bind या unbind के लिए --agent छोड़ देते हैं, तो OpenClaw वर्तमान डिफ़ॉल्ट एजेंट को लक्षित करता है।

--bind प्रारूप

बाइंडिंग दायरे का व्यवहार

• accountId के बिना संग्रहीत बाइंडिंग केवल चैनल के डिफ़ॉल्ट खाते से मेल खाती है।
• accountId: "*" चैनल-व्यापी फ़ॉलबैक (सभी खाते) है और स्पष्ट खाता बाइंडिंग से कम विशिष्ट है।
• यदि उसी एजेंट के पास पहले से accountId के बिना मेल खाती चैनल बाइंडिंग है और बाद में आप स्पष्ट या निर्धारित accountId के साथ बाइंड करते हैं, तो OpenClaw डुप्लिकेट जोड़ने के बजाय उस मौजूदा बाइंडिंग को वहीं अपग्रेड करता है।

उदाहरण:

# चैनल के सभी खातों से मिलान करेंopenclaw agents bind --agent work --bind telegram:* # किसी विशिष्ट खाते से मिलान करेंopenclaw agents bind --agent work --bind telegram:ops # आरंभिक केवल-चैनल बाइंडिंगopenclaw agents bind --agent work --bind telegram # बाद में खाता-दायरा बाइंडिंग में अपग्रेड करेंopenclaw agents bind --agent work --bind telegram:alerts

अपग्रेड के बाद उस बाइंडिंग की रूटिंग का दायरा telegram:alerts तक सीमित होता है। यदि आप डिफ़ॉल्ट-खाता रूटिंग भी चाहते हैं, तो उसे स्पष्ट रूप से जोड़ें (उदाहरण के लिए --bind telegram:default)।

बाइंडिंग हटाएँ:

openclaw agents unbind --agent work --bind telegram:opsopenclaw agents unbind --agent work --all

पहचान फ़ाइलें

प्रत्येक एजेंट वर्कस्पेस में वर्कस्पेस रूट पर एक IDENTITY.md शामिल हो सकता है:

• उदाहरण पथ: ~/.openclaw/workspace/IDENTITY.md
• set-identity --from-identity वर्कस्पेस रूट (या स्पष्ट --identity-file) से पढ़ता है।

अवतार पथ वर्कस्पेस रूट के सापेक्ष निर्धारित होते हैं और सिमलिंक के माध्यम से भी उससे बाहर नहीं जा सकते।

पहचान सेट करें

set-identity, agents.entries.*.identity में ये फ़ील्ड लिखता है: name, theme, emoji, avatar (वर्कस्पेस-सापेक्ष पथ, http(s) URL या डेटा URI)।

• --agent या --workspace लक्ष्य एजेंट चुनता है। यदि --workspace एक से अधिक एजेंट से मेल खाता है, तो कमांड विफल हो जाता है और आपसे --agent देने को कहता है।
• स्थानीय वर्कस्पेस-सापेक्ष अवतार छवि फ़ाइलें 2 MB तक सीमित हैं। HTTP(S) URL और data: URI पर स्थानीय फ़ाइल-आकार सीमा की जाँच लागू नहीं होती।
• जब कोई स्पष्ट पहचान फ़ील्ड नहीं दिया जाता, तो कमांड IDENTITY.md से पहचान डेटा पढ़ता है।

IDENTITY.md से लोड करें:

openclaw agents set-identity --workspace ~/.openclaw/workspace --from-identity

फ़ील्ड स्पष्ट रूप से ओवरराइड करें:

openclaw agents set-identity --agent main --name "OpenClaw" --emoji "🦞" --avatar avatars/openclaw.png

कॉन्फ़िगरेशन नमूना:

{  agents: {    list: [      {        id: "main",        identity: {          name: "OpenClaw",          theme: "space lobster",          emoji: "🦞",          avatar: "avatars/openclaw.png",        },      },    ],  },}

संबंधित

• CLI संदर्भ
• मल्टी-एजेंट रूटिंग
• एजेंट वर्कस्पेस