MooTeam

English (ClawHub)

MooTeam is a project / task / CRM API integration. The agent should run the CLI via exec using python3 and paths below.

Install (community)

1. clawhub install mooteam (or your chosen slug after publish) into /skills/.
2. Install Python deps once (workspace venv recommended):

python3 -m pip install -r skills/mooteam/requirements.txt

1. Set environment variables (gateway .env, host env, or openclaw.json → skills.entries.mooteam.env):
• MOOTEAM_API_TOKEN — Bearer token
• MOOTEAM_COMPANY_ALIAS — X-MT-Company header value

How to invoke scripts

• Workspace root as cwd (typical for OpenClaw):

python3 skills/mooteam/scripts/main.py [args]

• Or cwd = skill folder (skills/mooteam):

python3 scripts/main.py [args]

Optional: add the workspace .venv to tools.exec.pathPrepend so python3 picks up dependencies installed there.

Обзор (RU)

Интерфейс для интеграции с MooTeam API v1: проекты, задачи (включая черновики), тайм-трекинг, метки, воркфлоу, логи активности.

Основные возможности

• Проекты и команды: проекты, состав команды на проекте.
• Задачи и черновики: задачи, комментарии, черновик → задача.
• Таймер и время: один активный таймер; ручные time logs.
• Справочники: воркфлоу, статусы, группы меток и метки.
• Activity logs: фильтры по проекту, пользователю, типу события.

Правила для агента

1. ID из API: не угадывать ID; при сомнениях — projects, statuses, user-profiles.
2. Черновик: перед сложным task-create проверить task-draft; при готовности — task-from-draft.
3. Таймер: перед start вызвать timer-current; при активном таймере на другой задаче — сначала stop.
4. Контекст задачи: по возможности подтягивать комментарии и time logs.
5. Списки: в ответе пользователю — укороченно (id, title, status).

Структура навыка

• scripts/MooTeamClient.py — HTTP-клиент (requests).
• scripts/main.py — CLI для вызовов из агента.
• references/api_docs.md — краткий справочник методов.

Переменные окружения

• MOOTEAM_API_TOKEN
• MOOTEAM_COMPANY_ALIAS

Команды CLI

Team

Список профилей: python3 scripts/main.py user-profiles

Projects

• Список: python3 scripts/main.py projects
• Создать: python3 scripts/main.py project-create --name "Название" --workflow_id
• Инфо: python3 scripts/main.py project-info --id
• Обновить: python3 scripts/main.py project-update --id --name "Имя"
• Удалить: python3 scripts/main.py project-delete --id --force
• Добавить в проект: python3 scripts/main.py project-team-add --project --user
• Убрать из проекта: python3 scripts/main.py project-team-remove --map_id

Tasks

• Список: python3 scripts/main.py tasks --project
• Создать: python3 scripts/main.py task-create --project --header "Заголовок" --user_id
• Инфо: python3 scripts/main.py task-info --id
• Обновить: python3 scripts/main.py task-update --id --header "..." (опционально --status_id)
• Удалить: python3 scripts/main.py task-delete --id

Drafts

• Текущий черновик: python3 scripts/main.py task-draft
• Обновить: python3 scripts/main.py task-draft-update --header "..." --project
• Задача из черновика: python3 scripts/main.py task-from-draft

Comments

• Список: python3 scripts/main.py comments --task_id
• Создать: python3 scripts/main.py comment-create --task_id --text "..."
• Удалить: python3 scripts/main.py comment-delete --id

Workflows & statuses

• Воркфлоу: python3 scripts/main.py workflows / workflow-create / workflow-info / workflow-update / workflow-delete
• Статусы: python3 scripts/main.py statuses и status-create|status-info|status-update|status-delete

Labels

• Группы: label-groups, label-group-create|update|delete
• Метки: labels, label-create|label-info|label-update|label-delete

Timer & time logs

• timer-current, start , stop
• time-create|time-update|time-delete, task-time --task_id , time-list

Activity

• activity (опции --project, --user, --type)
• activity-projects

Примеры запросов пользователя

• «Покажи проекты и добавь задачу … в проект X»
• «Сколько времени по задаче #…»
• «Лог активности по проекту …»
• «Запусти таймер на задаче …»