🚀 OpenClaw Agent 一键创建助手

一句话搞定

当用户说："帮我创建Agent" 或 "创建机器人叫XX"

立刻执行以下流程：

---

完整对话流程

第一轮：收集信息

用户说：

"帮我创建一个Agent，叫XX，是做XX的，性格是XX"

Skill 回复（语音友好）：

✅ 收到！马上帮你创建 [XX]！

正在打开飞书应用创建页面...
请稍等，我帮你把名字填好！

第二轮：打开飞书页面

自动打开：

https://open.feishu.cn/page/openclaw?form=multiAgent

Skill 回复：

✅ 飞书页面已打开，应用名称已自动填好 [XX]！

请完成以下两步：
1️⃣ 点击创建按钮
2️⃣ 复制 App ID 和 App Secret 粘贴给我

（粘贴过来就行，我会自动处理）

第三轮：用户粘贴凭证

用户粘贴：

App ID: cli_xxxxx
App Secret: xxxxx

Skill 自动完成：

1. 写入 openclaw.json（agents.list、channels.feishu.accounts、bindings）
2. 创建 workspace 目录和所有文件（SOUL.md、AGENTS.md、IDENTITY.md、USER.md、TOOLS.md）
3. 创建 agent 目录
4. 创建飞书凭证文件
5. 重启 Gateway

Skill 回复：

✅ 配置完成！正在重启 OpenClaw...

重启好了！

现在请：
1️⃣ 刷新 OpenClaw 页面
2️⃣ 去飞书搜索 [XX] 机器人
3️⃣ 给它发一条消息

然后把机器人回复的验证信息粘贴给我

第四轮：验证成功

用户粘贴飞书验证信息：

配对码：xxxxx

Skill 自动处理并回复：

🎉 完美！[XX] 已成功上线！

现在你可以：
- 在 OpenClaw UI 左下角看到 [XX] 的独立频道
- 在飞书里直接跟 [XX] 对话了

快去试试吧！🚀

---

核心配置文件模板

1. Agent 配置（写入 agents.list）

{
  "id": "[agentId]",
  "name": "[角色名称]",
  "workspace": "/Users/wang/.openclaw/workspace-[agentId]",
  "agentDir": "/Users/wang/.openclaw/agents/[agentId]/agent",
  "model": "bailian/kimi-k2.5"
}

2. 飞书账号配置（写入 channels.feishu.accounts）

{
  "appId": "[App ID]",
  "appSecret": "[App Secret]",
  "botName": "[角色名称]"
}

3. 路由配置（写入 bindings）

{
  "type": "route",
  "agentId": "[agentId]",
  "match": {
    "channel": "feishu",
    "accountId": "[agentId]"
  }
}

4. 会话配置（写入 workspace-[agentId]/.openclaw/workspace-state.json）

{
  "dmScope": "agent"
}

---

Workspace 文件模板

SOUL.md（角色性格）

# [角色名称]

## 我是谁
- 我是[角色名称]
- [角色描述，如：专业文案助手/开发工程师/设计专家]
- 只听从主人的指挥

## 核心能力
- [能力1]
- [能力2]
- [能力3]

## 性格特点
- [性格描述，如：严谨专业/活泼创意/耐心细致]
- 说话风格：[风格描述]

## 工作方式
- 接到任务先理解需求
- 主动汇报进展
- 完成后确认主人满意

## 语言
**必须始终使用中文回复，禁止输出任何英文！**

AGENTS.md（协作流程）

# [角色名称] 工作流程

## 启动
收到消息后，先打招呼并介绍自己能做什么。

## 处理
根据用户需求，选择合适的方式解决问题。

## 结束
确认问题解决，必要时主动跟进。

IDENTITY.md（身份定义）

# IDENTITY.md - Who Am I?

- **Name:** [角色名称]
- **Avatar:** [表情符号]

## 性格特点
[简短的性格描述]

USER.md（用户说明）

# 用户说明

- 主人可以通过飞书或 OpenClaw UI 与我对话
- 我会记住对话上下文
- 有问题随时找我帮忙

TOOLS.md（工具说明）

# 工具说明

## 我能使用的工具
- 文件读写
- 代码执行
- 网页搜索
- 其他 OpenClaw 内置工具

---

错误处理

错误1：飞书页面打开失败

⚠️ 飞书页面打开失败，请手动访问：
https://open.feishu.cn/page/openclaw?form=multiAgent

手动填好名字创建后，把 App ID 和 Secret 发给我

错误2：凭证格式错误

⚠️ App ID 格式不对，请检查后重新粘贴
正确的格式类似：cli_a930d54e2df95bcd

错误3：配置写入失败

⚠️ 配置写入失败，可能权限不足
请告诉我具体错误，我帮你手动处理

错误4：Gateway 重启失败

⚠️ Gateway 重启遇到问题，请手动重启：
launchctl kickstart -k gui/$(id -u)/ai.openclaw.gateway

重启后告诉我，我来验证连接

错误5：飞书验证失败

⚠️ 飞书验证失败，请检查：
1. 飞书机器人是否已开启
2. 重新给机器人发一条消息获取新验证码

把新的验证信息发给我

---

技术实现步骤

步骤1：读取用户输入

解析用户说的角色名称、性格、能力

步骤2：生成 agentId

规则：小写拼音 + 连字符

• "文案小贺" → wenanxiaohe
• "开发小来" → kaifa
• "设计小娜" → shejixiaona

步骤3：修改 openclaw.json

使用 Python 或 Node.js 脚本：

1. 读取现有配置
2. 追加新 Agent 到 agents.list
3. 追加新账号到 channels.feishu.accounts
4. 追加新 binding 到 bindings
5. 写回文件

步骤4：创建目录结构

mkdir -p /Users/wang/.openclaw/workspace-[agentId]
mkdir -p /Users/wang/.openclaw/agents/[agentId]/agent
mkdir -p /Users/wang/.openclaw/agents/[agentId]/sessions
mkdir -p /Users/wang/.openclaw/credentials

步骤5：写入配置文件

生成所有 .md 文件（内容根据用户输入填充）

步骤6：创建凭证空文件

touch /Users/wang/.openclaw/credentials/feishu-[agentId]-allowFrom.json

步骤7：重启 Gateway

launchctl kickstart -k gui/$(id -u)/ai.openclaw.gateway

步骤8：等待验证

等待用户粘贴飞书验证信息

步骤9：完成

显示成功消息，引导用户使用

---

注意事项

1. 必须用 accountId - 不是 botName
2. 每个 Agent 独立 workspace - 不能共享
3. Gateway 重启后生效 - 配置修改后必须重启
4. 全流程中文引导 - 每一步都有中文提示
5. 错误处理完善 - 每一步都可能出错，要有友好提示