ClickClack

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

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

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

یک توکن ربات در ClickClack بسازید:

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

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

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

{  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",    },  },}

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

export CLICKCLACK_BOT_TOKEN="ccb_..."openclaw gateway

اگر plugins.allow یک فهرست محدودکننده و غیرخالی باشد، انتخاب صریح ClickClack در راه‌اندازی کانال یا اجرای openclaw plugins enable clickclack مقدار clickclack را به آن فهرست اضافه می‌کند. نصب هنگام آغازبه‌کار از همان رفتار انتخاب صریح استفاده می‌کند. این مسیرها plugins.deny یا تنظیم سراسری plugins.enabled: false را نادیده نمی‌گیرند. اجرای مستقیم openclaw plugins install @openclaw/clickclack از سیاست عادی نصب Plugin پیروی می‌کند و ClickClack را نیز در یک فهرست مجاز موجود ثبت می‌کند.

چندین ربات

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

{  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> در یک رشته موجود پاسخ می‌دهد.

نمونه‌ها:

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 را روی شناسه یا نامک فضای کاری بازگردانده‌شده توسط ClickClack تنظیم کنید.
• پاسخی از ورودی‌ها دریافت نمی‌شود: تأیید کنید توکن دسترسی خواندن بلادرنگ دارد و ربات به پیام‌های خودش پاسخ نمی‌دهد.
• ارسال‌های کانال ناموفق‌اند: بررسی کنید ربات عضو فضای کاری است و bot:write دارد.