Lark CLI
lark-cli
Официальный CLI Lark и Feishu со скиллами для агентов: сообщения, документы, таблицы, календарь, почта и задачи из терминала, более 200 команд
- 17 807 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент действует от вашего имени: отправляет сообщения и письма, правит документы и таблицы, одобряет и отклоняет согласования
- После входа CLI хранит данные авторизации в системном хранилище ключей и читает чаты, почту и документы в пределах выданных прав
- Установка выполняет скрипт `postinstall`, а в Feishu и Lark уходят служебные сигналы о системе и устройстве
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/lark-cliОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент действует от вашего имени: отправляет сообщения и письма, правит документы и таблицы, одобряет и отклоняет согласования
- После входа CLI хранит данные авторизации в системном хранилище ключей и читает чаты, почту и документы в пределах выданных прав
- Установка выполняет скрипт `postinstall`, а в Feishu и Lark уходят служебные сигналы о системе и устройстве
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
`lark-cli` — официальный консольный клиент Lark и Feishu от команды larksuite. Он ставится из npm командой `npx @larksuite/cli@latest install` и дает более 200 команд в 18 областях: сообщения, документы, диск, таблицы Base и Sheets, презентации, календарь, почта, задачи, встречи и протоколы, согласования, OKR, учет рабочего времени и вики. Команды устроены в три слоя: ярлыки с префиксом `+`, например `lark-cli calendar +agenda`, команды API, собранные по метаданным платформы, и прямой вызов любого из более 2500 методов Open Platform через `lark-cli api`. Для агентов проект ставит скиллы из папки `skills/`, в которой 28 каталогов: общий `lark-shared` с настройкой приложения, входом, сменой личности и правилами безопасности, который подгружают все остальные, и отдельные по областям, например `lark-calendar`, `lark-im`, `lark-doc`, `lark-mail`, `lark-base`. Есть два скилла-сценария, сводка по встречам и утренний отчет по повестке, а `lark-skill-maker` помогает создавать собственные скиллы. Работа с аккаунтом идет в два шага: `lark-cli config init` создает приложение, `lark-cli auth login --recommend` через браузер запрашивает рекомендованный набор прав. Режим входа `--no-wait` сразу возвращает ссылку подтверждения и не блокирует агента, ключи `--as user` и `--as bot` переключают личность вызова, а `--dry-run` показывает запрос без отправки. Вывод по умолчанию идет в JSON с полем `ok`, доступны также `table`, `ndjson` и `csv`.
Для кого. Для сотрудников и разработчиков, которые работают в Lark или Feishu и хотят поручить агенту календарь, почту, документы, задачи и таблицы, а также для интеграторов, встраивающих CLI в свои платформы.
Подходит, если
- Агенту нужно читать расписание, создавать встречи и искать свободные переговорные в календаре Lark
- Нужно найти и прочитать сообщения в чатах, ответить в чате или отправить сообщение от имени бота
- Документы, таблицы Base и Sheets, вики и файлы диска надо создавать и править из терминала
- Нужна сводка прошедших встреч по протоколам или утренний отчет по повестке и задачам: для этого есть сценарии `lark-workflow-meeting-summary` и `lark-workflow-standup-report`
- Нужен вызов метода Open Platform, которого нет среди ярлыков: `lark-cli api` и `lark-cli schema` показывают параметры метода
Не подходит, если
- Нужно управлять проектами в Meegle: для этого у larksuite есть отдельный `meegle-cli`, и документация просит ставить его отдельно
- Бот должен работать в групповых чатах: автор советует держать бота личным помощником и не добавлять его в группы
- Нужны централизованные ключи, общий журнал аудита и ограниченный набор команд для корпоративной платформы: для этого у авторов есть отдельное руководство по встраиванию lark-cli в своего агента
- Ваша организация работает в DingTalk: для него в каталоге есть DingTalk Workspace CLI
Пример запроса к агенту
Покажи мои встречи на завтра в Lark, найди свободное окно на час и предложи время, но ничего не создавай, пока я не подтвержуОграничения
- После авторизации агент действует от вашего имени в выданных пределах. Автор предупреждает о галлюцинациях модели, непредсказуемом выполнении и инъекции промпта и не советует ослаблять защиту по умолчанию.
- По умолчанию CLI отправляет в официальные домены Feishu и Lark сигналы защиты от кражи токена: тип операционной системы и модель устройства. Отключает их команда `lark-cli config risk-control off`.
- Для новых локальных учетных данных включен режим DPoP `preferred`. Режимы `disabled` и `required` задаются командой `lark-cli config set dpop`, после смены нужно войти заново.
- Для установки нужен Node.js, для сборки из исходников Go 1.23 или новее и Python 3. Пакет `@larksuite/cli` выполняет `postinstall` и собран для macOS, Linux и Windows на процессорах x64, arm64 и riscv64.
- В документации число скиллов указано как 24 и как 26, а в папке `skills/` лежат 28 каталогов. Работа через API требует принять условия сервисов Feishu и Lark. Лицензия MIT.
Как отключить. Команда `lark-cli auth logout` завершает сеанс и удаляет сохраненные данные входа. Скиллы удалите из каталога скиллов агента, а пакет уберите тем способом, которым ставили. Приложение, созданное командой `config init`, остается в вашем аккаунте, и убирать его нужно вручную.
Частые вопросы
Как поставить lark-cli и войти в аккаунт?
Выполните `npx @larksuite/cli@latest install`, затем `lark-cli config init` для создания приложения и `lark-cli auth login --recommend` для входа с рекомендованным набором прав. После этого `lark-cli calendar +agenda` покажет расписание. Сборка из исходников: `git clone`, затем `make install`, а скиллы ставит `npx skills add larksuite/cli -y -g`.
Чем ярлыки с плюсом отличаются от команд API?
Ярлыки с префиксом `+` рассчитаны на людей и агентов: у них разумные значения по умолчанию, вывод в виде таблицы и пробный запуск. Команды API собраны по метаданным платформы и повторяют конечные точки один к одному, их более сотни. Для остального есть `lark-cli api` с прямым вызовом любого метода.
Как агенту войти и не заблокировать терминал?
Команда `lark-cli auth login --domain calendar --no-wait` сразу возвращает ссылку подтверждения. Продолжить ожидание можно позже командой `lark-cli auth login --device-code` с полученным кодом. Для первичной настройки приложения агенту рекомендуют запускать `config init --new` в фоне и передавать ссылку пользователю.
Как проверить команду до отправки?
Добавьте `--dry-run`: например, `lark-cli im +messages-send --chat-id oc_xxx --text "hello" --dry-run` покажет запрос без отправки. Параметры любого метода выводит `lark-cli schema`, например `lark-cli schema calendar.events.instance_view`.
Как понять, что команда выполнилась успешно?
По полю `ok == true` в ответе или по коду выхода 0. Успешный ответ не содержит полей `code` и `msg`, как сырые ответы OpenAPI. Ошибки идут в stderr с ненулевым кодом, а поле `code` встречается только внутри `error`.
Как выполнять команды от имени пользователя или бота?
Ключ `--as user` выполняет команду от вашей учетной записи, `--as bot` от бота приложения. Например, `lark-cli im +messages-send --as bot --chat-id "oc_xxx" --text "Hello"` отправит сообщение от бота. Набор прав задается при входе ключами `--domain`, `--scope` или `--recommend`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI и скилл для Slack: агент читает каналы и треды, ищет сообщения и файлы, а черновики и отправку выполняет только по вашему запросу
Пачка API: скиллы и CLI
Пачка API
Официальные скиллы агентов и CLI для корпоративного мессенджера Пачка: сообщения, чаты, сотрудники, боты, задачи и поиск
DingTalk Workspace CLI (dws)
DingTalk Workspace CLI
Официальный CLI DingTalk со скиллами для агентов: чаты, календарь, задачи, почта, документы и согласования организации из терминала
CLI на Go, который держит скиллы, агентов и правила в одном месте и синхронизирует их во все AI-агенты одной командой
Набор бытовых скиллов для агента: веб-поиск, автоматизация браузера, Gmail, Google Календарь и Диск, расшифровка речи и субтитры YouTube
Skills Manager хранит скиллы в одной библиотеке и подключает их через симлинки к Claude Code, Cursor, Codex и другим агентам без копирования файлов
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Lark CLI (эта запись) | да | 17 807 | |
| DingTalk Workspace CLI (dws) | да | 3 784 | официальный CLI DingTalk со скиллами: чаты, календарь, задачи, почта, документы и согласования организации |
| botmux | нет | 1 741 | botmux связывает Lark и Feishu с Claude Code |
| octo-cli | да | 920 | консольный клиент экосистемы Octo для ИИ-агентов |
Коротко о README
В репозитории лежит CLI на Go с оболочкой для npm (`package.json` и папка `scripts/`), 28 каталогов скиллов в `skills/`, каталог `isolated-skills/lark-suite` с одним маршрутизирующим скиллом на китайском и `AGENTS.md` с правилами для контрибьюторов и агентов. Главная страница есть на английском и китайском: причины выбрать CLI, выбор между личным и корпоративным путем, таблица возможностей по областям, установка и быстрый старт для человека и для агента, таблица скиллов, команды авторизации, три слоя команд, форматы вывода, постраничная выгрузка, пробный запуск, схема методов и раздел с предупреждениями.