用途:该技能用于创建单个新的 OpenClaw Agent,并在一次流程内完成路由与配置更新,仅限飞书渠道,不适用于 Telegram、Slack、Discord 等其他渠道。
主要能力:先与用户对齐场景,再收集字段。场景分为两种:选项 A,新建机器人/应用并映射到新 Agent(routing_mode=account);选项 B,将已有或新群组映射到某个机器人下的新 Agent(routing_mode=peer)。必填字段包括 agent_id(仅小写字母、数字、-)、workspace(项目工作区绝对路径)、routing_mode(account 或 peer);model 可选;channel 可选且固定为 feishu。account 模式需 account_id,可选 app_id、app_secret、bot_name;peer 模式需 peer_kind(group 或 direct)与 peer_id,account_id 可选。
使用方式:先询问用户选择哪种场景,回答模糊则停止并澄清。多群组场景需执行引导门:引导新建群并加入机器人,等待用户明确回复“已创建群”;再引导在群内发送一条消息,等待“已发送”;然后用 openclaw logs --follow 检查日志,从类似 Received message from peer: { kind: "group", id: "oc_xxxx" } 的信号中提取 chat_id(格式 oc_xxxxx)。随后备份配置,运行 test -f ~/.openclaw/openclaw.json 与 cp 备份命令;配置缺失则停止并让用户先初始化 OpenClaw。接着运行 openclaw agents add <agent_id> --workspace <workspace> --non-interactive(如提供 model 则加 --model <model>)。再用脚本 python3 scripts/upsert_openclaw_agent.py 并传 config、agent-id、routing-mode 及可选参数完成配置写入,脚本会 upsert 对应 account、写入一条 binding,并强制 session.dmScope = per-account-channel-peer。最后运行 openclaw gateway restart 与 openclaw agents list --bindings 验证并输出摘要。
适用场景:飞书单机器人单 Agent 或多群组多 Agent 路由的创建与配置。
限制:仅支持飞书;需保留无关的既有 agent、account、binding;拒绝同一 channel/account/peer 路由被其他 agent 占用的冲突;非交互模式运行,除非用户明确要求交互;多群组场景未收到“已创建群”和“已发送”前不得越过引导门。其他细节资料未提供。