dingtalk-workspace-cli(dws)打造数字员工DEAP创建、发布与本地Agent接入完整流程【免费下载链接】dingtalk-workspace-cliDingTalk Workspace is an officially open-sourced cross-platform CLI tool from DingTalk. It unifies DingTalk’s full suite of product capabilities into a single package, is designed for both human users and AI agent scenarios.项目地址: https://gitcode.com/gh_mirrors/di/dingtalk-workspace-clidingtalk-workspace-cli命令简称dws是钉钉官方开源的跨平台命令行工具也是打造钉钉数字员工的完整工具链一套命令覆盖 DEAP 数字员工的创建、能力挂载、发布以及本地 Agent 接入全流程。本文面向新手带你用最短路径完成从 0 到 1 的数字员工搭建。一、先看懂数字员工全生命周期 4 步走dws dingtalk-tag是数字员工的核心命令组把整个流程拆成 4 步步骤命令说明1️⃣ 创建草稿manage create创建员工并返回agentUuid不自动发布2️⃣ 调优挂载save-draft/capability补全人设、可见范围挂载 Skill / MCP 能力3️⃣ 发布上线manage publish高影响操作先--dry-run再确认执行4️⃣ 本地接入connect把已发布的local_agent员工接到 Codex、Claude Code 等本地 Agent 所有写操作统一遵循「先--dry-run预览 → 确认后加--yes执行」的安全约定Agent 和人类用户都不会误操作。二、准备工作3 条命令装好 dws# macOS / Linux 一键安装 curl -fsSL https://gitcode.com/gh_mirrors/di/dingtalk-workspace-cli/raw/main/scripts/install.sh | sh # 验证安装 dws version # 登录主管账号数字员工操作需使用主管身份 dws auth login安装脚本只依赖curl tar无需 Go、git 等开发环境。确认登录状态可用dws auth status查看。三、第一步一条命令创建数字员工草稿创建时必须显式指定类型dws dingtalk-tag manage create \ --name 值班助手 \ --description 处理值班问题 \ --type local_agent \ --prompt 你是值班助手负责分析问题并提供处理建议。 \ --dry-run --format json两个关键参数的含义--type open_code平台托管型员工--type local_agent本地 Agent 型员工将接入 Codex、Qoder、Gemini 等本地模型省略--prompt时自动填充默认人设。确认预览无误后把--dry-run换成--yes执行命令返回的agentUuid就是后续所有操作的主键。可选参数还支持--avatar-url可传本地图片路径CLI 自动上传、--response-mode默认mention_only、--supervisor-user-id等。四、第二步人设、可见范围与能力挂载草稿创建后用三条命令调优1. 基础信息微调只更新显式传入的字段dws dingtalk-tag manage save-draft --agent-uuid agentUuid \ --description 新职责描述 --dry-run --format json2. 设置可见范围# 全员可见 dws dingtalk-tag manage set-visibility --agent-uuid agentUuid --visibility ALL --dry-run # 或指定成员/部门 dws dingtalk-tag manage set-visibility --agent-uuid agentUuid --visibility PARTIAL --user-ids userId --dry-run3. 挂载 Skill / MCP 能力Skill 从本地 ZIP 创建自动校验完整性、50 MiB 上限并流式上传MCP 敏感配置放在本地 JSON 文件中避免明文进命令行# 挂载 Skill自动挂载到草稿不发布 dws dingtalk-tag capability skill create --agent-uuid agentUuid --file ./my-skill.zip --dry-run --format json # 挂载 MCP dws dingtalk-tag capability mcp create --agent-uuid agentUuid --config-file ./mcp.json --dry-run --format jsonlist/query为只读查询create、update、delete 均只操作草稿挂载不会自动发布上线永远由你显式决定。五、第三步发布上线并核验# 发布前预览 dws dingtalk-tag manage publish --agent-uuid agentUuid --dry-run --format json # 确认后执行 dws dingtalk-tag manage publish --agent-uuid agentUuid --yes --format json # 核验已发布配置 dws dingtalk-tag manage detail --agent-uuid agentUuid --snapshot published --format json--snapshot支持draft草稿和published已发布两种快照。注意细节从未发布过的员工查published会返回NOT_FOUNDstatusonline表示已发布但它不等同于本地 Agent 正在运行。六、第四步本地 Agent 接入完整流程发布完成后把local_agent型员工接到本地 Agent# 首次接入Codex 为例支持 Qoder、Claude Code、Gemini、OpenCode、custom、DSH 等 dws dingtalk-tag connect --agent-uuid agentUuid --channel codex --daemon --alwayson --dry-run --format json--daemon --alwayson表示后台常驻运行。连接成功后常用运维命令dws dingtalk-tag connect status --agent-uuid agentUuid --format json # 查状态 dws dingtalk-tag connect stop --agent-uuid agentUuid # 暂停 dws dingtalk-tag connect restart --agent-uuid agentUuid # 恢复 dws dingtalk-tag connect unbind --agent-uuid agentUuid --dry-run # 解绑几个新手最容易踩的坑换 Agent 或换设备必须先connect unbind确认成功再执行新的connect两步之间员工处于未绑定状态仅保存员工登录 ProfileA2A 等场景用dws dingtalk-tag manage login --agent-uuid agentUuid它不创建绑定、不调用本地 Agent设备标识deviceId首次随机生成后持久化保存不要把设备标识文件复制到另一台机器。七、排障清单 ✅现象处理方式status中transportReadyfalse传输未验证检查员工 Bus 是否需要升级发布详情请求失败保留原始错误原因先查主管登录态消息未收到回复用dws dingtalk-tag run run-status按来源反查执行状态换绑失败不要强行启动新实例先完成unbind再connect 官方文档已随仓库开放建议搭配阅读docs/deap-agent-skill-mcp.md — Skill / MCP 能力管理详解docs/digital-employee-adapters.md — 本地 Agent 适配器与生命周期docs/digital-employee-server-binding.md — 服务端设备绑定机制docs/deap-digital-employee-detail.md — 详情快照参数说明命令实现源码internal/helpers/deap_agent.go写在最后dingtalk-workspace-cli 把「创建数字员工 → 挂载能力 → 发布 → 接入本地 Agent」压缩成了 4 组清晰的命令全程 dry-run 可预览、状态可回读、失败可恢复。无论是给团队搭一个值班助手还是让自己的 Codex / Claude Code 成为数字员工的大脑这条链路都是目前最完整的开源方案。【免费下载链接】dingtalk-workspace-cliDingTalk Workspace is an officially open-sourced cross-platform CLI tool from DingTalk. It unifies DingTalk’s full suite of product capabilities into a single package, is designed for both human users and AI agent scenarios.项目地址: https://gitcode.com/gh_mirrors/di/dingtalk-workspace-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考