Files

T

修雨 47354b918a docs(quickstart): make the connect example paste-safe in zsh

The step-3 example used <第二步的clientId> style placeholders; pasting
them verbatim makes zsh treat the angle brackets as redirections and
fail with "parse error near \n" before the CLI even runs (issue
PeterGuy326#11). Use realistic dummy values plus an explicit replace-me
note instead, and add a FAQ entry for anyone still hitting the error
from the old wording. Also bump install snippets to v1.0.53-dws-devapp.

2026-06-12 18:00:56 +08:00

4.2 KiB

Raw Blame History

钉钉 AI 群机器人快速上手

10 分钟搭一个自己的钉钉群答疑机器人：群里 @它提问，它用你本地的 AI（Claude Code / Codex / Qoder 等）回答，支持发文字和报错截图。

只需四步：装工具 → 建机器人 → 接上 AI → 拉进群。

第一步：安装 dws

macOS

打开终端，整段复制执行（Intel / Apple 芯片都适用）：

ARCH=$(uname -m | sed 's/x86_64/amd64/')
mkdir -p ~/.local/bin
curl -fsSL -o /tmp/dws.tar.gz "https://github.com/PeterGuy326/dingtalk-workspace-cli/releases/download/v1.0.53-dws-devapp/dws-darwin-${ARCH}.tar.gz"
tar xzf /tmp/dws.tar.gz -C ~/.local/bin dws
export PATH="$HOME/.local/bin:$PATH"
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
dws version

Windows

打开 PowerShell，整段复制执行：

New-Item -ItemType Directory -Force "$env:USERPROFILE\dws" | Out-Null
Invoke-WebRequest -Uri "https://github.com/PeterGuy326/dingtalk-workspace-cli/releases/download/v1.0.53-dws-devapp/dws-windows-amd64.zip" -OutFile "$env:TEMP\dws.zip"
Expand-Archive -Path "$env:TEMP\dws.zip" -DestinationPath "$env:USERPROFILE\dws" -Force
[Environment]::SetEnvironmentVariable("Path", "$env:Path;$env:USERPROFILE\dws", "User")

然后重新打开一个 PowerShell 窗口，执行 dws version 确认。

两个平台装好后都应显示 dws version v1.0.53-dws-devapp。其他平台（Linux / Windows ARM）的安装包在 Releases 页面下载。

登录钉钉

dws auth login

按提示扫码登录即可。

第二步：创建机器人

一条命令建号（名字、描述可以改成你自己的）：

dws devapp robot create --app-name 我的智能体 --robot-name 小助手 --desc "群内答疑" --yes --format json

返回结果里的 clientId 和 clientSecret 保存好，下一步要用。

第三步：把机器人接上你本地的 AI

dws devapp robot connect --channel auto --robot-client-id dingxxxxxxxxxxxxxxxx --robot-client-secret yyyyyyyyyyyyyyyyyyyy

把 dingxxxxxxxxxxxxxxxx 和 yyyyyyyyyyyyyyyyyyyy 换成第二步返回的 clientId 和 clientSecret 的实际值
--channel auto 自动识别你电脑上装的 AI 工具（Claude Code / Codex / Qoder / Gemini 等）
这个命令是前台运行的：窗口开着机器人在线，关掉窗口机器人下线

第四步：拉进群聊

在钉钉里打开目标群：

群设置 → 机器人 → 添加机器人 → 在企业机器人里搜"小助手"（你起的名字）→ 添加

完成。现在在群里 @小助手提问试试，发文字、发报错截图都能答。

进阶配置（可选）

按需加在第三步的命令后面：

参数	作用
`--knowledge-dir ./docs`	挂本地知识目录（.md/.txt），回答自动带上你的资料
`--allowed-users 工号1,工号2`	用户白名单，名单外的人无法触发机器人
`--allowed-groups 群ID`	群白名单
`--user-rate-limit 0`	关闭限流（默认每人每分钟 20 条）

常见问题

执行命令报 zsh: parse error near '\n'？ 命令里残留了 <...> 尖括号占位符（旧版文档的写法），shell 会把尖括号当成重定向符。把占位符整体替换成实际值、不要保留尖括号，再执行。

群里 @机器人没反应？ 确认第三步的 robot connect 窗口还开着——关掉窗口机器人就下线了。

第二步提示"当前用户没有开发者身份"？ 创建应用需要开放平台开发者权限。请企业管理员在钉钉开放平台（open-dev.dingtalk.com）的「权限管理」中把你的账号添加为开发者，然后重试第二步。

提示找不到 dws 命令？ macOS 重开一个终端窗口；Windows 重开一个 PowerShell 窗口（安装时改了 PATH，需要新窗口才生效）。

提示本地没有装 AI 工具？ 机器人背后需要一个本地 AI CLI。推荐先装 Claude Code 或 Codex，装好后重新执行第三步。

机器人回复"调用失败"？ 通常是本地 AI 工具未登录或额度用尽，单独运行一次该 AI 工具确认其本身可用。

4.2 KiB Raw Blame History Unescape Escape