10分钟搭建钉钉群AI答疑机器人dingtalk-workspace-cli(dws) dev connect连接本地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-clidingtalk-workspace-cli简称 dws是钉钉官方开源的跨平台命令行工具把钉钉全套产品能力整合进一个二进制专为人 AI Agent双场景设计。本文用dws dev connect一条命令把钉钉群里的机器人与你本地的 Claude Code 接通——10 分钟就能拥有一个钉钉群 AI 答疑机器人群里 它 提问它用你电脑上的 AI 回答支持文字和报错截图。整个过程只需四步装工具 → 建机器人 → 接上 AI → 拉进群。一、准备工作一键安装 dws 并登录钉钉1. 安装 dwsdws 已发布为 npm 包只需 Node.js 环境一条命令装好npm 国内用户可加 registry 镜像参数加速npm install -g dingtalk-workspace-cli也可以直接使用仓库自带的一键安装脚本自动下载预编译二进制 Agent skill 文档无需 go / gitmacOS / Linuxscripts/install-devapp.shWindowsscripts/install-devapp.ps1安装完成后验证一下dws version能打印出版本号即安装成功。2. 登录钉钉dws auth login按提示用钉钉扫码即可。dws 采用 OAuth 设备流授权 零信任架构登录态会安全保存在本机。 提示dws dev能力已合入正式版本安装后dws dev app --help能看到robot、credentials、connect等子命令说明环境就绪。二、一分钟创建钉钉群机器人创建机器人是异步任务分两步名字、描述随意改# 1) 提交建号任务记下返回的 taskId dws dev app robot submit --name 我的智能体 --robot-name 小助手 --desc 群内答疑 --yes --format json # 2) 用上一步的 taskId 查结果直到 status 变成 SUCCESS dws dev app robot result --task-id 上一步返回的taskId --format jsonstatus变成SUCCESS后把返回里的unifiedAppId记下来下一步要用。 安全设计建号返回的clientId/clientSecret不需要手工复制——dws 会在运行时通过dev app credentials get后台自动拉取密钥不落地、不进命令行历史。三、核心步骤dws dev connect 连接本地 Claude Codedws dev connect --channel claudecode --unified-app-id 上一步的unifiedAppId参数说明参数作用--channel claudecode指定背后的本地 AI 为 Claude Code--channel auto让 dws 自动识别本机装的 AI 工具Claude Code / Codex / Qoder / Gemini 等--unified-app-id id机器人应用 ID密钥由 dws 后台自动换取这条命令会在本机起一条 Stream 长连接做钉钉群消息 ↔ 本地 Claude Code的双向转发不建号、不产生审批工单关窗口即下线。命令细节可参考官方文档 docs/robot-quickstart.md。⚠️ 安全提示老写法--robot-client-id id --robot-client-secret secret仍可用但密钥会以明文出现在命令行任何本机用户ps -ef都能看到dws 会打印 WARNING。请优先使用--unified-app-id。四、拉进群聊机器人开始答疑在钉钉里打开目标群群设置 → 机器人 → 添加机器人 → 在企业机器人里搜小助手 → 添加。完成现在在群里 小助手 提问试试发文字、发报错截图都能答。五、进阶配置可选按需追加在dev connect命令后面机器人立刻更懂你的业务参数作用--agent-workdir ./项目目录让机器人在你的项目目录里跑能读到和终端一样的本地文件--knowledge-dir ./docs挂载本地知识目录.md/.txt回答自动带上你的资料--agent-model 模型名指定模型和终端保持一致避免终端答得准、机器人答得飘--allowed-users 工号1,工号2用户白名单名单外无法触发--allowed-groups 群ID群白名单--agent-cmd 命令接入内置列表之外的自研 AI 工具只要能一次性跑并输出答案即可想让机器人 7x24 常驻后台dev connect默认前台运行关窗口即下线。想要数字员工级常驻dws 提供了两条路线详见 docs/connect-daemon-service.md--daemon模式推荐快速上手内置守护进程崩溃自动按指数退避重启日志写入~/.dws/connect/key/daemon.logdws dev connect --daemon --channel claudecode --unified-app-id unifiedAppId dws dev connect status --unified-app-id unifiedAppId # 查看状态 dws dev connect stop --unified-app-id unifiedAppId # 停止系统服务macOS launchd / Linux systemd配合前台命令使用开机自启、重启自愈适合生产环境。六、常见问题速查群里 机器人 没反应确认dev connect窗口还开着或 daemon 在运行——关窗口机器人就下线了。提示本地没有装 AI 工具机器人背后需要一个本地 AI CLI先装好 Claude Code 并单独运行一次确认可用再重新执行第三步。机器人回复调用失败通常是本地 AI 未登录或额度用尽单独运行一次 Claude Code 确认其本身可用。机器人答得不如终端准让机器人和终端看到一样的东西、用一样的模型加--agent-workdir指向项目目录、--knowledge-dir挂资料、--agent-model对齐模型。建完机器人搜不到审批工单正常现象。产生审批工单的是建机器人dev app robot submitdev connect只是本地转发不产生工单。命令报zsh: parse error near \n复制的命令里残留了...尖括号占位符把它们整体替换成实际值即可。七、延伸阅读群机器人快速上手docs/robot-quickstart.md守护进程与服务部署docs/connect-daemon-service.md数字员工本地 Agent 适配器Qoder / Codex / Claude Code / Gemini / 自研docs/digital-employee-adapters.md安装与 Agent 接入指南docs/devapp-agent-install-guide.mddev connect命令参考skill 文档skills/multi/dingtalk-misc/references/dev/connect.md发布变更记录CHANGELOG.md10 分钟一条dws dev connect你的本地 Claude Code 就变成了钉钉群里的 AI 答疑机器人。把项目文档挂上--knowledge-dir它还能变成全组都爱用的活知识库 【免费下载链接】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），仅供参考