连接飞书 步骤 1:创建一个飞书账户 前往飞书,并使用你的账号登录。 飞书:https://open.feishu.cn/app 登录后,点击 创建自建应用。填写应用名称,例如“我的 SkyClaw”,再填写应用描述,选择一个应用图标,然后点击 创建。 步骤 2:启用机器人能力 进入 添加功能 → 按功能添加 → 机器人,点击 + 添加,启用机器人功能。 步骤 3:授权 进入 权限与授权范围,然后点击 批量导入 / 导出权限范围。 将 JSON 内容粘贴进去,然后点击确认。 需要添加的JSON内容如下 { "scopes": { "tenant": [ "im:chat.access_event.bot_p2p_chat:read", "im:chat.members:bot_access", "im:message", "im:message.group_at_msg:readonly", "im:message.p2p_msg:readonly", "im:message:readonly", "im:message:send_as_bot", "contact:contact.base:readonly", "im:resource" ], "user": [ "im:chat.access_event.bot_p2p_chat:read" ] } } 点击 添加 步骤 4:复制 App ID 和 App Secret 选择 凭证与基础信息 页面,复制以下信息: App ID:格式通常为 cli_xxx App Secret 安全提醒: 任何拿到你 App Secret 的人,都可以控制你的机器人。所以请妥善保管,不要公开分享。若 App Secret 不慎泄露,请立即前往开放平台重新生成。 步骤 5:将凭证填写到 Skywork 回到 天工 → 连接飞书机器人 页面。 将刚才复制的 App ID 和 App Secret 分别粘贴到对应的输入框中,然后点击 确认 步骤 6:配置事件订阅 注意: 请先完成步骤 5,也就是先在天工中保存你的 App ID 和 App Secret,再来配置事件订阅。否则,长连接配置可能无法成功保存。 在飞书平台中,进入 事件与回调 页面: 点击 事件配置 标签页。 在 订阅方式 下,点击 ✏️ 编辑 图标,选择 “使用长连接接收事件”(推荐),然后点击 保存。 向下滚动到 已添加事件,点击 添加事件。 搜索并添加以下事件: im.message.receive_v1 添加完成后,就可以准备发布应用了。 步骤 7:发布应用 进入 版本管理与发布,点击 创建版本。 填写 应用版本号 和 更新说明,然后点击 保存。 在确认弹窗中,选择 提交发布。 在确认弹窗中,选择 提交发布。 步骤 8:获取配对码并完成设置 打开飞书,进入 开放平台助手 机器人的聊天窗口,点击 打开应用,启动你的机器人。 完成后,你就可以在飞书中和你的 SkyClaw 聊天了。 连接钉钉 步骤 1:进入钉钉开发者平台 打开 钉钉开发者平台,使用具有管理员权限的钉钉账号登录。 步骤 2:创建钉钉应用 进入「应用开发」模块 → 进入「钉钉应用」管理页面。 点击右上角「创建应用」按钮,在弹出的侧边栏里面填写好「应用名称」和「应用描述」,点击保存就成功创建了应用。 步骤 3:添加机器人能力 进入刚创建的应用,在「添加能力」中选择「机器人」,点击「添加」。 步骤 4:配置并发布机器人 进入「机器人」页面进行配置。 开启机器人配置开关,然后填写好所有必填项(其他可选项保留默认值即可),点击「发布」。 点击上方「查看版本详情」进入「版本管理与发布」页面,点击「创建新版本」按钮,填写版本说明 填写好所有必填项后,点击「保存」,在弹窗中点击「确认发布」。发布后,版本详情会显示「已上线」。 PS:如需限制可添加机器人的员工范围,在「应用可见范围(可选项)」中配置。 步骤 5:复制创建好的 Client ID 和 Client Secret 进入「凭证与基础信息」页面。 找到「Client ID」和「Client Secret」,复制后分别粘贴到天工的钉钉配置面板 安全提示:Client Secret 属于敏感凭证,请勿公开截图、转发或发到群聊。如果泄露,请立即在钉钉开发者平台重新生成。 步骤 6:私聊机器人 按照上述过程发布应用并将 Client ID 和 Client Secret 配置到天工,在钉钉中直接搜索机器人名称就可以找到创建的机器人。 点击机器人进入会话后,发送任意消息,天工就可以直接回复你了。之后你就可以随时在钉钉里面和天工对话了。 PS:如果还没有回复,需要返回天工检查是否正确配置 步骤 7:添加机器人到群里 打开钉钉应用。 选择你想添加的群聊,点击右上角「设置」 ,选择「机器人」 ,点击「添加机器人」。 搜索你创建的机器人并添加。添加完成后,即可在群聊中与天工对话。 FAQ 问题 1:没有企业管理员权限怎么办? 答案 1:先在钉钉应用中加入或创建团队;如使用公司组织,请联系管理员授权。 问题 2:哪里查看 Client ID 和 Client Secret? 答案 2:进入应用详情页 → 「凭证与基础信息」,复制对应字段。 问题 3:机器人添加不到群聊怎么办? 答案 3:检查应用是否已发布、版本详情是否显示「已上线」、应用可见范围是否包含当前员工。 问题 4:机器人没有回复怎么办? 答案 4:确认机器人已添加到群聊或已进入私聊会话,再重新发送消息。 问题 5:Client Secret 泄露怎么办? 答案 5:立即进入钉钉开发者平台重新生成,并同步更新到 Skywork。