Rechercher

PythonReactSEOPDF
OpenClaw

wecom-channel-fix

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

fclwtt0 installations selon la source☆ 0 Étoiles du dépôtv1.0.0

Installation

Suivez les instructions du dépôt pour votre agent. Consultez les fichiers et dépendances avant l’installation.

SkillHub CLI

skillhub install fclwtt/skills-5

Examinez la source et la compatibilité, puis suivez les étapes d’installation.

Donnez le lien à votre agent et demandez-lui d’examiner instructions et dépendances avant d’expliquer les étapes.

Voir la source ↗Guides

Instructions

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

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

触发场景

  • "企微没反应"
  • "企业微信通道配置错误"
  • "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":...

Informations sur la source

Source
github
Repository
openclaw/skills
Path
skills/fclwtt/skills-5
Version
1.0.0
Commit
226b3937f4dfb5c113b56d9cc393e1189ef3a91f
Source de classification
rules
Statut
active
Visibilité
public

Ces informations proviennent de l’analyse indexée et peuvent être anciennes. Vérifiez les fichiers actuels.

Contenu extrait

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":...

Skills associés

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.