1. Discord Developer Portal -> **Applications** -> **New Application**
2. **Bot** -> **Add Bot**
3. Bot tokenini nusxalang

- Message Content Intent
- Server Members Intent (tavsiya etiladi)

Presence intent ixtiyoriy va faqat presence yangilanishlarini olishni istasangiz kerak bo‘ladi. Bot presence’ini (`setPresence`) sozlash uchun a’zolar presence yangilanishlarini yoqish talab etilmaydi.

- scopes: `bot`, `applications.commands`

Odatdagi asosiy ruxsatlar:

- View Channels
- Send Messages
- Read Message History
- Embed Links
- Attach Files
- Add Reactions (ixtiyoriy)

Alohida zarurat bo‘lmasa `Administrator` dan foydalanmang.

- server ID
- channel ID
- user ID

OpenClaw konfiguratsiyasida ishonchli audit va tekshiruvlar uchun raqamli ID’lardan foydalanish tavsiya etiladi.

- `[[reply_to_current]]`
- `[[reply_to:<id>]]`

`channels.discord.replyToMode` orqali boshqariladi:

- `off` (sukut bo‘yicha)
- `first`
- `all`

Eslatma: `off` yashirin javob tarmog‘ini o‘chiradi. Aniq `[[reply_to_*]]` teglari baribir inobatga olinadi.

Xabar ID’lari agentlar aniq xabarlarni nishonga olishi uchun kontekst/tarixda ko‘rsatiladi.

- `channels.discord.historyLimit` sukut bo‘yicha `20`
- zaxira: `messages.groupChat.historyLimit`
- `0` o‘chiradi

DM tarix boshqaruvi:

- `channels.discord.dmHistoryLimit`
- `channels.discord.dms["<user_id>"].historyLimit`

Thread xatti-harakati:

- Discord thread’lari kanal sessiyalari sifatida yo‘naltiriladi
- ota thread metama’lumotlari ota-sessiya bog‘lanishi uchun ishlatilishi mumkin
- agar thread uchun alohida sozlama bo‘lmasa, thread konfiguratsiyasi ota kanal konfiguratsiyasini meros qiladi

Kanal mavzulari **ishonchsiz** kontekst sifatida kiritiladi (system prompt sifatida emas).

- `off`
- `own` (sukut bo‘yicha)
- `all`
- `allowlist` (`guilds.<id>.users` dan foydalanadi)

Reaksiya hodisalari system hodisalariga aylantiriladi va yo‘naltirilgan Discord sessiyasiga biriktiriladi.

Ustuvorlik tartibi:

- `channels.discord.accounts.<accountId>.ackReaction`
- `channels.discord.ackReaction`
- `messages.ackReaction`
- agent identifikatsiya emoji zaxirasi (`agents.list[].identity.emoji`, aks holda "👀")

Eslatmalar:

- Discord unicode emoji yoki maxsus emoji nomlarini qabul qiladi.
- Kanal yoki akkaunt uchun reaksiyani o‘chirish uchun `""` dan foydalaning.

Bu `/config set|unset` oqimlariga ta’sir qiladi (buyruq funksiyalari yoqilgan bo‘lsa).

O‘chirish:

{
  channels: {
    discord: {
      configWrites: false,
    },
  },
}

{
  channels: {
    discord: {
      proxy: "http://proxy.example:8080",
    },
  },
}

Har bir akkaunt uchun bekor qilish:

{
  channels: {
    discord: {
      accounts: {
        primary: {
          proxy: "http://proxy.example:8080",
        },
      },
    },
  },
}

{
  channels: {
    discord: {
      pluralkit: {
        enabled: true,
        token: "pk_live_...", // ixtiyoriy; yopiq tizimlar uchun kerak
      },
    },
  },
}

Eslatmalar:

- allowlist’larda `pk:<memberId>` dan foydalanish mumkin
- a’zo ko‘rsatish nomlari name/slug bo‘yicha moslashtiriladi
- qidiruvlar asl xabar ID’sidan foydalanadi va vaqt oynasi bilan cheklangan
- agar qidiruv muvaffaqiyatsiz bo‘lsa, proksilangan xabarlar bot xabarlari sifatida ko‘riladi va `allowBots=true` bo‘lmasa, bekor qilinadi

Faqat status misoli:

{
  channels: {
    discord: {
      status: "idle",
    },
  },
}

Activity misoli (custom status sukut bo‘yicha activity turi):

{
  channels: {
    discord: {
      activity: "Focus time",
      activityType: 4,
    },
  },
}

Streaming misoli:

{
  channels: {
    discord: {
      activity: "Live coding",
      activityType: 1,
      activityUrl: "https://twitch.tv/openclaw",
    },
  },
}

Activity turi xaritasi:

- 0: Playing
- 1: Streaming (`activityUrl` talab qilinadi)
- 2: Listening
- 3: Watching
- 4: Custom (activity matnini status holati sifatida ishlatadi; emoji ixtiyoriy)
- 5: Competing

Konfiguratsiya yo‘li:

- `channels.discord.execApprovals.enabled`
- `channels.discord.execApprovals.approvers`
- `channels.discord.execApprovals.target` (`dm` | `channel` | `both`, sukut bo‘yicha: `dm`)
- `agentFilter`, `sessionFilter`, `cleanupAfterResolve`

`target` `channel` yoki `both` bo‘lsa, tasdiq so‘rovi kanalda ko‘rinadi. Faqat sozlangan tasdiqlovchilar tugmalardan foydalana oladi; boshqa foydalanuvchilar vaqtinchalik rad javobini oladi. Tasdiq so‘rovlari buyruq matnini o‘z ichiga oladi, shuning uchun kanalga yetkazishni faqat ishonchli kanallarda yoqing. Agar kanal ID’sini sessiya kalitidan aniqlab bo‘lmasa, OpenClaw DM orqali yuborishga qaytadi.

Agar tasdiqlar noma’lum tasdiq ID’lari bilan muvaffaqiyatsiz tugasa, tasdiqlovchilar ro‘yxati va funksiya yoqilganini tekshiring.

Tegishli hujjatlar: [Exec approvals](/tools/exec-approvals)

- Message Content Intent’ni yoqing
- foydalanuvchi/a’zo aniqlashga bog‘liq bo‘lsangiz, Server Members Intent’ni yoqing
- intent’larni o‘zgartirgandan so‘ng gateway’ni qayta ishga tushiring

- `groupPolicy`ni tekshiring
- `channels.discord.guilds` ostidagi guild allowlist’ni tekshiring
- agar guild `channels` xaritasi mavjud bo‘lsa, faqat ro‘yxatdagi kanallarga ruxsat beriladi
- `requireMention` xatti-harakati va mention andozalarini tekshiring

Foydali tekshiruvlar:

openclaw doctor
openclaw channels status --probe
openclaw logs --follow

- mos guild/channel allowlist bo‘lmagan holda `groupPolicy="allowlist"`
- `requireMention` noto‘g‘ri joyda sozlangan (`channels.discord.guilds` yoki kanal yozuvi ostida bo‘lishi kerak)
- yuboruvchi guild/channel `users` allowlist’i tomonidan bloklangan

Agar slug kalitlaridan foydalansangiz, runtime moslash ishlashi mumkin, biroq probe ruxsatlarni to‘liq tekshira olmaydi.

- DM o‘chirilgan: `channels.discord.dm.enabled=false`
- DM siyosati o‘chirilgan: `channels.discord.dmPolicy="disabled"` (legacy: `channels.discord.dm.policy`)
- `pairing` rejimida juftlash tasdig‘i kutilmoqda

Agar `channels.discord.allowBots=true` ni yoqsangiz, sikl (loop) xatti-harakatining oldini olish uchun qat’iy mention va allowlist qoidalaridan foydalaning.