微盛企微管家SCRM
当用户需要查询或管理微盛企微管家(企业微信) SCRM 中的客户信息、客户标签、客户群、营销素材、活码、群发、跟进记录、聊天记录、联系人、商机、汇报、抽奖、客户日程等相关业务能力时触发。即使用户未明确提到 SCRM、企微管家、开放接口或 API,也应在这些企业微信客户运营与管理场景下触发。 Skill: 微盛企微管家SCRM Owner: fangfang19 Summary: 当用户需要查询或管理微盛企微管家(企业微信) SCRM 中的客户信息、客户标签、客户群、营销素材、活码、群发、跟进记录、聊天记录、联系人、商机、汇报、抽奖、客户日程等相关业务能力时触发。即使用户未明确提到 SCRM、企微管家、开放接口或 API,也应在这些企业微信客户运营与管理场景下触发。 Tags: latest:1.0.4 Version history: v1.0.4 | 2026-05-06T08:15:13.771Z | user Version 1.0.4 - 移除了“联系支持”部分,将相关说明合并进“使用说明”。 - 更新了“处理原则”中关于不可执行操作模式的描述(去除了对 Craft 模式的限定)。 - 新增“安全与隐私”章节,明确 APP KEY 获取、保存及撤销方法,并声明本地安全策略。 - 其他文档结构优化,无功能变动
Rank
62
Safety
84
Downloads
1.1k
Updated
Oct 11, 2026
Version
1.0.4
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 11, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 11, 2026
- Adoption signal
- 1.1K downloadsadoption · observed Oct 11, 2026
- Latest release
- 1.0.4release · observed May 6, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s1762jhymf8fapq8waemz2aky585dths:wecom-weisheng-scrm- Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-fangfang19-wecom-weisheng-scrm/snapshot"
Documentation
CLAWHUB
43,502 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
--- name: wecom-weisheng-scrm description: "当用户需要查询或管理微盛企微管家(企业微信) SCRM 中的客户信息、客户标签、客户群、营销素材、活码、群发、跟进记录、聊天记录、联系人、商机、汇报、抽奖、客户日程等相关业务能力时触发。即使用户未明确提到 SCRM、企微管家、开放接口或 API,也应在这些企业微信客户运营与管理场景下触发。" description_zh: "微盛AI·企微管家提供的技能,帮助用户查询和管理企业微信 SCRM 中的客户、客户群、标签、活码、群发、跟进、聊天记录内容等业务数据,可询问AI当前支持的能力清单。" description_en: "Built for WeCom customer operations, helping teams review customer and group activity, prepare campaign assets, and move follow-up, messaging, and opportunity workflows forward." version: 1.0.3 --- # 微盛企微管家SCRM 微盛企微管家 SCRM 面向企业微信客户运营场景,帮助团队围绕客户、社群、素材、活码、群发、会话与商机等业务,更高效地完成查询、协同与执行。 本 Skill 适用于客户信息、客户标签、客户群、素材、活码、群发、跟进记录、会话存档、联系人、商机、产品库、汇报、抽奖、日程等场景。你可以直接用业务语言提出问题,例如“帮我查最近7天新添加的客户”“看看某个客户的标签和跟进情况”“帮我查客户群或群发情况”。 ## 使用说明 触发 Skill 后,应先用简短话术向用户说明:微盛AI·企微管家 SCRM 是基于企业微信的 AI 聊天、营销和服务平台,可协助客户运营、社群营销、SCRM 与会话管理,本技能支持查询或管理客户信息、客户标签、客户群、素材、活码、群发、跟进记录、会话存档、联系人、商机、汇报、抽奖、客户日程等相关能力;如需进一步支持,可联系专属客服。 **触发 Skill 后,必须先阅读 [references/agent-runbook.md](references/agent-runbook.md) 并严格按其中的调用流程执行(包括 `check-env` → `check-identity` 的顺序),不得跳过或自行编排步骤。** ### 推荐提问方式 - 帮我查一下最近新增客户和重点跟进客户的情况。 - 帮我看看这个客户的标签、跟进记录和聊天情况。 - 帮我整理一下当前客户群和群发相关情况。 - 帮我看一下最近活码和素材相关情况。 ### 处理原则 - 默认使用业务语言回复用户,先说结论,再说明还缺什么信息或下一步怎么处理。 - 如需补充条件,优先向用户追问时间范围、客户名称、标签、员工、群发范围等业务信息。 - 查询类需求可直接处理;创建、编辑、删除、发送等写操作应在用户确认后再执行。 - 若用户当前所在模式无法执行命令或脚本,应先提示切换到具备执行能力的模式。 对普通用户回复时,不要主动暴露 `service_name`、`api_path`、`doc_url`、`biz_params`、JSON、代理调用等内部术语,除非用户明确要求查看。 ## 安全与隐私 本 Skill 需要你的企微管家 APP KEY 授权。KEY 仅保存在本地设备(Shell 配置 / Windows 注册表),不会上传到 QClaw 服务器或任何第三方。 - 获取:企业微信 → 工作台 → 企微管家 → 我的 → 我的 APP KEY - 撤销:在企微管家后台重置 APP KEY,或执行 `python3 scripts/scrm.py set-app-key ""` ## 文档索引 | 文档 | 说明 | |------|------| | [references/guide.md](references/guide.md) | 使用参考与常见业务场景 | | [references/examples.md](references/examples.md) | 示例问题与使用示例 | | [references/agent-runbook.md](references/agent-runbook.md) | AI 执行手册(流程、命令参考、权限、错误处理、数据依赖) | | [references/file-utils.md](references/file-utils.md) | 文件上传与下载(本地图片转公网 URL) |
README.md
# wecom-weisheng-scrm 面向 AI 代理的微盛企微管家 SCRM Skill 插件,提供与微盛企微管家开放平台(`https://open.wshoto.com`)的集成能力。本仓库不包含业务逻辑实现,而是通过动态接口发现和通用代理调用机制,将 AI 代理与企微管家 SCRM 系统打通,覆盖客户管理、标签、群聊、素材、活码、群发、跟进记录、会话存档、商机、产品库、汇报、抽奖、日程等业务场景。 ## 特性 - **零外部依赖** — 仅使用 Python 标准库,无需 `pip install` - **动态接口发现** — 通过 Claw 模块实时拉取开放平台 API 目录,支持关键词模糊搜索 - **通用代理转发** — 统一通过 `/openapi/claw/proxy/forward` 代理调用所有业务接口 - **角色权限感知** — 自动识别当前用户身份(超管/分管/普通员工),约束数据访问范围 - **写操作保护** — 自动识别写操作(新增、创建、删除、发送等),禁止失败自动重试 - **结构化 JSON 输出** — 所有命令输出标准化 JSON,适合 AI 代理解析 ## 仓库结构 ```text wecom-weisheng-scrm/ ├── SKILL.md # Skill 描述文件,供 openclaw 平台识别 ├── install.sh # 安装/卸载脚本(symlink 到 ~/.openclaw/skills/) ├── references/ # AI 代理执行参考文档 │ ├── agent-runbook.md # 代理执行手册(流程、权限、错误处理) │ ├── examples.md # 用户查询示例与预期输出 │ ├── file-utils.md # 文件上传/下载说明 │ └── guide.md # 用户使用指南 ├── scripts/ # Python CLI 实现 │ ├── scrm.py # 主入口,命令分发 │ ├── api_client.py # HTTP 客户端(GET/POST/multipart) │ ├── claw_client.py # Claw 模块客户端(API 目录 + 代理转发) │ ├── environment.py # 环境检查(Python >= 3.9、APP_KEY) │ ├── file_utils.py # 图片上传/下载工具 │ ├── get_access_token.py # Token 管理(获取 + 缓存 + 刷新) │ ├── identity_manager.py # 用户身份管理(角色检测 + 缓存) │ ├── raw_fetcher.py # 受控远程文档读取(域名白名单) │ ├── chat_mode.py # 会话存档模式管理(key/zone) │ └── utils.py # 公共工具(异常、日志、JSON 输出、时间处理) ├── .cache/ # 运行时缓存(Token、API 目录、身份信息) ├── logs/ # 运行日志 └── README.md ``` ## 快速开始 ### 1. 安装 ```bash ./install.sh install # 创建 symlink 到 ~/.openclaw/skills/wecom-weisheng-scrm ./install.sh uninstall # 移除 symlink ``` ### 2. 配置环境变量 | 变量 | 必填 | 说明 | |------|------|------| | `SCRM_APP_KEY` | 是 | 企微管家个人访问令牌。获取路径:企业微信 → 工作台 → 企微管家 → 我的 → 我的 APP KEY | | `SCRM_BASE_URL` | 否 | 覆盖默认地址(默认 `https://open.wshoto.com`) | | `SCRM_SKIP_SSL_VERIFY` | 否 | 设为 `1` 跳过 SSL 验证(内网环境使用) | | `SCRM_MEDIA_CATEGORY_ID` | 否 | 素材上传分类 ID | ### 3. 检查运行环境 ```bash python3 scripts/scrm.py check-env ``` ### 4. 设置凭证 ```bash python3 scripts/scrm.py set-app-key "your_personal_access_token" ``` ### 5. 获取当前身份 ```bash python3 scripts/scrm.py check-identity ``` 返回用户角色:超管(`super_user=1`)、分管(`super_user=2`)、普通员工(`super_user=0 或 3`)。 ## 命令说明 | 命令 | 说明 | |------|------| | `check-env` | 检查运行环境(Python 版本、APP_KEY 配置) | | `set-app-key <key>` | 持久化写入 APP KEY 到 Shell 配置文件 | | `check-identity` | 获取当前用户身份与角色 | | `list-apis --keyword <关键词>` | 按关键词搜索 API 目录(逗号分隔多关键词) | | `call-api --service-name <服务名> --uri <路径> --biz-params <JSON>` | 通过通用代理调用业务接口 | | `fetch-raw-doc --url <文档URL>` | 获取远程接口文档原始内容(仅限 `open.wshoto.com` 域名) | | `upload-image --path <本地路径>` | 上传本地图片,返回公开 URL 和 file_id | | `set-chat-mode --mode <key\|zone>` | 设置会话存档模式 | ### 使用示例 **搜索接口:** ```bash python3 scripts/scrm.py list-apis --keyword "客户,标签,群发" ``` **调用接口:** ```bash python3 scripts/scrm.py call-api \ --service-name "wshoto-basebiz-s
_meta.json
{
"ownerId": "kn76jhdedxj61v2z5cpzgjt8r985c44f",
"slug": "wecom-weisheng-scrm",
"version": "1.0.4",
"publishedAt": 1778055313771
}references/agent-runbook.md
# AI 执行手册 本文件供 AI 在执行本 Skill 时使用,不面向普通用户解释内部接口细节。 ## 用户沟通口径 对普通用户回复时,默认使用业务语言和结果导向表达,不要主动使用过多技术术语。 1. **默认不用技术词堆砌**:除非用户主动追问,否则不要直接说 `service_name`、`api_path`、`doc_url`、`biz_params`、JSON、接口编排、代理调用等术语。 2. **先说能帮用户做什么**:优先说"我先帮你看看""我先帮你查一下""我来帮你整理"这类表达,再说明还需要用户补充什么。 3. **权限提示说人话**:不要直接对用户说 TEAM、MINE、super_user;改为"你当前可以看团队数据"或"你当前只能看自己的数据"。 4. **配置提示说人话**:不要只说"未配置 SCRM_APP_KEY";改为"你这边还没有完成企微管家授权,需要先获取 APP KEY 后我才能继续帮你查"。 5. **参数收集说业务信息**:不要说"请提供 biz_params";改为"还需要补充时间范围、客户名称、标签、员工等信息"。 6. **反馈结果先讲结论**:查询成功时先总结查到了什么;失败时先说发生了什么和下一步怎么办,不先抛错误码。 7. **用户看不懂的内部信息不主动暴露**:接口路径、服务名、文档地址、原始返回结构,仅在用户明确要求查看时再展示。 8. **读取接口目录时统一使用仓库内的受控原文读取命令**:应直接获取目标地址的原始内容,统一执行 `python3 scripts/scrm.py fetch-raw-doc --url <目标地址>`;不要先做网页搜索,不要先打开站点首页,也不要仅基于摘要页或搜索结果推断接口。 9. **不要回退到 `web_fetch` 或其他网页抓取方式**:open.wshoto.com 文档读取统一走仓库内脚本命令,不使用网页正文抽取,不依赖首页跳转或搜索结果。 ### 推荐话术示例 - 查询前:我先帮你看一下。 - 继续追问信息时:还需要你补充一下时间范围 / 客户名称 / 标签信息,我再继续帮你查。 - APP KEY 未配置时:你这边还没有完成企微管家授权,先去企业微信-工作台-企微管家-我的-我的 APP KEY 获取后发给我,我再继续帮你处理。 - 普通员工查团队数据时:你当前只能查看自己的数据,团队数据这边暂时查不了。 - 查询失败时:这次没有查成功,我把原因和下一步怎么处理跟你说一下。 ## 脚本位置 脚本位于 SKILL.md 所在目录下的 `scripts/scrm.py`。AI 读取本文件时已知其路径,因此直接基于 SKILL.md 的目录拼接即可。 ## 环境检测 触发 Skill 后,AI 应先检查当前是否具备脚本执行能力,以便运行仓库内命令读取原始文档并完成后续流程。 若用户当前所在模式不具备脚本执行能力,应直接提示用户切换到具备命令执行能力的模式后再继续;不要在明知当前模式无法执行命令时继续后续接口流程。 - **如果具备** → 正常继续后续调用流程。 - **如果不具备** → 引导用户切换到可执行脚本的模式或补齐命令执行能力,完成前不要继续后续流程。 处理原则: - 缺少脚本执行能力时,先解决环境问题,再继续接口目录读取和后续 API 流程。 - 若已确认问题来自当前模式的执行能力限制,优先明确提示用户切换到具备所需能力的模式,不要只笼统提示"稍后再试"。 - 不要在缺少原文读取能力的情况下,直接把接口目录读取降级成普通网页搜索或首页浏览。 - 如果用户尚未完成重启,不要假装后续命令已经执行成功。 ## 调用流程 AI 按以下编排流程执行: 1. **执行环境检测** → 先确认当前是否具备脚本执行能力;若不具备,则按"环境检测"章节优先引导用户切换到可用模式或补齐必要能力,完成前不要继续后续流程 - 若已知用户当前模式无法执行命令,先明确提示其切换到具备所需能力的模式 2. **执行 check-env** → 检查运行环境(Python ≥3.9、SCRM_APP_KEY);`check-env` 内部会自动尝试从 shell profile 或 Windows 注册表中恢复已持久化的 APP_KEY - 成功且返回中包含 `export_hint` → 说明 APP_KEY 是从持久化配置中恢复的,**立即执行返回的 `export_hint` 命令**(如 `export SCRM_APP_KEY='xxx'`)使当前 shell 会话生效,然后继续 - 成功且无 `export_hint` → APP_KEY 已在环境变量中,直接继续 - 失败(`config_error`)→ 引导用户获取 APP KEY 并执行 `set-app-key`,成功后执行 `export SCRM_APP_KEY='<值>'`,然后继续 - 若用户主动要求更换或更新 APP KEY(即使当前已配置),同样执行 `set-app-key` 用新值覆盖、export 后再继续 3. **执行 check-identity** → 获取用户身份(超管/分管/员工) 4. **阅读远程接口目录(强制步骤,不得跳过)** → 必须先读取 [CLAW_SUMMARY.md](https://open.wshoto.com/doc/pages/claw/CLAW_SUMMARY.md) 的原始内容,再根据用户意图匹配目标接口;每次会话首次触发 Skill 时必须执行此步骤,不得凭已有认知直接跳到 list-apis。执行时统一使用仓库内命令 `python3 scripts/scrm.py fetch-raw-doc --url <url>` 5. **执行 list-apis** → 用接口名称关键词匹配调用规则(service_name、api_path、doc_url) 6. **阅读接口文档(doc_url)** → 阅读该文档获取完整参数定义,强制步骤,不得跳过 7. **通过对话收集 biz_params** → 基于 doc_url 文档中的参数说明收集必要参数,不得仅凭 description 推断 8. **执行 call-api** → 将 list-apis 返回的 service_name、api_path 及收集到的 biz_params 组装后通过通用代理调用 ### 接口目录与文档读取要求 - 读取接口目录时,目标是拿到原始响应内容,而不是做网页正文抽取。 - 统一执行仓库内命令 `python3 scripts/scrm.py fetch-raw-doc --url https://open.wshoto.com/doc/pages/claw/CLAW_SUMMARY.md`。 - 该命令内置超时、域名白名单和响应大小限制,比 `web_fetch` 更稳定,也更容易通过安全审查。 - 读取 doc_url 对应在线文档时,也统一执行 `python3 scripts/scrm.py fetch
references/examples.md
# 示例 ## 示例 1 输入:帮我查一下最近新增客户和重点跟进客户的情况。 输出:返回客户增长情况、重点客户和待跟进事项的汇总信息。 ## 示例 2 输入:帮我看看这个客户的标签、跟进记录。 输出:返回客户相关信息,并提示当前还需要补充的业务条件。 ## 示例 3 输入:帮我创建我的员工活码。 输出:创建员工活码,返回员工活码创建信息。 ## 示例 4 输入:帮我看一下最近活码和素材相关情况。 输出:返回活码和素材相关信息,并说明后续可继续处理的方向。
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/fangfang19/skills/wecom-weisheng-scrm",
"sourceUrl": "https://clawhub.ai/fangfang19/skills/wecom-weisheng-scrm",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T13:54:21.192Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-fangfang19-wecom-weisheng-scrm/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-fangfang19-wecom-weisheng-scrm/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-11T13:54:21.192Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.1K downloads",
"href": "https://clawhub.ai/fangfang19/wecom-weisheng-scrm",
"sourceUrl": "https://clawhub.ai/fangfang19/wecom-weisheng-scrm",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T13:54:21.192Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.0.4",
"href": "https://clawhub.ai/fangfang19/wecom-weisheng-scrm",
"sourceUrl": "https://clawhub.ai/fangfang19/wecom-weisheng-scrm",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-05-06T08:15:13.771Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-fangfang19-wecom-weisheng-scrm/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-fangfang19-wecom-weisheng-scrm/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.4",
"description": "Version 1.0.4 - 移除了“联系支持”部分,将相关说明合并进“使用说明”。 - 更新了“处理原则”中关于不可执行操作模式的描述(去除了对 Craft 模式的限定)。 - 新增“安全与隐私”章节,明确 APP KEY 获取、保存及撤销方法,并声明本地安全策略。 - 其他文档结构优化,无功能变动。",
"href": "https://clawhub.ai/fangfang19/wecom-weisheng-scrm",
"sourceUrl": "https://clawhub.ai/fangfang19/wecom-weisheng-scrm",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-05-06T08:15:13.771Z",
"isPublic": true
}
]
}Record generated Oct 11, 2026.
