Team
The Team page manages workspace members, roles, AI-visible bios, allowed capability groups, and daily limits for model-slot capabilities.
What Works
| Area | Behavior |
|---|---|
| Add Member | Adds or updates a member by Telegram user ID or @username. |
| Role | Controls Clark's RBAC in chat and tool calls. |
| Bio / Info | Stored on the user profile and included in Clark's system prompt. |
| Allowed Tools | Narrows the capabilities Clark may use for this user. Empty means role defaults. |
| Usage Limits | Daily OCR, search, image generation, and speech generation limits are enforced per user. |
| What Clark knows | Read-only facts and summaries that mention this person. |
Roles
| Role | Typical access |
|---|---|
| CEO | Full access. |
| Admin | Full tool and admin access. |
| Manager | Documents, tasks, CRM, summaries, email, RAG, and generation. |
| Member | Everyday work: documents, tasks, knowledge search, summaries, templates. |
| Client | External profile with limited access and no internal admin/CRM tools. |
Add Members From Telegram
Workspace CEO/Admin users can add or update a Team member directly in Telegram:
Clark, добавь @memera в панель, он занимается логистикой и документами, статус менеджер
Clark saves the person to the Team dashboard, stores the description in Bio, and syncs the role to local PostgreSQL user_profiles. Supported statuses are клиент/client, менеджер/manager, администратор/admin, and участник/member.
If Clark already knows the numeric Telegram user ID for that @username, it uses it immediately. Otherwise the member is saved by @username and starts applying to the real Telegram user after Clark sees that user in a chat.
Allowed Tools
Tool groups map to real Clark capabilities. For example, crm enables CRM lead/deal tools, templates enables template listing/filling, ocr enables document parsing on upload, search enables internet/search, image_generation enables image generation, and speech_generation enables generated voice replies. If no group is selected, Clark uses the default capabilities allowed by the member's role.
Limits
OCR / day, Search / day, Image generation / day, and Speech generation / day are enforced per user. 0 means unlimited. If the voice limit is exceeded during a voice reply, Clark answers in text and adds a short note. Other exceeded limits stop the action with a limit message.
Storage
Team edits are stored in Redis and synchronized with the local PostgreSQL user_profiles table. Users created by purchase or /register are pulled into Team from the same local profile table.
Good Practice
- Use real names or recognizable usernames.
- Keep bios short but specific: role, responsibilities, preferences, working hours.
- Give Admin/CEO roles only to people who should have broad access.
- Remove users when they leave the company.
- Add people here if they should appear as assignees in Tasks.