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

   <workspace>/skills/

   .
2. Install Python deps once (workspace venv recommended):

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

3. 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 <command> [args]

• Or cwd = skill folder (

  skills/mooteam

  ):
  

  python3 scripts/main.py <command> [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 <id>

• Инфо:

  python3 scripts/main.py project-info --id <project_id>

• Обновить:

  python3 scripts/main.py project-update --id <project_id> --name "Имя"

• Удалить:

  python3 scripts/main.py project-delete --id <project_id> --force

• Добавить в проект:

  python3 scripts/main.py project-team-add --project <id> --user <id>

• Убрать из проекта:

  python3 scripts/main.py project-team-remove --map_id <id>

Tasks

• Список:

  python3 scripts/main.py tasks --project <project_id>

• Создать:

  python3 scripts/main.py task-create --project <id> --header "Заголовок" --user_id <executor_id>

• Инфо:

  python3 scripts/main.py task-info --id <task_id>

• Обновить:

  python3 scripts/main.py task-update --id <id> --header "..."

  (опционально

  --status_id

  )
• Удалить:

  python3 scripts/main.py task-delete --id <task_id>

Drafts

• Текущий черновик:

  python3 scripts/main.py task-draft

• Обновить:

  python3 scripts/main.py task-draft-update --header "..." --project <id>

• Задача из черновика:

  python3 scripts/main.py task-from-draft

Comments

• Список:

  python3 scripts/main.py comments --task_id <id>

• Создать:

  python3 scripts/main.py comment-create --task_id <id> --text "..."

• Удалить:

  python3 scripts/main.py comment-delete --id <comment_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 <task_id>

  ,

  stop

• time-create|time-update|time-delete

  ,

  task-time --task_id <id>

  ,

  time-list

Activity

• activity

  (опции

  --project

  ,

  --user

  ,

  --type

  )

• activity-projects

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

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