{ "schemaVersion": "1.0", "item": { "slug": "kim-msg", "name": "Kim Msg", "source": "tencent", "type": "skill", "category": "通讯协作", "sourceUrl": "https://clawhub.ai/LeeGoDamn/kim-msg", "canonicalUrl": "https://clawhub.ai/LeeGoDamn/kim-msg", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/kim-msg", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=kim-msg", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "README.md", "SKILL.md", "scripts/message.js", "scripts/send.sh", "scripts/webhook.sh" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run." } ] }, "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-23T16:43:11.935Z", "expiresAt": "2026-04-30T16:43:11.935Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/kim-msg" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/kim-msg", "agentPageUrl": "https://openagent3.xyz/skills/kim-msg/agent", "manifestUrl": "https://openagent3.xyz/skills/kim-msg/agent.json", "briefUrl": "https://openagent3.xyz/skills/kim-msg/agent.md" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "概述", "body": "Kim 是快手的企业即时通讯工具，支持两种发送消息的方式：\n\nWebhook 方式 - 需要 Kim 机器人 Token，向机器人所在的群聊发送消息\n消息号方式 - 需要 appKey + secretKey，可以直接发送给指定用户（快手邮箱前缀）\n\n官方网站：https://kim.kuaishou.com/" }, { "title": "首次配置", "body": "首次使用前，需要选择一种方式并配置相应的凭证：" }, { "title": "Webhook 方式", "body": "需要从 Kim 机器人获取 Webhook Token，告诉晴晴帮你配置。" }, { "title": "消息号方式", "body": "需要提供：\n\nappKey: Kim 应用 Key\nsecretKey: Kim 应用 Secret\n用户名: 要发送消息的目标用户（必须是快手邮箱前缀，如 wangyang，不是完整邮箱 wangyang@kuaishou.com）" }, { "title": "方式一：Webhook 发送", "body": "# 发送 Markdown 消息到群聊\nkim-msg/webhook.sh \"**标题**\\n\\n正文内容\"\n\n# 发送纯文本\nkim-msg/webhook.sh \"Hello World\" --text" }, { "title": "方式二：消息号发送", "body": "推荐：使用包装脚本（自动加载密钥）\n\n# 发送消息给指定用户（用户名必须是邮箱前缀，如 wangyang）\nkim-msg/send.sh -u <邮箱前缀> -m \"消息内容\"\n\n# 示例\nkim-msg/send.sh -u wangyang -m \"**提醒**：今天有会议\"\n\n或直接调用 Node 脚本（需自行设置环境变量）\n\nexport KIM_APP_KEY=your_app_key\nexport KIM_SECRET_KEY=your_secret_key\nkim-msg/message.js -u <邮箱前缀> -m \"消息内容\"\n\n⚠️ 首次使用如果遇到权限错误，运行：chmod +x scripts/*.sh" }, { "title": "Webhook", "body": "URL: https://kim-robot.kwaitalk.com/api/robot/send?key=\nMethod: POST\nBody:\n\n{\n \"msgtype\": \"markdown\",\n \"markdown\": {\"content\": \"消息内容\"}\n}" }, { "title": "消息号", "body": "获取 Token: https://is-gateway.corp.kuaishou.com/token/get?appKey=&secretKey=\n发送消息: 自动尝试以下两个接口：\n\n单用户：/openapi/v2/message/send（username 单个用户）\n批量：/openapi/v2/message/batch/send（usernames 数组）\n自动重试： 优先尝试单用户接口，失败则尝试批量接口\n\n\nHeaders: Authorization: Bearer \nBody:\n\n{\n \"msgType\": \"markdown\",\n \"markdown\": {\"content\": \"消息内容\"},\n \"usernames\": [\"用户名\"]\n}" }, { "title": "优先级：环境变量 > 密钥文件", "body": "脚本内置智能密钥加载机制，按以下优先级查找：\n\n环境变量（最高优先级）\n\nKIM_WEBHOOK_TOKEN（Webhook 方式）\nKIM_APP_KEY / KIM_SECRET_KEY（消息号方式）\n\n\n\n密钥文件（自动 fallback）\n如果环境变量未设置或发送失败，脚本会自动从以下位置查找密钥（按优先级）：\n\n~/.openclaw/.secrets（OpenClaw 统一密钥管理）\n~/.kim_credentials（Kim 专用密钥文件）\n./kim_credentials（项目本地密钥文件）\n\n文件格式：\nKIM_APPKEY=your_app_key\nKIM_SECRET=your_secret_key\n\nWebhook Token 格式：\nKIM_WEBHOOK_TOKEN=your_webhook_token\n\n💡 提示：\n\n密钥文件权限建议设置为 600（仅所有者可读写）：chmod 600 ~/.openclaw/.secrets\n触发 fallback 时，脚本会输出警告提示，但不会暴露密钥文件路径\n推荐本地开发使用密钥文件，CI/CD 使用环境变量" }, { "title": "注意事项", "body": "不硬编码任何 API Key/Token\n消息内容需合规\nAPI 异常时检查凭证和网络\n用户名必须是快手邮箱前缀（如 wangyang），不是完整邮箱" }, { "title": "源码", "body": "GitHub: https://github.com/LeeGoDamn/kim-msg-skill" } ], "body": "Kim 消息发送（快手 IM）\n概述\n\nKim 是快手的企业即时通讯工具，支持两种发送消息的方式：\n\nWebhook 方式 - 需要 Kim 机器人 Token，向机器人所在的群聊发送消息\n消息号方式 - 需要 appKey + secretKey，可以直接发送给指定用户（快手邮箱前缀）\n\n官方网站：https://kim.kuaishou.com/\n\n首次配置\n\n首次使用前，需要选择一种方式并配置相应的凭证：\n\nWebhook 方式\n\n需要从 Kim 机器人获取 Webhook Token，告诉晴晴帮你配置。\n\n消息号方式\n\n需要提供：\n\nappKey: Kim 应用 Key\nsecretKey: Kim 应用 Secret\n用户名: 要发送消息的目标用户（必须是快手邮箱前缀，如 wangyang，不是完整邮箱 wangyang@kuaishou.com）\n使用方法\n方式一：Webhook 发送\n# 发送 Markdown 消息到群聊\nkim-msg/webhook.sh \"**标题**\\n\\n正文内容\"\n\n# 发送纯文本\nkim-msg/webhook.sh \"Hello World\" --text\n\n方式二：消息号发送\n\n推荐：使用包装脚本（自动加载密钥）\n\n# 发送消息给指定用户（用户名必须是邮箱前缀，如 wangyang）\nkim-msg/send.sh -u <邮箱前缀> -m \"消息内容\"\n\n# 示例\nkim-msg/send.sh -u wangyang -m \"**提醒**：今天有会议\"\n\n\n或直接调用 Node 脚本（需自行设置环境变量）\n\nexport KIM_APP_KEY=your_app_key\nexport KIM_SECRET_KEY=your_secret_key\nkim-msg/message.js -u <邮箱前缀> -m \"消息内容\"\n\n\n⚠️ 首次使用如果遇到权限错误，运行：chmod +x scripts/*.sh\n\nAPI 详情\nWebhook\nURL: https://kim-robot.kwaitalk.com/api/robot/send?key=\nMethod: POST\nBody:\n{\n \"msgtype\": \"markdown\",\n \"markdown\": {\"content\": \"消息内容\"}\n}\n\n消息号\n获取 Token: https://is-gateway.corp.kuaishou.com/token/get?appKey=&secretKey=\n发送消息: 自动尝试以下两个接口：\n单用户：/openapi/v2/message/send（username 单个用户）\n批量：/openapi/v2/message/batch/send（usernames 数组）\n自动重试： 优先尝试单用户接口，失败则尝试批量接口\nHeaders: Authorization: Bearer \nBody:\n{\n \"msgType\": \"markdown\",\n \"markdown\": {\"content\": \"消息内容\"},\n \"usernames\": [\"用户名\"]\n}\n\n密钥配置方式\n优先级：环境变量 > 密钥文件\n\n脚本内置智能密钥加载机制，按以下优先级查找：\n\n环境变量（最高优先级）\n\nKIM_WEBHOOK_TOKEN（Webhook 方式）\nKIM_APP_KEY / KIM_SECRET_KEY（消息号方式）\n\n密钥文件（自动 fallback）\n\n如果环境变量未设置或发送失败，脚本会自动从以下位置查找密钥（按优先级）：\n\n~/.openclaw/.secrets（OpenClaw 统一密钥管理）\n~/.kim_credentials（Kim 专用密钥文件）\n./kim_credentials（项目本地密钥文件）\n\n文件格式：\n\nKIM_APPKEY=your_app_key\nKIM_SECRET=your_secret_key\n\n\nWebhook Token 格式：\n\nKIM_WEBHOOK_TOKEN=your_webhook_token\n\n\n💡 提示：\n\n密钥文件权限建议设置为 600（仅所有者可读写）：chmod 600 ~/.openclaw/.secrets\n触发 fallback 时，脚本会输出警告提示，但不会暴露密钥文件路径\n推荐本地开发使用密钥文件，CI/CD 使用环境变量\n注意事项\n不硬编码任何 API Key/Token\n消息内容需合规\nAPI 异常时检查凭证和网络\n用户名必须是快手邮箱前缀（如 wangyang），不是完整邮箱\n源码\n\nGitHub: https://github.com/LeeGoDamn/kim-msg-skill" }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/LeeGoDamn/kim-msg", "publisherUrl": "https://clawhub.ai/LeeGoDamn/kim-msg", "owner": "LeeGoDamn", "version": "1.2.0", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/kim-msg", "downloadUrl": "https://openagent3.xyz/downloads/kim-msg", "agentUrl": "https://openagent3.xyz/skills/kim-msg/agent", "manifestUrl": "https://openagent3.xyz/skills/kim-msg/agent.json", "briefUrl": "https://openagent3.xyz/skills/kim-msg/agent.md" } }