# Send Kim Msg to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- 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.
## Suggested prompts
### New install

```text
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.
```
### Upgrade existing

```text
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.
```
## Machine-readable fields
```json
{
  "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": {
    "downloadUrl": "/downloads/kim-msg",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=kim-msg",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "scripts/message.js",
      "scripts/send.sh",
      "scripts/webhook.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "kim-msg",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T08:58:12.355Z",
      "expiresAt": "2026-05-07T08:58:12.355Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=kim-msg",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=kim-msg",
        "contentDisposition": "attachment; filename=\"kim-msg-1.2.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "kim-msg"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "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."
      ]
    }
  },
  "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"
  }
}
```
## Documentation

### 概述

Kim 是快手的企业即时通讯工具，支持两种发送消息的方式：

Webhook 方式 - 需要 Kim 机器人 Token，向机器人所在的群聊发送消息
消息号方式 - 需要 appKey + secretKey，可以直接发送给指定用户（快手邮箱前缀）

官方网站：https://kim.kuaishou.com/

### 首次配置

首次使用前，需要选择一种方式并配置相应的凭证：

### Webhook 方式

需要从 Kim 机器人获取 Webhook Token，告诉晴晴帮你配置。

### 消息号方式

需要提供：

appKey: Kim 应用 Key
secretKey: Kim 应用 Secret
用户名: 要发送消息的目标用户（必须是快手邮箱前缀，如 wangyang，不是完整邮箱 wangyang@kuaishou.com）

### 方式一：Webhook 发送

# 发送 Markdown 消息到群聊
kim-msg/webhook.sh "**标题**\\n\\n正文内容"

# 发送纯文本
kim-msg/webhook.sh "Hello World" --text

### 方式二：消息号发送

推荐：使用包装脚本（自动加载密钥）

# 发送消息给指定用户（用户名必须是邮箱前缀，如 wangyang）
kim-msg/send.sh -u <邮箱前缀> -m "消息内容"

# 示例
kim-msg/send.sh -u wangyang -m "**提醒**：今天有会议"

或直接调用 Node 脚本（需自行设置环境变量）

export KIM_APP_KEY=your_app_key
export KIM_SECRET_KEY=your_secret_key
kim-msg/message.js -u <邮箱前缀> -m "消息内容"

⚠️ 首次使用如果遇到权限错误，运行：chmod +x scripts/*.sh

### Webhook

URL: https://kim-robot.kwaitalk.com/api/robot/send?key=<key>
Method: POST
Body:

{
  "msgtype": "markdown",
  "markdown": {"content": "消息内容"}
}

### 消息号

获取 Token: https://is-gateway.corp.kuaishou.com/token/get?appKey=<appKey>&secretKey=<secretKey>
发送消息: 自动尝试以下两个接口：

单用户：/openapi/v2/message/send（username 单个用户）
批量：/openapi/v2/message/batch/send（usernames 数组）
自动重试： 优先尝试单用户接口，失败则尝试批量接口


Headers: Authorization: Bearer <token>
Body:

{
  "msgType": "markdown",
  "markdown": {"content": "消息内容"},
  "usernames": ["用户名"]
}

### 优先级：环境变量 > 密钥文件

脚本内置智能密钥加载机制，按以下优先级查找：

环境变量（最高优先级）

KIM_WEBHOOK_TOKEN（Webhook 方式）
KIM_APP_KEY / KIM_SECRET_KEY（消息号方式）



密钥文件（自动 fallback）
如果环境变量未设置或发送失败，脚本会自动从以下位置查找密钥（按优先级）：

~/.openclaw/.secrets（OpenClaw 统一密钥管理）
~/.kim_credentials（Kim 专用密钥文件）
./kim_credentials（项目本地密钥文件）

文件格式：
KIM_APPKEY=your_app_key
KIM_SECRET=your_secret_key

Webhook Token 格式：
KIM_WEBHOOK_TOKEN=your_webhook_token

💡 提示：

密钥文件权限建议设置为 600（仅所有者可读写）：chmod 600 ~/.openclaw/.secrets
触发 fallback 时，脚本会输出警告提示，但不会暴露密钥文件路径
推荐本地开发使用密钥文件，CI/CD 使用环境变量

### 注意事项

不硬编码任何 API Key/Token
消息内容需合规
API 异常时检查凭证和网络
用户名必须是快手邮箱前缀（如 wangyang），不是完整邮箱

### 源码

GitHub: https://github.com/LeeGoDamn/kim-msg-skill
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: LeeGoDamn
- Version: 1.2.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-30T08:58:12.355Z
- Expires at: 2026-05-07T08:58:12.355Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/kim-msg)
- [Send to Agent page](https://openagent3.xyz/skills/kim-msg/agent)
- [JSON manifest](https://openagent3.xyz/skills/kim-msg/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/kim-msg/agent.md)
- [Download page](https://openagent3.xyz/downloads/kim-msg)