返回顶部
u

use-dingding钉钉集成

Interact with DingTalk enterprise workspace using the dws CLI. Required: dws CLI, DWS_CLIENT_ID, DWS_CLIENT_SECRET. Use for: contacts, chat, calendar, todo, approvals, attendance, reports, AITable.

作者: admin | 来源: ClawHub
源自
ClawHub
版本
V 1.1.0
安全检测
已通过
103
下载量
免费
免费
0
收藏
概述
安装方式
版本历史

use-dingding

钉钉工作台技能

使用 dws 命令行工具与钉钉企业工作台进行交互。本技能涵盖全部 12 个产品:通讯录、聊天、机器人、日历、待办、OA(审批)、考勤、DING、日志、多维表、工作台和开发文档。

⚠️ 安全注意事项

安装前请阅读:

  1. 1. 需要凭证:本技能需要来自钉钉开放平台应用的 OAuth 凭证(DWSCLIENTID、DWSCLIENTSECRET)。可能需要企业管理员审批。
  1. 2. 安全安装:dws CLI 安装程序从 GitHub 获取。运行前请检查安装脚本
- 安装脚本:https://github.com/DingTalk-Real-AI/dingtalk-workspace-cli/blob/main/scripts/install.sh - 发布版本:https://github.com/DingTalk-Real-AI/dingtalk-workspace-cli/releases
  1. 3. 自主执行风险:本技能可执行破坏性操作(审批工作流、发送消息、删除记录)。始终先使用 --dry-run,除非您信任该代理,否则限制自主调用。
  1. 4. 最小权限原则:使用具有最小权限的作用域 OAuth 凭证。先在沙箱企业中测试。

前提条件

安装

选项 1:从发布版本安装(推荐)

从 https://github.com/DingTalk-Real-AI/dingtalk-workspace-cli/releases 下载预构建二进制文件

选项 2:从源码构建(更安全)

bash
git clone https://github.com/DingTalk-Real-AI/dingtalk-workspace-cli.git
cd dingtalk-workspace-cli
go build -o dws ./cmd
cp dws ~/.local/bin/

选项 3:安装脚本(请先检查!)

bash

macOS / Linux - 运行前请检查脚本


curl -fsSL https://raw.githubusercontent.com/DingTalk-Real-AI/dingtalk-workspace-cli/main/scripts/install.sh | sh

Windows (PowerShell) - 运行前请检查脚本

irm https://raw.githubusercontent.com/DingTalk-Real-AI/dingtalk-workspace-cli/main/scripts/install.ps1 | iex

身份认证

推荐:交互式登录(安全的密钥链存储)

bash
dws auth login --client-id <你的应用Key> --client-secret <你的应用Secret>

令牌加密存储在系统密钥链(macOS/Windows)或 libsecret(Linux)中

替代方案:环境变量(谨慎使用)

bash
export DWSCLIENTID=<你的应用Key>
export DWSCLIENTSECRET=<你的应用Secret>
dws auth login

⚠️ 安全提示:环境变量可能在进程列表和日志中暴露。生产环境建议使用交互式登录。

安全执行指南

针对代理

  • - --dry-run始终先使用进行变更操作以预览 API 调用
  • --yes:跳过确认提示(仅在通过 --dry-run 验证后使用)
  • --jq:提取特定字段以减少令牌消耗
  • --fields:仅返回所需字段

推荐工作流程

bash

1. 预览操作


dws todo task create --title 测试 --executors user123 --dry-run

2. 验证输出是否正确

3. 执行(仅在预览正确时)

dws todo task create --title 测试 --executors user123 --yes

自动纠错

dws 自动纠正常见的 AI 错误:

  • - --baseId → --base-id(驼峰式转连字符式)
  • --timeout30 → --timeout 30(粘性参数拆分)
  • --tabel-id → --table-id(模糊匹配)
  • yes → true,2024/03/29 → 2024-03-29(值规范化)

发现与自省

在发起调用前,先发现可用能力:

bash

列出所有产品和工具数量


dws schema --jq .products[] | {id, tool_count: (.tools | length)}

检查特定工具的参数模式

dws schema aitable.query_records --jq .tool.parameters

查看必填字段

dws schema aitable.query_records --jq .tool.required

列出所有产品 ID

dws schema --jq .products[].id

按产品快速参考

通讯录

bash

按关键词搜索用户


dws contact user search --keyword 工程

获取当前用户资料

dws contact user get-self --jq .result[0].orgEmployeeModel | {name: .orgUserName, dept: .depts[0].deptName}

按名称搜索部门

dws contact dept search --keyword 工程

列出部门成员

dws contact dept members --dept-id <部门ID>

聊天

bash

以机器人身份发送消息


dws chat message send-by-bot --robot-code <机器人CODE> --group <群ID> --title 周报 --text @report.md

列出群组

dws chat group list

获取群组信息

dws chat group get --group-id <群ID>

日历

bash

列出日历事件


dws calendar event list

创建事件

dws calendar event create --title 团队会议 --start 2024-03-29T14:00:00Z --end 2024-03-29T15:00:00Z

查找空闲时段

dws calendar participant busy --user-ids <用户ID1>,<用户ID2> --start 2024-03-29 --end 2024-03-30

搜索会议室

dws calendar room search --keyword 会议室

待办

bash

创建待办


dws todo task create --title 审查 PR --executors <你的用户ID> --yes

列出待办

dws todo task list

标记为完成

dws todo task done --task-id <任务ID>

审批(OA)

bash

列出待审批


dws oa approval list --status pending

审批实例

dws oa approval approve --instance-id <实例ID> --comment 已批准

驳回实例

dws oa approval reject --instance-id <实例ID> --comment 需要修改

考勤

bash

查看我的考勤记录


dws attendance record list --user-id <你的用户ID>

查看团队排班

dws attendance shift list --dept-id <部门ID>

日志

bash

查看今日收到的日志


dws report list --type received --start-date 2024-03-29 --end-date 2024-03-29

创建日志

dws report create --template-id <模板ID> --content @report.md

多维表

bash

查询记录


dws aitable record query --base-id ID> --table-id ID> --limit 10

创建记录

dws aitable record create --base-id ID> --table-id ID> --fields {name: 任务1, status: open}

列出多维表

dws aitable base list

列出多维表中的表格

dws aitable table list --base-id

输出控制

jq 过滤

bash

提取特定字段


dws contact user search --keyword 工程 --jq .result[] | {name: .orgUserName, userId: .userId}

统计结果数量

dws todo task list --jq .result | length

字段选择

bash

仅返回特定字段


dws aitable record query --base-id ID> --table-id ID> --fields invocation,response

文件输入

bash

从文件读取


dws chat message send-by-bot --robot-code <机器人CODE> --group <群ID> --text @message.md

从标准输入管道

cat message.md | dws chat message send-by-bot --robot-code <机器人CODE> --group <群ID>

常见工作流

请参阅 scripts/ 目录中的捆绑脚本以进行批量操作:

安全第一: 所有变更脚本默认使用 --dry-run 模式。您必须显式传递 --execute 才能执行实际更改。

| 脚本 | 描述 |
|--------|-------------|
| calendarscheduleme

标签

skill ai

通过对话安装

该技能支持在以下平台通过对话安装:

OpenClaw WorkBuddy QClaw Kimi Claude

方式一:安装 SkillHub 和技能

帮我安装 SkillHub 和 use-dingding-1775891350 技能

方式二:设置 SkillHub 为优先技能安装源

设置 SkillHub 为我的优先技能安装源,然后帮我安装 use-dingding-1775891350 技能

通过命令行安装

skillhub install use-dingding-1775891350

下载

⬇ 下载 use-dingding v1.1.0(免费)

文件大小: 27.25 KB | 发布时间: 2026-4-12 11:48

v1.1.0 最新 2026-4-12 11:48
- Add support for mapping CSV column names to AITable field names in import_records.py using a new --field-map argument.
- Update documentation in SKILL.md to reflect the new --field-map option for importing records.
- Improves bulk data migration workflows with flexible column/field alignment.

Archiver·手机版·闲社网·闲社论坛·羊毛社区· 多链控股集团有限公司 · 苏ICP备2025199260号-1

Powered by Discuz! X5.0   © 2024-2025 闲社网·线报更新论坛·羊毛分享社区·http://xianshe.com

p2p_official_large
返回顶部