连接IM
连接飞书
步骤 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。