前言¶

告警、審批結果、定時任務狀態，很多團隊最終都要落到企業微信裏。常見做法是單獨寫腳本或接一層內部服務，自己維護 access_token、查 UserID、再調發送接口。每次改文案或換接收人，都要碰代碼或改配置。

下面介紹 SkillHub 上的社區 Skill wecome-send-message（安裝座標爲 @user_6976792a/wecom-send-message）。它把企微自建應用的憑證配置、通訊錄查詢和多種消息類型封裝成 SKILL.md 工作流，由 Agent 按文檔調用 tools/wecom_client.py 完成操作。

這是什麼¶

wecome-send-message 面向 企業微信消息推送與通訊錄查詢：通過企微自建應用向指定用戶發送消息，並按姓名、手機、郵箱等方式檢索通訊錄。

• 維護方：SkillHub 社區發佈者 user_6976792a，來源爲 community，分類 business-ops
• 當前版本：1.0.0
• SkillHub 頁面數據（以頁面展示爲準）：評分 100000，下載 2293，安裝 269；標籤含 requires_api_key=true（實際需配置企微 CorpID、AgentID、Secret 等憑證）
• 官方入口：SkillHub 技能頁、api.skillhub.cn 座標頁

包內 SKILL.md 的 name 字段爲 wecom-api，與商店展示名 wecome-send-message 不一致；安裝與引用時以座標 @user_6976792a/wecom-send-message 爲準。

核心功能¶

以下能力均來自已發佈的 SKILL.md 與 tools/wecom_client.py 子命令，Agent 通過 Bash 調用 Python 腳本執行。

1. 憑證與連接：check 檢查是否就緒；setup 寫入 Skill 目錄下私有 .env；verify 驗證 API 連接。
2. 通訊錄：按姓名模糊搜索、按手機號或郵箱精確查找、獲取用戶詳情、列出部門及部門成員（含遞歸）。
3. 消息推送：向單個或多個 UserID（| 分隔）發送文本、Markdown、文本卡片；支持 @all 與多人場景的 --preview / --yes 確認流程。
4. 運維輔助：history 查看最近發送審計；常見企微錯誤碼在 Skill 文檔中有對應處理說明；token 默認緩存在 Skill 私有 .cache/，審計寫入 .state/message_audit.json。

前置依賴：Python 3，以及 pip install requests。

安裝與啓用¶

1、安裝 SkillHub CLI（若尚未安裝）¶

command -v skillhub && skillhub --version

未安裝時可按 SkillHub 安裝文檔執行（完整安裝示例）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

2、安裝本 Skill 到當前 Agent 的 skills 目錄¶

安裝時必須使用 --dir 指向 Agent 識別的 skills 目錄，否則默認落在 ./skills/ 可能無法被加載。

skillhub install @user_6976792a/wecom-send-message --dir <skills 目錄>

常用路徑（來自 SkillHub 安裝文檔）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或項目下的 .agents/skills/

也可將下面提示詞交給 AI，讓其按 skillhub 安裝說明 完成安裝：

請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_6976792a/wecom-send-message`。

3、配置企業微信憑證¶

首次使用前在 Skill 目錄執行檢查（將 ${CLAUDE_SKILL_DIR} 換爲實際安裝路徑，例如 ~/.cursor/skills/@user_6976792a/wecom-send-message）：

python3 ${CLAUDE_SKILL_DIR}/tools/wecom_client.py check

若未就緒，推薦用 setup 寫入 Skill 私有 .env：

python3 ${CLAUDE_SKILL_DIR}/tools/wecom_client.py setup \
  --corp-id "你的企業ID" \
  --agent-id "你的AgentID" \
  --secret "你的應用Secret" \
  --contact-secret "你的通訊錄Secret"

其中 CorpID、AgentID、Secret 來自企微管理後臺自建應用；contact-secret 可選，用於通訊錄能力，未配置時文檔說明會用應用 Secret 兜底。也可通過環境變量 WECOM_CORP_ID、WECOM_AGENT_ID、WECOM_SECRET、WECOM_CONTACT_SECRET 或 OpenClaw 的 openclaw secrets set 注入（見 Skill 文檔）。

配置後驗證：

python3 ${CLAUDE_SKILL_DIR}/tools/wecom_client.py verify

典型用法¶

Skill 聲明在用戶說出「發企微消息給 XX」「企微推送」「wecom send」等意圖時觸發；也可使用文檔中的 /wecom-api 類入口（以 Agent 對 Skill 的掛載方式爲準）。

按姓名查人再發文本¶

python3 ${CLAUDE_SKILL_DIR}/tools/wecom_client.py search-name --name "張三"

python3 ${CLAUDE_SKILL_DIR}/tools/wecom_client.py send-text \
  --to "zhangsan" \
  --content "明天上午10點開會，請準時參加。"

多人發送（先預覽再確認）¶

python3 ${CLAUDE_SKILL_DIR}/tools/wecom_client.py send-text \
  --to "zhangsan|lisi|wangwu" \
  --content "提醒：今天下班前提交週報" \
  --preview

python3 ${CLAUDE_SKILL_DIR}/tools/wecom_client.py send-text \
  --to "zhangsan|lisi|wangwu" \
  --content "提醒：今天下班前提交週報" \
  --yes

部門成員與 Markdown 通知¶

python3 ${CLAUDE_SKILL_DIR}/tools/wecom_client.py dept-list

python3 ${CLAUDE_SKILL_DIR}/tools/wecom_client.py dept-users --dept-id 1 --recursive

python3 ${CLAUDE_SKILL_DIR}/tools/wecom_client.py send-markdown \
  --to "zhangsan" \
  --content "## 會議通知\n> 時間：明天 10:00\n\n請準時參加。"

在 Cursor 等環境中，通常用自然語言描述意圖，由 Agent 讀取 SKILL.md 並執行上述命令；SKILL.md 寫明允許的工具爲 Read、Write、Edit、Bash。

適用場景與注意¶

適合誰：已在企業微信開通自建應用、需要把「查人 + 發消息」交給 coding Agent 的團隊；分類爲 business-ops，適合運維通知、協作提醒、輕量辦公自動化。

限制與注意：

1. 接收者須在應用可見範圍內，否則可能出現 60020 等錯誤；通訊錄查詢依賴相應 Secret 與權限。
2. 羣發、@all 默認要求先 --preview，確認後再加 --yes，避免誤發。
3. Secret 不應寫入代碼或日誌；Skill 默認只讀取其目錄下的 .env，可通過 WECOM_ENV_FILE 指定其他 env 文件。
4. 商店名 wecome-send-message 與包內 Skill 名 wecom-api、slug wecom-send-message 並存，排查問題時以安裝目錄與座標爲準。

結尾¶

wecome-send-message 把企業微信自建應用的消息與通訊錄能力收斂成可安裝的 Agent Skill：憑證本地化、命令行可復現、文檔裏帶錯誤碼與安全約定。若你已在用 SkillHub 管理 Skills，可按座標安裝並在配置 verify 通過後，用對話驅動企微通知。

官方地址：https://www.skillhub.cn/skills/user_6976792a/wecom-send-message