feishu-group-company

# Feishu Group Company

## Overview

Use this skill to standardize a shared Feishu company group with one default coordinator bot and multiple specialist bots.

Target behavior:
- No @mention in the group → only the coordinator bot replies
- @mention a specialist bot → only that specialist replies
- When another bot is explicitly mentioned, the coordinator bot returns `NO_REPLY`

## Quick start

1. Confirm the group chat ID (`oc_xxx`) and the Feishu account IDs for all bots.
2. Decide which bot is the default coordinator, usually `company-ceo`.
3. Run `scripts/apply_feishu_group_company.py` against `~/.openclaw/openclaw.json`.
4. Reload/restart Gateway if needed.
5. Verify with two tests:
   - plain message with no @mention
   - message that @mentions a specialist bot

## What this skill changes

For the target group:
- Top-level group rule becomes `requireMention: true`
- Specialist bot accounts get per-account override `groups.<chatId>.requireMention: true`
- Coordinator bot account gets per-account override `groups.<chatId>.requireMention: false`
- Coordinator bot gets a group-scoped `systemPrompt` that enforces:
  - no @mention → reply normally
  - @other user/bot but not coordinator → `NO_REPLY`
  - @coordinator → reply normally
- Legacy invalid per-account key `group` is removed in favor of `groups`

## Important notes

- Use `groups`, not `group`, under `channels.feishu.accounts.<accountId>`.
- If you rename a Feishu account ID, also update any `bindings[].match.accountId` that reference it.
- Specialist bots may still receive the event at transport level if they have group-message permissions; the important part is that they are mention-gated and therefore reject non-mentioned messages.
- The coordinator bot must still be instructed to stay silent when another bot is explicitly mentioned; this skill does that via group `systemPrompt`.
- If a specialist bot never receives group traffic even when @mentioned, check Feishu app permissions first.

## When behavior is still wrong

Read `references/troubleshooting.md` and check logs for these patterns:
- Good specialist rejection on plain message:
  - `rejected: no bot mention`
- Good coordinator silence when another bot is mentioned:
  - `dispatch complete (replies=0)`
- Broken specialist delivery:
  - no inbound log lines for that account at all

## Resources

### scripts/
- `apply_feishu_group_company.py` — patch `openclaw.json` for one company group pattern

### references/
- `troubleshooting.md` — quick diagnosis checklist and expected log signatures