DingTalk Workspace CLI (dws)
DingTalk Workspace CLI
Официальный CLI DingTalk со скиллами для агентов: чаты, календарь, задачи, почта, документы и согласования организации из терминала
- 3 784 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Команды читают и пишут данные организации: сообщения, почту, календарь, документы и согласования
- Вход открывает агенту доступ к аккаунту DingTalk и токенам, а флаг --yes снимает запросы подтверждения
- Установочный скрипт скачивает и запускает бинарник, а скиллы пишутся в каталоги агента
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/dingtalk-workspace-cliОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Команды читают и пишут данные организации: сообщения, почту, календарь, документы и согласования
- Вход открывает агенту доступ к аккаунту DingTalk и токенам, а флаг --yes снимает запросы подтверждения
- Установочный скрипт скачивает и запускает бинарник, а скиллы пишутся в каталоги агента
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Команда `dws` собирает продукты DingTalk в один исполняемый файл с выводом в JSON, поэтому агент может читать и менять рабочие данные организации без ручных кликов. Через нее доступны контакты, чаты и боты, календарь с переговорными, задачи, согласования OA, учет рабочего времени, отчеты, таблицы AI Table, документы, диск, протоколы встреч, почта, листы и база знаний. Есть и прямой вызов серверных OpenAPI через команду api. Для агентов проект ставит Agent Skills в двух раскладках. По умолчанию это набор по продуктам вроде `dingtalk-calendar` и `dingtalk-chat`, который держит контекст небольшим, а режим `mono` ставит один общий скилл `dws`. Для безопасной работы агента есть флаги --dry-run (показать запрос без выполнения), --yes (пропустить подтверждения) и --jq (вырезать нужные поля). Команда `dws dev connect` связывает робота DingTalk с локальным AI CLI, например Claude Code или Codex: вы упоминаете бота в чате, и он отвечает с помощью агента.
Для кого. Для команд, которые работают в DingTalk, и для разработчиков, которые хотят автоматизировать чаты, календарь, согласования и документы организации через агента.
Подходит, если
- Нужно попросить агента найти свободное время участников и создать встречу с переговорной в календаре DingTalk
- Сводку по задачам, согласованиям или отчетам надо собрать из нескольких разделов DingTalk одной командой
- Агенту нужно искать и читать документы, листы и страницы базы знаний организации, а в документах оставлять комментарии
- Бота DingTalk надо подключить к локальному Claude Code или Codex, чтобы он отвечал в групповом чате
- Скрипт или CI должен вызывать серверные OpenAPI DingTalk с токеном приложения
Не подходит, если
- Ваша организация не включила доступ к CLI: без разрешения администратора вход командой dws auth login не завершится
- Нужен Alpine или другой дистрибутив на `musl`: бинарники Linux собраны под `glibc`, установщик в таких случаях останавливается
- Нужен другой мессенджер: утилита работает только с DingTalk
- Вы не готовы отдать агенту права на отправку сообщений и согласований: часть команд пишет данные организации
Пример запроса к агенту
Покажи мое расписание на сегодня в DingTalk и найди общее свободное время с Ли Мин на этой неделеОграничения
Проект на этапе совместной разработки и обращается к корпоративным данным, поэтому нужна авторизация администратора организации. Для сборки из исходников нужен Go 1.26 или новее и компилятор C. Для вызовов агента без подтверждения служит флаг --yes, перед действиями, которые меняют данные, полезен --dry-run.
Для пользователей в материковом Китае есть зеркало на Gitee и установка через `npmmirror`. Про работу DingTalk из России в описании проекта ничего не сказано.
Как отключить. Удалите бинарник dws и скиллы `dingtalk-*` из каталога скиллов агента. Режим скиллов меняется командой `dws skill setup --mode mono` или `--mode multi`. Доступ приложения организация отзывает в консоли разработчика DingTalk.
Частые вопросы
Как подключить DingTalk к Claude Code или Cursor?
Установите dws, войдите командой dws auth login (в окружении без браузера работает dws auth login --device) и поставьте скиллы: npx skills add DingTalk-Real-AI/dingtalk-workspace-cli -g. После этого агент вызывает команды dws сам. Для Cursor есть и встроенная установка: `dws skill setup --mode multi --target cursor`.
Чем режимы скиллов multi и mono отличаются?
`multi` ставит скиллы по продуктам, например `dingtalk-aitable` и `dingtalk-calendar`, и подходит для задач в одном продукте с небольшим контекстом. `mono` ставит один скилл `dws`, удобный для сквозных сценариев. Команды dws в обоих режимах одинаковы.
Что делать, если организация не включила доступ к CLI?
После выбора организации нажмите «Apply Now»: администратор получит карточку запроса и подтвердит его одним щелчком. Администратор может включить доступ и сам в разделе CLI Access Management платформы разработчиков DingTalk. После одобрения повторите dws auth login.
Как хранятся токены?
Токены шифруются алгоритмом PBKDF2 с AES-256-GCM и привязаны к устройству, дополнительно используются Keychain или DPAPI. По умолчанию токен отправляется только на домены *.dingtalk.com, список настраивается переменной DWS_TRUSTED_DOMAINS.
Как обновить dws?
Командой `dws upgrade`. Флаг --check только проверяет наличие новой версии, --list показывает стабильные релизы, --beta переключает на бета-канал, --version ставит нужный релиз, а --rollback возвращает предыдущую версию из автоматической копии. Обновление проверяет размер и SHA256, и при сбое старая установка остается.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыLark CLI
lark-cli
Официальный CLI Lark и Feishu со скиллами для агентов: сообщения, документы, таблицы, календарь, почта и задачи из терминала, более 200 команд
Библиотека из 229 скиллов для работы и жизни: продажи, маркетинг, финансы, разработка, дизайн и запуск параллельных агентов
CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие
CLI и скилл для Slack: агент читает каналы и треды, ищет сообщения и файлы, а черновики и отправку выполняет только по вашему запросу
Claude-to-IM
claude-to-im
Мост между Claude Code или Codex и мессенджерами: общайтесь с агентом из Telegram, Discord, Feishu, QQ или WeChat
Официальная командная строка Todoist со скиллом для агентов: задачи, проекты и входящие из терминала
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| DingTalk Workspace CLI (dws) (эта запись) | да | 3 784 | ||
| gws | нет | 31 818 | такой же CLI с JSON-выводом и скиллами, но для API Google Workspace | |
| Slack MCP Server | нет | ключ необязателен | 1 872 | MCP-сервер для мессенджера Slack, к DingTalk отношения не имеет |
| Lark CLI | да | 17 807 | официальный CLI Lark и Feishu со скиллами для агентов |
Коротко о README
Страница проекта представляет dws как универсальную консольную утилиту DingTalk для людей, агентов и администраторов. Он содержит способы установки (скрипт, npm, Homebrew, готовые бинарники, сборка из исходников), вход через OAuth в режиме устройства и режим собственного приложения для CI, таблицу сервисов и разделы про безопасность. Отдельно разобраны обновление через dws upgrade, зеркала для материкового Китая и сборка под OpenHarmony.