---
read_when:
    - اتصال OpenClaw به فضای کاری ClickClack
    - آزمایش هویت‌های ربات ClickClack
summary: راه‌اندازی کانال توکن ربات ClickClack و نحو هدف
title: کلیک‌کلاک
x-i18n:
    generated_at: "2026-05-10T19:21:00Z"
    model: gpt-5.5
    provider: openai
    source_hash: 8d4860b5f0a40d38af99bec0b8187f723a30c9b4b78d2d1de50ba8a97954baeb
    source_path: channels/clickclack.md
    workflow: 16
---

ClickClack، OpenClaw را از طریق توکن‌های بات درجه‌یک ClickClack به یک فضای کاری خودمیزبان ClickClack متصل می‌کند.

وقتی می‌خواهید یک عامل OpenClaw به‌عنوان کاربر بات ClickClack ظاهر شود، از این استفاده کنید. ClickClack از بات‌های سرویس مستقل و بات‌های متعلق به کاربر پشتیبانی می‌کند؛ بات‌های متعلق به کاربر یک `owner_user_id` نگه می‌دارند و فقط دامنه‌های توکنی را دریافت می‌کنند که شما اعطا می‌کنید.

## راه‌اندازی سریع

یک توکن بات در ClickClack ایجاد کنید:

```bash
clickclack admin bot create \
  --workspace <workspace_id_or_slug> \
  --name "OpenClaw" \
  --handle openclaw \
  --scopes bot:write \
  --plain
```

برای بات متعلق به کاربر، `--owner <user_id>` را اضافه کنید.

OpenClaw را پیکربندی کنید:

```json5
{
  plugins: {
    entries: {
      clickclack: {
        llm: {
          allowAgentIdOverride: true,
        },
      },
    },
  },
  channels: {
    clickclack: {
      enabled: true,
      baseUrl: "https://app.clickclack.chat",
      token: { source: "env", provider: "default", id: "CLICKCLACK_BOT_TOKEN" },
      workspace: "default",
      defaultTo: "channel:general",
      agentId: "clickclack-bot",
      replyMode: "model",
    },
  },
}
```

سپس اجرا کنید:

```bash
export CLICKCLACK_BOT_TOKEN="ccb_..."
openclaw gateway
```

## چند بات

هر حساب اتصال بی‌درنگ ClickClack خودش را باز می‌کند و از توکن بات خودش استفاده می‌کند.

```json5
{
  plugins: {
    entries: {
      clickclack: {
        llm: {
          allowAgentIdOverride: true,
        },
      },
    },
  },
  channels: {
    clickclack: {
      enabled: true,
      baseUrl: "https://app.clickclack.chat",
      defaultAccount: "service",
      accounts: {
        service: {
          token: { source: "env", provider: "default", id: "CLICKCLACK_SERVICE_BOT_TOKEN" },
          workspace: "default",
          defaultTo: "channel:general",
          agentId: "service-bot",
          replyMode: "model",
        },
        peter: {
          token: { source: "env", provider: "default", id: "CLICKCLACK_PETER_BOT_TOKEN" },
          workspace: "default",
          defaultTo: "dm:usr_...",
          agentId: "peter-bot",
          replyMode: "model",
        },
      },
    },
  },
}
```

`replyMode: "model"` برای پاسخ‌های کوتاه بات مستقیماً از `api.runtime.llm.complete` استفاده می‌کند.
وقتی یک حساب `agentId` را تنظیم می‌کند، OpenClaw به بیت اعتماد صریح
`plugins.entries.clickclack.llm.allowAgentIdOverride` نیاز دارد تا Plugin
بتواند تکمیل‌ها را برای آن عامل بات اجرا کند. اگر فقط از مسیر عامل پیش‌فرض استفاده می‌کنید، آن را خاموش نگه دارید.

## هدف‌ها

- `channel:<name-or-id>` به یک کانال فضای کاری ارسال می‌کند. هدف‌های بدون پیشوند به‌طور پیش‌فرض `channel:` هستند.
- `dm:<user_id>` یک گفت‌وگوی مستقیم با آن کاربر ایجاد می‌کند یا از گفت‌وگوی موجود استفاده می‌کند.
- `thread:<message_id>` در یک رشته موجود پاسخ می‌دهد.

نمونه‌ها:

```bash
openclaw message send --channel clickclack --target channel:general --message "hello"
openclaw message send --channel clickclack --target dm:usr_123 --message "hello"
openclaw message send --channel clickclack --target thread:msg_123 --message "following up"
```

## مجوزها

دامنه‌های توکن ClickClack توسط API ClickClack اعمال می‌شوند.

- `bot:read`: خواندن داده‌های فضای کاری/کانال/پیام/رشته/DM/بی‌درنگ/نمایه.
- `bot:write`: `bot:read` به‌همراه پیام‌های کانال، پاسخ‌های رشته، DMها و بارگذاری‌ها.
- `bot:admin`: `bot:write` به‌همراه ایجاد کانال.

OpenClaw برای گفت‌وگوی عادی عامل فقط به `bot:write` نیاز دارد.

## عیب‌یابی

- `ClickClack is not configured`: مقدار `channels.clickclack.token` یا `CLICKCLACK_BOT_TOKEN` را تنظیم کنید.
- `workspace not found`: مقدار `workspace` را به شناسه یا slug فضای کاری که ClickClack برمی‌گرداند تنظیم کنید.
- پاسخی از ورودی‌ها نمی‌آید: تأیید کنید توکن دسترسی خواندن بی‌درنگ دارد و بات به پیام‌های خودش پاسخ نمی‌دهد.
- ارسال‌های کانال ناموفق‌اند: بررسی کنید بات عضو فضای کاری است و `bot:write` دارد.