搜索

PythonReactSEOPDF
OpenClaw

wecom-channel-fix

企业微信通道配置诊断与修复。当用户遇到企微通道无法连接、配置错误、插件 ID 不匹配、多账号模式不支持等问题时激活。支持配置检测、自动修复、单账号/多账号模式切换。

fclwtt0 来源安装数☆ 0 仓库 Starsv1.0.0

安装与使用

请根据来源仓库和你的 AI 工具说明安装此技能。先阅读技能文件和依赖要求,再添加到工作流。

SkillHub CLI

skillhub install fclwtt/skills-5

打开来源仓库,查看说明和兼容环境后,按来源提供的命令或步骤安装。

将来源链接提供给你的 Agent,让它先读取说明、核对依赖,并向你说明将执行的安装步骤。

查看来源 ↗使用指南

技能说明

企业微信通道配置诊断与修复技能

当用户遇到企业微信通道无法连接、消息无回复、配置错误等问题时,使用此技能进行诊断和修复。

触发场景

  • "企微没反应"
  • "企业微信通道配置错误"
  • "wecom 连不上"
  • "插件 ID 不匹配"
  • "多账号模式不支持"
  • "企微消息无回复"

诊断流程

步骤 1:检查通道状态
openclaw channels status 2>&1

判断标准:

  • enabled, configured, running ✅ 正常
  • enabled, not configured, stopped ❌ 配置缺失
  • error:* ❌ 错误状态
步骤 2:检查配置文件
openclaw config get channels.wecom 2>&1

检查项:

  1. botId 是否存在
  2. secret 是否存在
  3. 是否使用了不支持的 accounts.* 多账号结构
步骤 3:检查插件配置
grep -A 10 '"plugins"' ~/.openclaw/openclaw.json

常见问题:

  • 插件 ID 不匹配(配置用 wecom-openclaw-plugin,实际导出 wecom)
  • 插件未启用
步骤 4:查看日志
cat /tmp/openclaw/openclaw-$(date +%Y-%m-%d).log | grep -i wecom | tail -20

关键错误:

  • plugin id mismatch
  • Invalid WebSocket frame
  • Authentication failed
  • not configured

修复方案

问题 A:插件 ID 不匹配

症状:

[plugins] plugin id mismatch (config uses "wecom-openclaw-plugin", export uses "wecom")
plugins.entries.wecom: plugin not found: wecom

修复:

将 openclaw.json 中的插件配置从:

{
  "plugins": {
    "allow": ["wecom-openclaw-plugin"],
    "entries": {
      "wecom-openclaw-plugin": {"enabled": true}
    }
  }
}

改为:

{
  "plugins": {
    "allow": ["wecom"],
    "entries": {
      "wecom": {"enabled": true}
    }
  }
}

原因: 企微插件的 openclaw.plugin.json 中定义 id: "wecom",但安装包名为 @wecom/wecom-openclaw-plugin,配置时应使用导出 ID 而非包名。


问题 B:多账号模式不支持

症状:

wecom default: 企业微信机器人 ID 或 Secret 未配置
config reload skipped (invalid config)

当前配置(错误):

{
  "channels": {
    "wecom": {
      "enabled": true,
      "defaultAccount": "main",
      "accounts":...

来源信息

Source
github
Repository
openclaw/skills
Path
skills/fclwtt/skills-5
Version
1.0.0
Commit
226b3937f4dfb5c113b56d9cc393e1189ef3a91f
分类来源
rules
状态
active
可见性
public

这些信息来自收录时的来源分析,可能滞后;使用前请核对最新来源文件。

来源内容

SKILL.md
# 企业微信通道配置诊断与修复技能

当用户遇到企业微信通道无法连接、消息无回复、配置错误等问题时,使用此技能进行诊断和修复。

## 触发场景

- "企微没反应"
- "企业微信通道配置错误"
- "wecom 连不上"
- "插件 ID 不匹配"
- "多账号模式不支持"
- "企微消息无回复"

## 诊断流程

### 步骤 1:检查通道状态

```bash
openclaw channels status 2>&1
```

**判断标准:**
- `enabled, configured, running` ✅ 正常
- `enabled, not configured, stopped` ❌ 配置缺失
- `error:*` ❌ 错误状态

### 步骤 2:检查配置文件

```bash
openclaw config get channels.wecom 2>&1
```

**检查项:**
1. `botId` 是否存在
2. `secret` 是否存在
3. 是否使用了不支持的 `accounts.*` 多账号结构

### 步骤 3:检查插件配置

```bash
grep -A 10 '"plugins"' ~/.openclaw/openclaw.json
```

**常见问题:**
- 插件 ID 不匹配(配置用 `wecom-openclaw-plugin`,实际导出 `wecom`)
- 插件未启用

### 步骤 4:查看日志

```bash
cat /tmp/openclaw/openclaw-$(date +%Y-%m-%d).log | grep -i wecom | tail -20
```

**关键错误:**
- `plugin id mismatch`
- `Invalid WebSocket frame`
- `Authentication failed`
- `not configured`

---

## 修复方案

### 问题 A:插件 ID 不匹配

**症状:**
```
[plugins] plugin id mismatch (config uses "wecom-openclaw-plugin", export uses "wecom")
plugins.entries.wecom: plugin not found: wecom
```

**修复:**

将 `openclaw.json` 中的插件配置从:
```json
{
  "plugins": {
    "allow": ["wecom-openclaw-plugin"],
    "entries": {
      "wecom-openclaw-plugin": {"enabled": true}
    }
  }
}
```

改为:
```json
{
  "plugins": {
    "allow": ["wecom"],
    "entries": {
      "wecom": {"enabled": true}
    }
  }
}
```

**原因:** 企微插件的 `openclaw.plugin.json` 中定义 `id: "wecom"`,但安装包名为 `@wecom/wecom-openclaw-plugin`,配置时应使用导出 ID 而非包名。

---

### 问题 B:多账号模式不支持

**症状:**
```
wecom default: 企业微信机器人 ID 或 Secret 未配置
config reload skipped (invalid config)
```

**当前配置(错误):**
```json
{
  "channels": {
    "wecom": {
      "enabled": true,
      "defaultAccount": "main",
      "accounts":...

相关技能

OpenClaw

bambu-studio-ai

heyixuan2

Bambu Lab 3D printer control and automation. Activate when user mentions: printer status, 3D printing, slice, analyze model, generate 3D, AMS filament, print monitor, Bambu Lab, or any 3D printing task. Full pi...

OpenClaw

geo-optimization

capt-marbles

Generative Engine Optimization (GEO) for AI search visibility. Optimize content to appear in ChatGPT, Perplexity, Claude, and Google AI Overviews. Use when optimizing websites, pages, or content for LLM discove...

OpenClaw

0protocol

0isone

Agents can sign plugins, rotate credentials without losing identity, and publicly attest to behavior.

OpenClaw

0x0-messenger

eijiac24

Send and receive P2P messages using disposable numbers and PINs. No servers, no accounts. Use for human notifications, approval flows, and agent-to-agent communication.