> 作者：少年李迟迟
> 工作区文件（USER.md 等）不写死任何用户名，参考模板结合用户信息动态生成。
> 飞书配对自动化（脚本直接写入 openclaw.json），无需主 agent 介入。
向用户收集以下信息（逐项询问，不要一次性问完）：
| 信息 | 说明 | 验证规则 |
|---|---|---|
| ------ | ------ | --------- |
agent_id | 唯一标识，英文字母/数字/连字符 | 必须是合法标识符（字母开头） |
name | 中文名称 | 1-20字 |
description | 职能描述 | 一句话说明这个 agent 是做什么的 |
feishu_appid | 飞书 AppID | 格式：cli_xxxxxxxx |
feishu_appsecret | 飞书 AppSecret | 非空字符串 |
> ⚠️ 如果用户跳过飞书信息，创建完成后仍需引导填写。
>
> 路径说明： ~/.openclaw/skills/x-create-agent 是默认安装路径示例，实际路径因用户环境而异。脚本支持自动搜索，搜不到时会交互式询问，用户只需输入自己的 OPENCLAW_HOME 绝对路径即可，开源分享无障碍。
路径确认制：脚本发现路径后，先展示汇总信息，用户确认（输入 y）后再创建。
cd ~/.openclaw/skills/x-create-agent
python3 scripts/create_agent.py "<agent_id>" "<name>" "<description>" \
[--openclaw-home <path>] \
[--workspace <path>] \
[--user-name <name>] \
[--feishu-appid <appid>] \
[--feishu-appsecret <secret>]
展示内容（等用户确认）：
路径发现优先级（自动搜索，无需手动指定）：
OPENCLAW_HOME 环境变量（如已设置）openclaw 二进制所在目录向上搜索~/.openclaw/ 等 Linux/macOS/Windows 平台覆盖）手动指定（可选）：
--openclaw-home — 显式指定配置目录路径--workspace — 自定义工作区路径（相对路径基于脚本目录 resolve）如全部搜索失败：脚本进入交互模式，提示用户输入配置目录路径并验证 openclaw.json 存在。
用户输入非 y：脚本立即退出，不创建任何文件。
创建时直接传入 AppID 和 AppSecret，自动完成飞书机器人配对：
python3 scripts/create_agent.py "<agent_id>" "<name>" "<description>" \
--feishu-appid "cli_xxxxxxxx" \
--feishu-appsecret "<secret>"
这会在 openclaw.json 中自动写入：
channels.feishu.accounts[] ：机器人凭证bindings：路由绑定如未传入，脚本会在创建完成后打印操作指引。无需主 agent 介入，skill 调用者自己引导用户完成即可。
飞书机器人创建链接：
创建完成后，报告：
scripts/create_agent.pyagents//agent/ 目录openclaw.json路径发现逻辑（按优先级）：
OPENCLAW_HOME 环境变量~/.openclaw/~/.openclaw/）openclaw.json 注册：
agents.list 中添加新条目（含 id、name、workspace、agentDir）tools.agentToAgent.allow 中添加新 agent_id飞书配对自动写入：
channels.feishu.accounts[] ：机器人凭证（appId + appSecret）bindings：路由绑定（channel=feishu, accountId=工作区文件：
agent_id、name、description、user_name 动态渲染生成各文件SOUL.md → 填入 agent 名称和职能描述（专属内容）USER.md → 填入 user_name（主人名）IDENTITY.md → 填入 agent 名称AGENTS.md / HEARTBEAT.md / TOOLS.md / MEMORY.md / SESSION-STATE.md → 使用模板固定内容openclaw.json 中写入 enabled 字段（schema 不支持）agents 下创建配置（schema 要求在 agents.list 中）workspace 和 agentDir 必须使用绝对路径--user-name 为可选，不传则 USER.md 中显示为"用户"lark-cli（用于验证飞书凭证连通性，可选）共 16 个版本