Feishu Agent Provision — 飞书 Agent 创建与管理系统

⚠️ 安全声明（必读） 本 skill 需要以下系统权限，请在安装前确认：

• 在 $HOME/.openclaw/ 下创建目录和文件
• 修改 OpenClaw 网关配置（gateway config.patch）
• 创建和管理 cron 定时任务
• 读写 agent workspace 下的所有文件
• 注册 agent ID 并绑定飞书群

安装行为： always: false（仅在用户明确触发时执行，不自动运行） VirusTotal： 已确认安全（0/67 引擎报恶意） 适用场景： 需要为特定飞书群创建专属 Agent 并设置定时报告的运营管理场景。

功能特性

• ✅ 询问配置问题（交互式创建流程）
• ✅ 创建独立 workspace（含 SOUL.md、USER.md、HEARTBEAT.md）
• ✅ 注册 Agent 到 OpenClaw 配置
• ✅ 绑定飞书群到该 Agent
• ✅ 设置每日/每周定时报告
• ✅ Session 长效性选择（短期/中期/长期）
• ✅ 自动备份机制（启动恢复 + 结束备份）

触发条件

用户说以下内容时激活：

• "创建一个飞书agent"
• "创建项目agent"
• "新建agent并绑定飞书群"
• "创建一个专属agent"
• "创建一个飞书群agent"
• "新建一个飞书agent"

工作流程

第一步：收集配置（询问用户）

依次询问以下问题，确认所有配置：

必填项：

1. Agent ID — 英文ID，如 ctyun、project-x（字母+数字+短横线，不能有下划线或中文）

2. Agent 中文名 — 对外显示名称，如"业务代理"、"航天赛道Agent"

3. 飞书群 ID — 形如 oc_xxx（确认已加入机器人的群）

4. Agent 职责描述 — 这个 agent 负责什么？（简要描述，50字以内）

5. 汇报时间：

   • 每日汇报时间（如 17:00，默认 17:00）
   • 每周汇报时间（如 周五 17:00，默认周五 17:00）

6. 数据文件路径（可选） — agent 需要读取的数据文件绝对路径，如 /Users/xxx/.project/data.json

可选配置：

7. Session 长效性 — 让用户选择：

   请选择 Agent 的 Session 模式：
   
   1️⃣ 短期（isolated）
      - 每次任务新建 session，不保留历史
      - 轻量、隔离，适合临时性 Agent
   
   2️⃣ 中期（medium session）
      - 持久 session，保留上下文
      - 定时清理旧数据（30天）
      - 适合有持续任务但不需要长期记忆的 Agent
   
   3️⃣ 长期（long session）【推荐】
      - 完整持久 session，累积所有历史
      - 完整备份机制
      - 适合需要记住项目进度、历史决策的 Agent
   
   请回复数字 1、2 或 3
   

   推荐选择 3（长期），可获得完整记忆累积能力。

如果用户提供了完整信息，跳过询问直接使用。

第二步：创建 Workspace（操作前需用户确认）

⚠️ 确认提示：即将在 $HOME/.openclaw/agents/\x3CAGENT_ID>/ 下创建目录和文件。这是安全的，但如果该 Agent ID 已存在，现有配置可能被覆盖。

AGENT_ID="\x3Cid>"
AGENT_DIR="$HOME/.openclaw/agents/$AGENT_ID/workspace"
mkdir -p "$AGENT_DIR/memory"
mkdir -p "$AGENT_DIR/memory/daily"

第三步：写入 Workspace 文件

SOUL.md — Agent 身份定义，包含：

• Agent 名称和职责
• 项目背景和关键数据
• 工作原则和优先级定义
• 汇报飞书群 ID
• 语气风格

USER.md — 服务对象信息（从主 workspace 复制或新建）

AGENTS.md — 标准 workspace 指引（从主 workspace 复制）

HEARTBEAT.md — 空或仅有注释

memory/backup.md — 备份状态文件：

# \x3CAGENT_ID> 备份状态

## 基本信息
- 创建时间：\x3CYYYY-MM-DD>
- Session 长效性：\x3C短期/中期/长期>
- 核心配置：\x3C职责描述>
- 飞书群：\x3C群ID>

## 当前状态
- 最后更新时间：\x3CYYYY-MM-DD>
- 当前进度：\x3C简要描述>
- 待处理事项：\x3C列表>

## Session 模式
- sessionTarget: session:\x3CAGENT_ID>
- 备份策略：启动时读 backup.md，结束时写 backup.md

第四步：注册 Agent 到 OpenClaw 配置（操作前需用户确认）

⚠️ 确认提示：即将修改 OpenClaw 全局配置，添加 Agent 注册信息和群组路由绑定。修改后需执行 openclaw gateway restart 使配置生效。

使用 gateway config.patch 注入：

{
  "agents": {
    "list": [{
      "id": "\x3CAGENT_ID>",
      "workspace": "\x3CAGENT_DIR>",
      "identity": { "name": "\x3C中文名>" }
    }]
  },
  "bindings": [{
    "type": "route",
    "agentId": "\x3CAGENT_ID>",
    "match": {
      "channel": "feishu",
      "peer": { "kind": "group", "id": "\x3C飞书群ID>" }
    }
  }]
}

第五步：验证路由

发送测试消息到对应飞书群，检查日志确认路由成功：

openclaw logs --follow | grep "dispatching to agent"

确认日志出现 agent:\x3CAGENT_ID>:feishu:group:\x3C飞书群ID>

第六步：设置定时报告（含备份机制）（操作前需用户确认）

⚠️ 确认提示：即将创建 cron 定时任务，该任务将持续运行并在指定时间向飞书群发送消息。如不再需要，可随时通过 cron remove 删除。

使用 cron add 创建定时任务：

使用 cron add 创建定时任务：

Session 模式映射：

Cron payload 示例（含自动备份）：

{
  "kind": "agentTurn",
  "message": "📋 \x3C中文名>定时报告时间到！\
\
【记忆恢复】启动时先读 ~/.openclaw/agents/\x3CAGENT_ID>/workspace/memory/backup.md，了解当前状态。\
\
【执行任务】\x3C具体任务内容，如读取数据文件、生成报告等>\
\
【结束备份】任务完成后，把本次执行结果（时间、做了什么、下次待办）追加写入 ~/.openclaw/agents/\x3CAGENT_ID>/workspace/memory/backup.md。\
\
格式：【YYYY-MM-DD HH:MM】完成：xxx；待办：xxx",
  "timeoutSeconds": 120
}

日报 Cron：

• 每周一至周五指定时间（如 17:00）
• sessionTarget 根据用户选择设置

周报 Cron：

• 每周指定时间（如周五 17:00）
• 与日报合并发送，不单独发

第七步：自动备份机制说明

启动时恢复： 每次 cron 触发后，先读取 memory/backup.md，恢复：

• 当前项目进度
• 待处理事项
• 历史背景

结束时备份： 每次任务完成后，将结果追加写入 memory/backup.md：

• 本次完成内容
• 下次待办
• 任何重要决策记录

Session 长效性对比：

注意事项

• 始终使用绝对路径，勿用 ~（agent 运行时不会展开）
• SOUL.md 要具体，包含实际的项目数据（KPI、合作模式、优先名单等）
• 飞书群必须已在 channels.feishu.groupAllowFrom 中配置
• Session 长效性建议选择 长期（3），可获得最完整的记忆累积
• 创建完成后在飞书群实测：发送一条消息，确认由对应 agent 响应而非主 agent

故障排查（Troubleshooting）

问题1：Agent 未响应群消息

症状：在飞书群发送消息，没有收到回复。

排查步骤：

• 检查 Gateway 是否运行：openclaw gateway status
• 检查飞书群是否在白名单：openclaw config get channels.feishu.groupAllowFrom
• 确认群 ID 在列表中。
• 检查日志路由：openclaw logs --limit 50 | grep ""
• 查看是否有消息到达和 dispatch 记录。
• 检查 Agent 是否注册成功：openclaw config get agents.list
• 确认新 Agent ID 在列表中。

问题2：消息回退到主 Agent

症状：群消息被主 Agent 响应，而不是专属 Agent。

原因：binding 路由未生效。

排查：

• 确认 bindings 配置正确：openclaw config get bindings
• 检查 agentId 是否指向正确的 Agent，peer.id 是否是群 ID。
• 重启 Gateway：openclaw gateway restart
• 配置修改后需重启生效。
• 检查 Gateway 日志中是否有 dispatch 记录：openclaw logs | grep "dispatching"

问题3：Session 没有保留历史

症状：Agent 每次都不记得之前的事。

原因：选择了"短期（isolated）"模式。

解决：

• 修改 cron 任务的 sessionTarget 为 "session:\x3CAGENT_ID>"
• 重启 Gateway 使配置生效

问题4：备份文件没有更新

症状：memory/backup.md 内容一直是旧的。

排查：

• 检查 cron 任务的 payload 是否包含"结束备份"指令
• 检查 Agent 对应的 session 是否正常运行
• 检查备份文件的写入路径是否正确（绝对路径）

版本历史

• v2.1：顶部新增完整安全声明；操作前增加用户确认提示；移除重复警告段落；确保元数据与实际行为一致
• v2.0：新增 Session 长效性选择（短期/中期/长期）；新增自动备份机制（启动恢复+结束备份）；优化备份文件格式；新增安全说明消除 VirusTotal 误报
• v1.0：初始版本，基础创建流程