Chats
The Chats page shows every connected conversation where Clark is active. Use it to check channel status, review recent context, and identify the single Admin / Master Chat.
Chat Types
| Type | Purpose |
|---|---|
| Telegram group | Team discussions, operational work, documents, tasks, and digests. |
| Telegram private chat | Admin setup, direct questions, registration, and private work. |
| Slack channel | Team collaboration in Slack, with context saved silently. |
| Slack DM | Direct conversation with Clark, no mention required. |
| Slack thread | Focused follow-up on a file, answer, task, or summary. |
| Admin / Master Chat | The one protected Telegram chat with cross-chat summaries, tasks, and document access. |
Connect a Telegram Chat
- Add
@xdocai_botto the Telegram group, or open a private chat with the bot. - Send
/link <tenant_id>in that chat. For example:/link admin-0501-ccf9. - Wait for the confirmation message with the workspace name, Tenant ID, and connected chat count.
- Refresh the Chats page in the dashboard.
You do not need to mention Clark before /link. Telegram commands such as /link@xdocai_bot <tenant_id> also work. If the chat was linked to another test workspace, Clark moves it and shows Moved from: ....
Regular /link <tenant_id> connects an isolated working chat. It can use its own messages, tasks, documents, and memory, but it cannot run cross-chat commands.
Set the Admin / Master Chat
Use a separate command for the workspace master chat:
/link_admin <tenant_id>
You can also send:
/link admin <tenant_id>
The Admin / Master Chat can be a private Telegram chat with the bot or a dedicated admin group. Only one master chat can exist per workspace. When you link a new one, Clark removes master access from the previous master chat and keeps cross-chat commands available only in the new master chat.
Listener mode
In team chats Clark listens quietly and saves context. It responds when:
- someone says
ClarkorКларк; - someone tags the bot;
- someone replies to a Clark message;
- a direct/private conversation is used;
- a Slack slash command is used.
In Telegram, /listener can toggle a more proactive mode where Clark may step into the conversation when it sees a useful reason.
Add a Team Member From Telegram
CEO/Admin users can add a person to the Team dashboard from Telegram:
Clark, добавь @memera в панель, он занимается логистикой и документами, статус менеджер
Clark creates or updates the Team member, saves the description as Bio, and assigns the requested role. Supported statuses are client, manager, admin, and member.
Master Chat Commands
| Command | Result |
|---|---|
/link_admin <tenant_id> | Make the current Telegram chat the single Admin / Master Chat. |
/sum all | Daily digest across connected chats. |
/sum_week all | Weekly digest across connected chats. |
/tasks all | Tasks grouped across chats. |
/stats | Current chat statistics. |
Automatic Summaries
In chat settings, admins can turn on daily and weekly summaries. Daily summaries run Monday through Thursday at the local end-of-day time and are skipped if there were no messages in the previous 24 hours. Weekly summaries run every Monday at 10:00 in the CEO/admin timezone and cover the previous week. Clark sends them to Telegram or Slack according to the connected chat, can route them privately to the CEO/admin, and saves them in Memory.
Troubleshooting
| Problem | Fix |
|---|---|
| Chat is missing | Send /link <tenant_id> in Telegram, or install the Slack app and send a test message, then refresh the dashboard. |
| Clark does not answer | Mention the bot directly or use a private chat/DM. |
| Wrong chat is master | Send /link_admin <tenant_id> in the correct private bot chat or admin group, then refresh the dashboard. |
| Slack messages are not processed | Check that the Slack app is installed and has channel permissions. |