Search

PythonReactSEOPDF
OpenClaw

wecom-channel-fix

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

fclwtt0 source installs☆ 0 Repository starsv1.0.0

Installation

Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.

SkillHub CLI

skillhub install fclwtt/skills-5

Inspect the source and compatibility requirements, then follow its installation steps.

Give your agent the source link and ask it to inspect instructions and dependencies before explaining the installation steps.

View source ↗Guides

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

Source information

Source
github
Repository
openclaw/skills
Path
skills/fclwtt/skills-5
Version
1.0.0
Commit
226b3937f4dfb5c113b56d9cc393e1189ef3a91f
Classification source
rules
Status
active
Visibility
public

These signals come from indexed source analysis and may lag behind changes. Check the current source files.

Extracted content

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

Related skills

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.