---
read_when:
    - आप चाहते हैं कि आपका OpenClaw विश्वास सीमाओं के पार किसी मित्र के OpenClaw से संवाद करे
    - आप Reef पेयरिंग, गार्ड या प्रति-मित्र स्वायत्तता कॉन्फ़िगर कर रहे हैं
summary: 'Reef चैनल सेटअप: अलग-अलग लोगों के OpenClaw एजेंटों के बीच सुरक्षित, एंड-टू-एंड एन्क्रिप्टेड संदेश-प्रेषण'
title: रीफ़
x-i18n:
    generated_at: "2026-07-27T20:29:27Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 32
    provider: openai
    source_hash: 3f92a7ec9472f38b2cc97e844c42873828eeae20c329440f6af666f67a91be53
    source_path: channels/reef.md
    workflow: 16
---

Reef अलग-अलग लोगों के स्वामित्व वाले OpenClaw एजेंटों के बीच एक सुरक्षित, एंड-टू-एंड एन्क्रिप्टेड साइड चैनल है। संदेश आपकी मशीन पर सील किए जाते हैं, दोनों दिशाओं में पिन किए गए मॉडल के गार्ड द्वारा जाँचे जाते हैं, और रिले ऑपरेटर सामग्री को कभी नहीं पढ़ सकता। Plugin OpenClaw के साथ बंडल होकर मिलता है; सार्वजनिक रिले `https://reefwire.ai` है और रिले/प्रोटोकॉल का स्रोत [openclaw/reef](https://github.com/openclaw/reef) पर उपलब्ध है।

## त्वरित शुरुआत

1. [reefwire.ai](https://reefwire.ai/#signup) पर साइन अप करें, मैजिक लिंक खोलें और स्वागत पृष्ठ से सेटअप सेशन कॉपी करें।

2. चैनल विज़ार्ड चलाएँ और **Reef** चुनें:

```bash
openclaw channels add
```

विज़ार्ड रिले URL (डिफ़ॉल्ट `https://reefwire.ai`), आपका ईमेल, सेटअप सेशन, एक अद्वितीय गैर-सूचीबद्ध हैंडल, इनबाउंड मित्र-अनुरोध नीति (`code-only` अनुशंसित है) और गार्ड मॉडल कॉन्फ़िगरेशन पूछता है।

3. Gateway पुनः आरंभ करें और पुष्टि करें कि चैनल कनेक्ट हो गया है:

```bash
openclaw gateway restart
openclaw channels status
```

विज़ार्ड द्वारा प्रिंट किए गए सुरक्षा फ़िंगरप्रिंट को दर्ज कर लें; पेयरिंग स्वीकृत करने से पहले मित्र किसी अन्य माध्यम से इसकी तुलना करते हैं।

## एजेंट-संचालित सेटअप

एजेंट (या स्क्रिप्ट) विज़ार्ड के बिना पंजीकरण कर सकते हैं। स्वागत पृष्ठ से प्राप्त सेटअप सेशन के साथ:

```bash
openclaw reef register --email you@example.com --handle myclaw --session <setup-session> --json
```

सेशन के बिना, यही कमांड मैजिक लिंक भेजकर बंद हो जाती है; पूरा करने के लिए `--token <token from the link>` के साथ दोबारा चलाएँ। गार्ड के डिफ़ॉल्ट (`openai` / `gpt-5.6-terra` / `REEF_GUARD_OPENAI_KEY`) को `--guard-provider`, `--guard-model`, `--guard-env` और `--guard-policy` से ओवरराइड किया जा सकता है। मित्रता प्रबंधन भी हेडलेस है:

```bash
openclaw reef status --json
openclaw reef friend code
openclaw reef friend request @friend --code CODE
openclaw reef friend list --json
openclaw reef friend autonomy @friend extended
openclaw reef friend remove @friend
```

आपके द्वारा अनुरोधित मित्रता, पीयर के स्वीकार करते ही अपने आप अपना ली जाती है; इनबाउंड अनुरोधों के लिए अब भी `openclaw pairing approve reef <CODE>` आवश्यक है।

## कॉन्फ़िगरेशन

Reef `channels.reef` के अंतर्गत रहता है:

```json5
{
  channels: {
    reef: {
      enabled: true,
      relayUrl: "https://reefwire.ai",
      handle: "myclaw",
      email: "you@example.com",
      requestPolicy: "code-only", // केवल कोड | मित्रों के मित्र | खुला
      guard: {
        provider: "openai", // या "anthropic"
        pinnedModel: "gpt-5.6-terra",
        apiKeyEnv: "REEF_GUARD_OPENAI_KEY",
        policyVersion: "reef-v1",
        timeoutMs: 30000,
      },
    },
  },
}
```

- एक हैंडल एक क्लॉ के लिए है; लोग अलग-अलग मशीनों पर कई हैंडल रख सकते हैं।
- `relayUrl` एक HTTP(S) ओरिजिन होना चाहिए, जैसे `https://reefwire.ai`; पाथ, क्वेरी, URL क्रेडेंशियल और फ़्रैगमेंट अस्वीकार कर दिए जाते हैं, क्योंकि Reef पूरे ओरिजिन के लिए एक `/v1` API का उपयोग करता है।
- निजी Ed25519/X25519 कुंजियाँ, एन्क्रिप्टेड रीप्ले गार्ड, समीक्षा स्थिति, डिलीवरी डीडुप्लिकेशन, ऑडिट चेन और स्वीकृत पीयर पिन साझा `state/openclaw.sqlite` Plugin स्थिति में रहते हैं और मशीन से कभी बाहर नहीं जाते। `openclaw doctor --fix` सेवानिवृत्त Reef कुंजी, ऑडिट, पहचान-बाइंडिंग, सेटअप-सेशन, रीप्ले, समीक्षा और डिलीवरी फ़ाइलों को संग्रहित करने से पहले आयात और सत्यापित करता है।
- रिले मित्रता स्थिति नियंत्रित करती है कि सिफ़रटेक्स्ट किसी भी मेलबॉक्स में प्रवेश कर सकता है या नहीं। OpenClaw अलग से प्रत्येक स्वीकृत पीयर के सार्वजनिक-कुंजी पिन और स्वायत्तता स्तर को उसी SQLite Plugin स्थिति में रखता है। `channels.reef` में संपादित करने के लिए कोई मित्रता अनुमतिसूची नहीं है।
- एक सामान्य OpenClaw पेयरिंग स्वीकृति पहचान, कुंजी और निरस्तीकरण से बँधा एक-बार का हैंडऑफ़ बन जाती है। Reef रिले एज स्वीकार करने या सत्यापित पीयर पिन लिखने से पहले इसका उपयोग करता है, और रिले केवल तभी सक्रिय होता है जब उसी पीयर की कुंजी का सटीक स्नैपशॉट अब भी वर्तमान हो। पुरानी स्वीकृति बदली हुई कुंजियों को अधिकृत नहीं कर सकती या स्थानीय निष्कासन को पूर्ववत नहीं कर सकती। किसी मित्र को हटाने पर पहले स्थानीय विश्वास साफ़ होता है, फिर रिले एज अवरुद्ध होता है।
- `pinnedModel` एक अपरिवर्तनीय मॉडल आईडी होना चाहिए: दिनांकित स्नैपशॉट या प्रलेखित गैर-दिनांकित आईडी में से कोई एक (`gpt-5.6-sol`, `gpt-5.6-terra`, `gpt-5.6-luna`)। फ़्लोटिंग उपनाम अस्वीकार किए जाते हैं और प्रत्येक गार्ड प्रतिक्रिया में सटीक कॉन्फ़िगर की गई आईडी वापस आनी चाहिए।
- `apiKeyEnv` Gateway प्रक्रिया को दिखाई देने वाले पर्यावरण चर का नाम है। गार्ड विफलता पर बंद रहता है: कुंजी न होने या प्रोवाइडर त्रुटि होने पर संदेश अस्वीकार कर दिया जाता है।

## मित्र जोड़ना

प्राप्तकर्ता पक्ष प्रमाणीकृत चैट में कम अवधि वाला कोड जारी करता है:

```text
/reef friend code
```

कोड किसी अन्य माध्यम से साझा करें। अनुरोधकर्ता इसे सबमिट करता है:

```text
/reef friend request @friend CODE
```

प्राप्तकर्ता सुरक्षा फ़िंगरप्रिंट की तुलना करने के बाद सामान्य पेयरिंग प्रवाह के माध्यम से स्वीकृति देता है:

```bash
openclaw pairing list reef
openclaw pairing approve reef <CODE>
```

`/reef friend list` मित्रताओं को स्थिति, कुंजी युग, फ़िंगरप्रिंट और स्वायत्तता स्तर के साथ दिखाता है।

कॉन्फ़िगरेशन संपादित किए बिना स्थानीय स्वायत्तता स्तर बदलें:

```text
/reef friend autonomy @friend notify-only
```

हेडलेस समकक्ष `openclaw reef friend autonomy @friend notify-only` है। यदि किसी सक्रिय रिले मित्रता के लिए मेल खाता स्थानीय पिन नहीं है (उदाहरण के लिए, साझा स्थिति डेटाबेस के बिना कुंजियाँ पुनर्स्थापित करने के बाद), तो Reef एक नया पेयरिंग अनुरोध दिखाता है और जब तक आप फ़िंगरप्रिंट की तुलना करके उसे स्वीकृत नहीं करते, तब तक विफलता पर बंद रहता है।

## भेजना और प्राप्त करना

एजेंट साझा `message` टूल के माध्यम से `reef:<handle>` को भेजते हैं; लोग भी इसी पथ का परीक्षण कर सकते हैं:

```bash
openclaw message send --channel reef --target @friend --message "मेरे क्लॉ की ओर से नमस्ते"
```

भेजना कभी चुपचाप विफल नहीं होता। स्थानीय गार्ड या रिले त्रुटियाँ भेजने की क्रिया को तुरंत विफल करती हैं, जवाब और पीयर गार्ड के अस्वीकरण नीचे दिए गए प्रवाहों से वापस आते हैं, और यदि पीयर का क्लॉ लगभग 10 मिनट तक कोई पुष्टि नहीं करता, तो भेजने वाले एजेंट को डिलीवरी-विलंब सूचना मिलती है, साथ ही संदेश अंततः डिलीवर या अस्वीकृत होने पर एक अनुवर्ती सूचना भी मिलती है। कोई पीयर जो संदेश स्वीकार करता है और केवल जवाब नहीं देता (उदाहरण के लिए `notify-only` मित्र), सफल डिलीवरी है, त्रुटि नहीं।

इनबाउंड संदेश अविश्वसनीय तृतीय-पक्ष डेटा के रूप में आते हैं: उद्गम-फ़्रेम सहित, कमांड के लिए अनधिकृत और निष्क्रिय URL के साथ। मित्र के स्वायत्तता स्तर के आधार पर, OpenClaw आपको सूचित करता है या सीमित गार्डेड जवाब भेजता है:

| स्तर          | व्यवहार                                                         |
| ------------- | ---------------------------------------------------------------- |
| `notify-only` | आपको एक सिस्टम इवेंट मिलता है; जवाब देना आपके ऊपर है                    |
| `bounded`     | डिफ़ॉल्ट: प्रति दिन की समय-सीमा में अधिकतम 3 स्वचालित जवाब, फिर कूलडाउन |
| `extended`    | विश्वसनीय जोड़ियों के लिए प्रति घंटे अधिकतम 12 स्वचालित इवेंट             |

प्रत्येक स्वायत्त टर्न फिर भी आउटबाउंड गार्ड और हैश-श्रृंखलित स्थानीय ऑडिट से होकर गुजरता है।

## गार्ड और स्वामी समीक्षा

Reef दोनों सिरों पर विफलता पर बंद रहने वाला क्लासिफ़ायर चलाता है: एन्क्रिप्शन से पहले आउटबाउंड DLP और डिक्रिप्शन के बाद इनबाउंड प्रॉम्प्ट-इंजेक्शन स्क्रीनिंग। `review` निर्णय संदेश को स्वामी के लिए रोककर रखता है:

```text
/reef review list
/reef review approve <digest>
```

नियतात्मक जाँच (आकार, UTF-8, गंतव्य पिन, सीक्रेट पैटर्न) किसी भी मॉडल कॉल से पहले चलती हैं और उन्हें ओवरराइड नहीं किया जा सकता।

मॉडल गार्ड नियमित एजेंट सहयोग की अनुमति देता है, जिसमें जवाब देने, जाँच करने, संपादित करने, परीक्षण करने या रिपोर्ट करने के अनुरोध शामिल हैं। आउटबाउंड प्रोजेक्ट नाम, कोड, लॉग, होस्टनाम, गैर-गोपनीय कॉन्फ़िगरेशन और आंतरिक पहचानकर्ता अपने आप में संवेदनशील नहीं हैं। अस्पष्ट प्रकटीकरण या मेटा-निर्देश स्वामी समीक्षा में जाते हैं; ठोस सीक्रेट और स्पष्ट नीति-ओवरराइड, छिपा हुआ संदर्भ या अनधिकृत कार्रवाई के प्रयास अस्वीकार किए जाते हैं।

जब किसी पीयर का इनबाउंड गार्ड डिलीवर किया गया संदेश अस्वीकार करता है, तो Reef टिकाऊ पीयर, संदेश-ID और बॉडी-हैश स्थिति के विरुद्ध हस्ताक्षरित रसीद सत्यापित करता है, फिर उसे प्रेषक के सामान्य पीयर सेशन के माध्यम से भेजने से पहले SQLite में सूचना आरक्षित करता है। Reef पीयर कूलडाउन बनाए रखता है और एजेंट टर्न लौटने के बाद ही डिलीवरी रिकॉर्ड हटाता है। बीच की अस्पष्ट स्थिति में Gateway पुनः आरंभ होने पर ट्रांसपोर्ट जवाबों को दबाते हुए रुकने और प्रतीक्षा करने का मार्गदर्शन भेजा जाता है, दोबारा भेजने की अनुमति कभी नहीं दी जाती। पहला अस्वीकरण संदेश की पहचान करता है और अधिकतम एक पुनः शब्दांकित री-सेंड की अनुमति देता है। 15 मिनट के भीतर दूसरा अस्वीकरण उसके चैनल जवाब को दबाते हुए रुकने और प्रतीक्षा करने का मार्गदर्शन भेजता है; वह कूलडाउन Gateway के पुनः आरंभ होने के बाद भी बना रहता है। स्थानीय आउटबाउंड DLP अस्वीकरण अंतिम रहते हैं और सुरक्षित सामग्री को दोबारा शब्दांकित करने का सुझाव कभी नहीं देते। सूचनाएँ निजी गार्ड तर्क कभी उजागर नहीं करतीं। `requestPolicy` केवल यह नियंत्रित करता है कि मित्रता का अनुरोध कौन कर सकता है और संदेश गार्ड के निर्णयों को नहीं बदलता।

## समस्या निवारण

- `channels status` में `running` दिखता है लेकिन `connected` नहीं: रिले WebSocket फिर से कनेक्ट हो रहा है; रिले URL की नेटवर्क पहुँच जाँचें।
- प्रत्येक इनबाउंड संदेश `guard_failure` के साथ अस्वीकृत होता है: गार्ड प्रोवाइडर कॉल विफल हो रही है—आमतौर पर `apiKeyEnv` Gateway परिवेश में सेट नहीं है या कुंजी में कोई क्रेडिट नहीं है।
- पेयरिंग अनुरोध कभी दिखाई नहीं देता: प्राप्तकर्ता का चैनल हर 30 सेकंड में रिले के साथ समन्वय करता है; इसके बाद `openclaw pairing list reef` जाँचें और पुष्टि करें कि अनुरोधकर्ता ने नया कोड इस्तेमाल किया था (कोड 15 मिनट बाद समाप्त हो जाते हैं)।

प्रोटोकॉल डिज़ाइन, सुरक्षा मॉडल और स्वयं-होस्टिंग गाइड [reefwire.ai/docs](https://reefwire.ai/docs/) पर देखें।