ClickClack

ClickClack يربط OpenClaw بمساحة عمل ClickClack مستضافة ذاتيًا عبر رموز بوت 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: قراءة بيانات مساحة العمل/القناة/الرسالة/السلسلة/الرسائل المباشرة/الاتصال الفوري/الملف الشخصي.
• bot:write: bot:read بالإضافة إلى رسائل القنوات، وردود السلاسل، والرسائل المباشرة، والتحميلات.
• bot:admin: bot:write بالإضافة إلى إنشاء القنوات.

لا يحتاج OpenClaw إلا إلى bot:write لدردشة الوكيل العادية.

استكشاف الأخطاء وإصلاحها

• ClickClack is not configured: عيّن channels.clickclack.token أو CLICKCLACK_BOT_TOKEN.
• workspace not found: عيّن workspace إلى معرّف مساحة العمل أو الاسم المختصر الذي يرجعه ClickClack.
• لا توجد ردود واردة: تأكد من أن الرمز لديه وصول قراءة فوري وأن البوت لا يرد على رسائله الخاصة.
• فشل الإرسال إلى القنوات: تحقق من أن البوت عضو في مساحة العمل ولديه bot:write.