OpenClaw Agent Feishu Onboarding

Standardize creation of new OpenClaw agents and Feishu route binding. Use this skill for operational execution with strict confirmations.

Runtime Prerequisites

• Required binaries:
  • openclaw (CLI available in PATH)
  • python (3.x, used by scripts/validate_feishu_bindings.py)
• Preflight checks:
  • openclaw --version
  • python --version
• Data access behavior:
  • Reads local OpenClaw config (openclaw.json / OPENCLAW_CONFIG_PATH)
  • May write local agent and routing state (agents.list[], bindings[])
  • Do not run on machines where local config access is not permitted

Core Scope

• Create a new agent (agents.list + workspace + identity).
• Confirm Feishu route target fields before any write.
• Bind routing using bindings.match with channel/accountId/peer.
• Verify final route and provide rollback steps.

Required Inputs

• Agent intent:
  • Agent purpose and responsibility boundary.
  • Explicit out-of-scope items.
• Agent spec:
  • agentId (lowercase, digits, hyphen).
  • workspace path.
  • model id.
  • Identity object in agents.list[]:
    • use identity object (for example identity.name, identity.emoji, identity.theme)
    • do not rely on top-level name only
• Feishu route spec:
  • match.channel: feishu
  • match.accountId: for example main
  • match.peer.kind: group (or dm when needed)
  • match.peer.id: Feishu session id (group id like oc_xxx or dm id)

Hard Validation Gates (Must Pass)

• agents.list[] entry for new agent must include identity object.
• identity.name must be set for human-readable routing/debug checks.
• match.accountId must be one of channels.feishu.accounts keys (for example main).
• Never put Feishu group/session id (oc_xxx) into match.accountId.
• Group routing must include match.peer = { kind: "group", id: "oc_xxx" }.
• If routing is for a specific group but match.peer is missing, abort and correct config before continuing.
• Before write, print the final binding object and require explicit confirmation.

Multi-Step Confirmation Protocol

Do not skip confirmations. Ask and confirm in this exact order.

1. Confirmation A: Agent Goal
   • Confirm what this agent should do.
   • Confirm what this agent must not do.
2. Confirmation B: Agent Configuration
   • Confirm agentId, workspace, model, identity fields.
   • Confirm naming conventions and collision check (agentId uniqueness).
3. Confirmation C: Feishu Routing Target
   • Confirm accountId.
   • Confirm peer.kind.
   • Confirm peer.id (explicitly state this is the Feishu session id).
   • Confirm whether this is a precise peer binding or account-level fallback.
4. Confirmation D: Execution Approval
   • Summarize all fields in one compact block.
   • Ask for final go/no-go before writing config.