{
  "schemaVersion": "1.0",
  "item": {
    "slug": "openclaw-agent-builder",
    "name": "Openclaw Agent Builder",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/a12591771/openclaw-agent-builder",
    "canonicalUrl": "https://clawhub.ai/a12591771/openclaw-agent-builder",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/openclaw-agent-builder",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-agent-builder",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/openclaw-agent-builder"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/openclaw-agent-builder",
    "agentPageUrl": "https://openagent3.xyz/skills/openclaw-agent-builder/agent",
    "manifestUrl": "https://openagent3.xyz/skills/openclaw-agent-builder/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/openclaw-agent-builder/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "OpenClaw Agent Builder",
        "body": "为 OpenClaw 创建和配置 AI Agent 的完整指南。OpenClaw 使用基于工作空间的 Agent 架构，每个 Agent 拥有独立的会话、配置和上下文文件。"
      },
      {
        "title": "核心架构",
        "body": "~/.openclaw/\n├── openclaw.json          # 主配置文件\n├── agents/                # Agent 会话存储\n│   ├── <agentId>/\n│   │   ├── agent/         # Agent 配置\n│   │   └── sessions/      # 会话历史 (JSONL)\n│   └── main/              # 默认主 Agent\n├── workspace/             # 主工作空间\n│   ├── AGENTS.md          # 工作流指令\n│   ├── SOUL.md            # 角色人格定义\n│   ├── TOOLS.md           # 工具使用说明\n│   ├── USER.md            # 用户配置\n│   ├── MEMORY.md          # 长期记忆 (仅主会话)\n│   ├── memory/            # 每日记忆文件\n│   └── .learnings/        # 学习日志\n└── skills/                # 技能目录"
      },
      {
        "title": "何时使用",
        "body": "场景方案需要专用 Agent 处理特定领域任务创建新 Agent需要隔离会话历史使用多 Agent 路由不同任务需要不同模型/工具配置配置 Agent 专属设置团队协作需要独立上下文创建团队 Agent多人共用 Gateway 但需要私密对话配置 dmScope: per-channel-peer同一用户跨频道保持会话连续配置 identityLinks飞书/钉钉群需要绑定特定 Agent配置 bindings + requireMention"
      },
      {
        "title": "可选机制选择器",
        "body": "不是每个 Agent 都需要以下所有机制。根据实际需求选择：\n\n机制使用时机配置位置Bindings需要精确控制消息路由到哪个 Agentbindings[]dmScope多人使用同一个聊天账号，需要隔离私密对话session.dmScopeidentityLinks同一用户在多个频道联系你，希望共享会话session.identityLinkssendPolicy阻止某些会话类型的消息发送（如 cron 任务不回复）session.sendPolicysession.maintenance高频率会话，需要自动清理过期会话session.maintenancethreadBindingsDiscord/Slack 线程需要独立会话session.threadBindingssandbox运行不受信代码或需要安全隔离agents[].sandboxtools allow/deny限制 Agent 可使用的工具（如家庭 Agent 不允许写文件）agents[].toolsFeishu 群绑定飞书特定群组需要特定 Agent 响应channels.feishu.groups"
      },
      {
        "title": "机制配置示例",
        "body": "1. Bindings - 消息路由\n\n{\n  agents: {\n    list: [\n      { id: \"home\", workspace: \"~/.openclaw/workspace-home\" },\n      { id: \"work\", workspace: \"~/.openclaw/workspace-work\" },\n    ],\n  },\n  bindings: [\n    // 飞书特定用户 → work Agent\n    { agentId: \"work\", match: { channel: \"feishu\", peer: { kind: \"direct\", id: \"ou_xxx\" } } },\n    // 飞书特定群组 → work Agent\n    { agentId: \"work\", match: { channel: \"feishu\", peer: { kind: \"group\", id: \"oc_xxx\" } } },\n    // WhatsApp 默认 → home Agent\n    { agentId: \"home\", match: { channel: \"whatsapp\" } },\n  ],\n}\n\n2. dmScope - DM 会话隔离\n\n{\n  session: {\n    // 多人共用一个 WhatsApp 号，每人独立会话\n    dmScope: \"per-channel-peer\",\n    // 同一用户跨频道合并会话\n    identityLinks: {\n      alice: [\"telegram:123456789\", \"feishu:ou_xxx\"],\n    },\n  },\n}\n\n3. 飞书群组配置\n\n{\n  channels: {\n    feishu: {\n      dmPolicy: \"pairing\",\n      groupPolicy: \"allowlist\",\n      groupAllowFrom: [\"oc_group1\", \"oc_group2\"],\n      groups: {\n        \"oc_group1\": {\n          requireMention: true,  // 需要 @机器人\n          allowFrom: [\"ou_user1\", \"ou_user2\"],  // 允许控制命令的用户\n        },\n      },\n    },\n  },\n}\n\n4. Agent 工具限制\n\n{\n  agents: {\n    list: [\n      {\n        id: \"family\",\n        workspace: \"~/.openclaw/workspace-family\",\n        sandbox: { mode: \"all\", scope: \"agent\" },\n        tools: {\n          allow: [\"read\", \"exec\"],\n          deny: [\"write\", \"edit\", \"apply_patch\", \"browser\"],\n        },\n      },\n    ],\n  },\n}\n\n5. 会话维护\n\n{\n  session: {\n    maintenance: {\n      mode: \"enforce\",\n      pruneAfter: \"30d\",       // 30 天后清理\n      maxEntries: 500,         // 最多 500 个会话\n      rotateBytes: \"10mb\",     // sessions.json 超过 10MB 时轮转\n    },\n  },\n}"
      },
      {
        "title": "创建新 Agent 流程",
        "body": "创建工作空间\nmkdir -p ~/openclaw-workspaces/<agent-name>\ncd ~/openclaw-workspaces/<agent-name>\nopenclaw setup --workspace .\n\n\n\n创建 Bootstrap 文件\n# 必需文件\ntouch AGENTS.md SOUL.md TOOLS.md USER.md\n# 可选：初次运行引导\ntouch BOOTSTRAP.md\n\n\n\n注册 Agent\nopenclaw agents create <agent-name> --workspace ~/openclaw-workspaces/<agent-name>\n\n\n\n配置模型\nopenclaw agents config <agent-name> --model anthropic/claude-sonnet-4-5-20250929"
      },
      {
        "title": "AGENTS.md - 工作流指令",
        "body": "定义 Agent 的行为规范、工作流程和自动化规则。\n\n# 你的工作空间\n\n## 每次会话前\n1. 阅读 SOUL.md — 你是谁\n2. 阅读 USER.md — 你帮助谁\n3. 阅读 memory/YYYY-MM-DD.md — 最近上下文\n\n## 安全规则\n- 不泄露私密数据\n- 破坏性操作前必须询问\n- 使用 `trash` 而非 `rm`\n\n## 工具使用\n- 检查技能的 SKILL.md\n- 本地配置写在 TOOLS.md"
      },
      {
        "title": "SOUL.md - 角色人格",
        "body": "定义 Agent 的身份、语气、边界和原则。\n\n# 你的身份\n\n## 你是谁\n- 名称：[Agent 名称]\n- 角色：[专业领域]\n- 语气：[专业/友好/简洁]\n\n## 原则\n- 主动但不打扰\n- 准确优于快速\n- 不确定时询问"
      },
      {
        "title": "TOOLS.md - 工具说明",
        "body": "记录工具的使用细节、集成要点和本地配置。\n\n# 工具配置\n\n## 本地工具\n- 浏览器：`browser.enabled: true`\n- 沙箱：`sandbox.enabled: false`\n\n## 集成细节\n- 数据库连接字符串\n- API 端点配置\n- 认证凭据位置"
      },
      {
        "title": "USER.md - 用户配置",
        "body": "定义用户偏好、联系方式和特殊需求。\n\n# 用户信息\n\n## 联系方式\n- 首选频道：WhatsApp / Telegram / Discord\n- 时区：Asia/Shanghai\n- 语言：中文\n\n## 偏好\n- 回复风格：简洁/详细\n- 主动检查：每日 2-4 次"
      },
      {
        "title": "主 Agent (main)",
        "body": "~/.openclaw/agents/main/\n├── agent/\n│   ├── auth.json          # 认证令牌\n│   └── models.json        # 模型配置\n└── sessions/\n    └── <sessionId>.jsonl  # 会话历史"
      },
      {
        "title": "专用 Agent",
        "body": "~/.openclaw/agents/<agent-id>/\n├── agent/\n│   ├── auth.json\n│   └── models.json\n└── sessions/\n    └── <sessionId>.jsonl"
      },
      {
        "title": "多 Agent 路由",
        "body": "OpenClaw 支持为不同任务创建隔离的 Agent 会话：\n\n// ~/.openclaw/openclaw.json\n{\n  agents: {\n    defaults: {\n      workspace: \"~/.openclaw/workspace\",\n      model: \"anthropic/claude-sonnet-4-5-20250929\",\n      timeoutSeconds: 600,\n    },\n    // 多 Agent 配置\n    entries: {\n      \"finance\": {\n        workspace: \"~/openclaw-workspaces/finance\",\n        model: \"anthropic/claude-sonnet-4-5-20250929\",\n      },\n      \"supervisor\": {\n        workspace: \"~/openclaw-workspaces/supervisor\",\n        model: \"anthropic/claude-opus-4-5-20250929\",\n      },\n    },\n  },\n}"
      },
      {
        "title": "会话存储",
        "body": "会话历史以 JSONL 格式存储：\n\n~/.openclaw/agents/<agentId>/sessions/<sessionId>.jsonl"
      },
      {
        "title": "会话工具",
        "body": "# 列出所有会话\nopenclaw sessions list\n\n# 查看会话历史\nopenclaw sessions history <sessionId>\n\n# 创建新会话\nopenclaw sessions new --agent <agent-name>\n\n# 删除会话\nopenclaw sessions delete <sessionId>"
      },
      {
        "title": "技能加载顺序",
        "body": "工作空间技能 (<workspace>/skills) - 最高优先级\n本地技能 (~/.openclaw/skills)\n捆绑技能 (安装包自带) - 最低优先级"
      },
      {
        "title": "技能配置",
        "body": "// ~/.openclaw/openclaw.json\n{\n  skills: {\n    entries: {\n      \"skill-name\": {\n        enabled: true,\n        apiKey: \"YOUR_API_KEY\",\n        env: {\n          \"API_KEY\": \"value\",\n        },\n        config: {\n          \"customSetting\": \"value\",\n        },\n      },\n    },\n    load: {\n      watch: true,        // 自动刷新技能\n      watchDebounceMs: 250,\n    },\n  },\n}"
      },
      {
        "title": "创建自定义技能",
        "body": "mkdir -p ~/.openclaw/skills/<skill-name>\ntouch ~/.openclaw/skills/<skill-name>/SKILL.md\n\nSKILL.md 格式：\n\n---\nname: skill-name\ndescription: 使用当...（具体触发条件）\nmetadata:\n  {\n    \"openclaw\": {\n      \"requires\": { \"bins\": [\"uv\"], \"env\": [\"API_KEY\"] },\n    },\n  }\n---\n\n# Skill Name\n\n## 概述\n核心原则简述\n\n## 何时使用\n- 触发条件 1\n- 触发条件 2\n\n## 快速参考\n| 场景 | 操作 |\n|------|------|\n| 情况 A | 执行 X |\n\n## 示例\n代码示例或工作流程"
      },
      {
        "title": "Agent Loop 流程",
        "body": "OpenClaw Agent 执行循环：\n\n1. 接收消息 → 2. 加载会话 → 3. 组装上下文 → \n4. 构建 Prompt → 5. 模型推理 → 6. 执行工具 → \n7. 流式响应 → 8. 持久化会话"
      },
      {
        "title": "Hook 点",
        "body": "{\n  hooks: {\n    // Agent 生命周期\n    \"agent:bootstrap\": [\"script.sh\"],\n    \"agent_end\": [\"script.sh\"],\n    \n    // 工具执行\n    \"before_tool_call\": [\"script.sh\"],\n    \"after_tool_call\": [\"script.sh\"],\n    \n    // 消息处理\n    \"message_received\": [\"script.sh\"],\n    \"message_sending\": [\"script.sh\"],\n  },\n}"
      },
      {
        "title": "配置模型",
        "body": "# 为 Agent 配置模型\nopenclaw agents config <agent-name> --model <provider>/<model>\n\n# 可用模型\nopenclaw models list"
      },
      {
        "title": "模型故障转移",
        "body": "{\n  agents: {\n    defaults: {\n      models: [\n        \"anthropic/claude-sonnet-4-5-20250929\",\n        \"openai/gpt-4o\",\n        \"openrouter/anthropic/claude-3.5-sonnet\",\n      ],\n    },\n  },\n}"
      },
      {
        "title": "启用沙箱",
        "body": "{\n  agents: {\n    defaults: {\n      sandbox: {\n        enabled: true,\n        docker: {\n          image: \"node:22-alpine\",\n          setupCommand: \"apk add --no-cache git python3\",\n        },\n        workspaceRoot: \"~/.openclaw/sandboxes\",\n      },\n    },\n  },\n}"
      },
      {
        "title": "沙箱技能要求",
        "body": "技能需要在沙箱内外都存在：\n\n主机：检查二进制文件\n沙箱：通过 setupCommand 安装依赖"
      },
      {
        "title": "每日记忆",
        "body": "mkdir -p ~/.openclaw/workspace/memory\ntouch ~/.openclaw/workspace/memory/$(date +%Y-%m-%d).md"
      },
      {
        "title": "长期记忆",
        "body": "MEMORY.md 仅在主会话加载，用于存储：\n\n重要决策\n用户偏好\n项目上下文\n学习总结"
      },
      {
        "title": "记忆升级",
        "body": "当学习具有广泛适用性时，升级到相应文件：\n\n学习类型升级到行为模式SOUL.md工作流改进AGENTS.md工具技巧TOOLS.md"
      },
      {
        "title": "配置心跳",
        "body": "{\n  agents: {\n    defaults: {\n      heartbeat: {\n        enabled: true,\n        intervalMinutes: 30,\n        prompt: \"HEARTBEAT.md\",\n      },\n    },\n  },\n}"
      },
      {
        "title": "心跳检查清单",
        "body": "创建 HEARTBEAT.md：\n\n# 心跳检查\n\n- [ ] 检查紧急邮件\n- [ ] 查看 24 小时内日历事件\n- [ ] 检查天气（如有外出计划）\n- [ ] 无重要事项回复 HEARTBEAT_OK"
      },
      {
        "title": "Agent 无法启动",
        "body": "检查工作空间是否存在\n验证 openclaw.json 配置\n查看日志：openclaw logs"
      },
      {
        "title": "技能未加载",
        "body": "检查技能名称匹配\n验证 enabled: true\n确认环境变量/二进制文件存在"
      },
      {
        "title": "会话历史丢失",
        "body": "检查 agents/<agentId>/sessions/ 目录\n验证 JSONL 文件格式\n确认 Agent ID 正确"
      },
      {
        "title": "最佳实践",
        "body": "为专用任务创建独立 Agent - 财务、监控、开发等\n使用工作空间技能覆盖捆绑技能 - 自定义行为\n定期清理会话历史 - 避免存储膨胀\n记录学习日志 - 使用 .learnings/ 目录\n配置心跳主动检查 - 而非被动响应\n使用沙箱运行不受信代码 - 安全第一"
      },
      {
        "title": "配置请求（交互式）",
        "body": "创建新 Agent 前，向用户请求以下信息："
      },
      {
        "title": "必填项",
        "body": "1. Agent 名称/ID（用于标识，如：finance, supervisor, dev）\n2. 工作空间路径（默认：~/openclaw-workspaces/<name>）\n3. 使用场景（如：财务管理、代码开发、群组机器人）"
      },
      {
        "title": "可选项（根据场景询问）",
        "body": "4. 是否需要绑定特定频道/群组？\n   → 是：询问频道类型 (feishu/whatsapp/telegram) 和 ID\n   \n5. 是否需要多 Agent 路由？\n   → 是：询问 bindings 配置\n   \n6. 是否需要安全沙箱？\n   → 是：配置 sandbox.mode: \"all\"\n   \n7. 是否需要限制工具权限？\n   → 是：配置 tools.allow/deny\n   \n8. 多人使用同一个聊天账号？\n   → 是：配置 dmScope: \"per-channel-peer\"\n   \n9. 同一用户需要跨频道共享会话？\n   → 是：配置 identityLinks"
      },
      {
        "title": "请求模板",
        "body": "**创建 Agent 配置请求**\n\n请提供以下信息：\n\n**必填：**\n- Agent 名称：[用于标识，如 finance/supervisor]\n- 用途：[简要描述，如\"财务管理\"或\"飞书群组机器人\"]\n\n**可选：**\n- [ ] 需要绑定特定飞书群/用户\n- [ ] 需要多 Agent 路由（多个聊天账号）\n- [ ] 需要安全沙箱隔离\n- [ ] 需要限制工具权限\n- [ ] 多人共用聊天账号（需要 dmScope 隔离）\n\n请回复或逐项提供，我将生成完整配置。"
      },
      {
        "title": "部署检查清单",
        "body": "创建新 Agent 后验证：\n\n工作空间目录存在\n Bootstrap 文件已创建\n Agent 配置已注册\n 模型配置正确\n 技能已加载\n 会话可以创建\n 工具可以执行\n\n参考文档：\n\nOpenClaw Docs\nAgent Runtime\nSkills\nWorkspace"
      }
    ],
    "body": "OpenClaw Agent Builder\n\n为 OpenClaw 创建和配置 AI Agent 的完整指南。OpenClaw 使用基于工作空间的 Agent 架构，每个 Agent 拥有独立的会话、配置和上下文文件。\n\n核心架构\n~/.openclaw/\n├── openclaw.json          # 主配置文件\n├── agents/                # Agent 会话存储\n│   ├── <agentId>/\n│   │   ├── agent/         # Agent 配置\n│   │   └── sessions/      # 会话历史 (JSONL)\n│   └── main/              # 默认主 Agent\n├── workspace/             # 主工作空间\n│   ├── AGENTS.md          # 工作流指令\n│   ├── SOUL.md            # 角色人格定义\n│   ├── TOOLS.md           # 工具使用说明\n│   ├── USER.md            # 用户配置\n│   ├── MEMORY.md          # 长期记忆 (仅主会话)\n│   ├── memory/            # 每日记忆文件\n│   └── .learnings/        # 学习日志\n└── skills/                # 技能目录\n\n何时使用\n场景\t方案\n需要专用 Agent 处理特定领域任务\t创建新 Agent\n需要隔离会话历史\t使用多 Agent 路由\n不同任务需要不同模型/工具配置\t配置 Agent 专属设置\n团队协作需要独立上下文\t创建团队 Agent\n多人共用 Gateway 但需要私密对话\t配置 dmScope: per-channel-peer\n同一用户跨频道保持会话连续\t配置 identityLinks\n飞书/钉钉群需要绑定特定 Agent\t配置 bindings + requireMention\n可选机制选择器\n\n不是每个 Agent 都需要以下所有机制。根据实际需求选择：\n\n机制\t使用时机\t配置位置\nBindings\t需要精确控制消息路由到哪个 Agent\tbindings[]\ndmScope\t多人使用同一个聊天账号，需要隔离私密对话\tsession.dmScope\nidentityLinks\t同一用户在多个频道联系你，希望共享会话\tsession.identityLinks\nsendPolicy\t阻止某些会话类型的消息发送（如 cron 任务不回复）\tsession.sendPolicy\nsession.maintenance\t高频率会话，需要自动清理过期会话\tsession.maintenance\nthreadBindings\tDiscord/Slack 线程需要独立会话\tsession.threadBindings\nsandbox\t运行不受信代码或需要安全隔离\tagents[].sandbox\ntools allow/deny\t限制 Agent 可使用的工具（如家庭 Agent 不允许写文件）\tagents[].tools\nFeishu 群绑定\t飞书特定群组需要特定 Agent 响应\tchannels.feishu.groups\n机制配置示例\n1. Bindings - 消息路由\n{\n  agents: {\n    list: [\n      { id: \"home\", workspace: \"~/.openclaw/workspace-home\" },\n      { id: \"work\", workspace: \"~/.openclaw/workspace-work\" },\n    ],\n  },\n  bindings: [\n    // 飞书特定用户 → work Agent\n    { agentId: \"work\", match: { channel: \"feishu\", peer: { kind: \"direct\", id: \"ou_xxx\" } } },\n    // 飞书特定群组 → work Agent\n    { agentId: \"work\", match: { channel: \"feishu\", peer: { kind: \"group\", id: \"oc_xxx\" } } },\n    // WhatsApp 默认 → home Agent\n    { agentId: \"home\", match: { channel: \"whatsapp\" } },\n  ],\n}\n\n2. dmScope - DM 会话隔离\n{\n  session: {\n    // 多人共用一个 WhatsApp 号，每人独立会话\n    dmScope: \"per-channel-peer\",\n    // 同一用户跨频道合并会话\n    identityLinks: {\n      alice: [\"telegram:123456789\", \"feishu:ou_xxx\"],\n    },\n  },\n}\n\n3. 飞书群组配置\n{\n  channels: {\n    feishu: {\n      dmPolicy: \"pairing\",\n      groupPolicy: \"allowlist\",\n      groupAllowFrom: [\"oc_group1\", \"oc_group2\"],\n      groups: {\n        \"oc_group1\": {\n          requireMention: true,  // 需要 @机器人\n          allowFrom: [\"ou_user1\", \"ou_user2\"],  // 允许控制命令的用户\n        },\n      },\n    },\n  },\n}\n\n4. Agent 工具限制\n{\n  agents: {\n    list: [\n      {\n        id: \"family\",\n        workspace: \"~/.openclaw/workspace-family\",\n        sandbox: { mode: \"all\", scope: \"agent\" },\n        tools: {\n          allow: [\"read\", \"exec\"],\n          deny: [\"write\", \"edit\", \"apply_patch\", \"browser\"],\n        },\n      },\n    ],\n  },\n}\n\n5. 会话维护\n{\n  session: {\n    maintenance: {\n      mode: \"enforce\",\n      pruneAfter: \"30d\",       // 30 天后清理\n      maxEntries: 500,         // 最多 500 个会话\n      rotateBytes: \"10mb\",     // sessions.json 超过 10MB 时轮转\n    },\n  },\n}\n\n快速参考\n创建新 Agent 流程\n\n创建工作空间\n\nmkdir -p ~/openclaw-workspaces/<agent-name>\ncd ~/openclaw-workspaces/<agent-name>\nopenclaw setup --workspace .\n\n\n创建 Bootstrap 文件\n\n# 必需文件\ntouch AGENTS.md SOUL.md TOOLS.md USER.md\n# 可选：初次运行引导\ntouch BOOTSTRAP.md\n\n\n注册 Agent\n\nopenclaw agents create <agent-name> --workspace ~/openclaw-workspaces/<agent-name>\n\n\n配置模型\n\nopenclaw agents config <agent-name> --model anthropic/claude-sonnet-4-5-20250929\n\n核心配置文件\nAGENTS.md - 工作流指令\n\n定义 Agent 的行为规范、工作流程和自动化规则。\n\n# 你的工作空间\n\n## 每次会话前\n1. 阅读 SOUL.md — 你是谁\n2. 阅读 USER.md — 你帮助谁\n3. 阅读 memory/YYYY-MM-DD.md — 最近上下文\n\n## 安全规则\n- 不泄露私密数据\n- 破坏性操作前必须询问\n- 使用 `trash` 而非 `rm`\n\n## 工具使用\n- 检查技能的 SKILL.md\n- 本地配置写在 TOOLS.md\n\nSOUL.md - 角色人格\n\n定义 Agent 的身份、语气、边界和原则。\n\n# 你的身份\n\n## 你是谁\n- 名称：[Agent 名称]\n- 角色：[专业领域]\n- 语气：[专业/友好/简洁]\n\n## 原则\n- 主动但不打扰\n- 准确优于快速\n- 不确定时询问\n\nTOOLS.md - 工具说明\n\n记录工具的使用细节、集成要点和本地配置。\n\n# 工具配置\n\n## 本地工具\n- 浏览器：`browser.enabled: true`\n- 沙箱：`sandbox.enabled: false`\n\n## 集成细节\n- 数据库连接字符串\n- API 端点配置\n- 认证凭据位置\n\nUSER.md - 用户配置\n\n定义用户偏好、联系方式和特殊需求。\n\n# 用户信息\n\n## 联系方式\n- 首选频道：WhatsApp / Telegram / Discord\n- 时区：Asia/Shanghai\n- 语言：中文\n\n## 偏好\n- 回复风格：简洁/详细\n- 主动检查：每日 2-4 次\n\nAgent 目录结构\n主 Agent (main)\n~/.openclaw/agents/main/\n├── agent/\n│   ├── auth.json          # 认证令牌\n│   └── models.json        # 模型配置\n└── sessions/\n    └── <sessionId>.jsonl  # 会话历史\n\n专用 Agent\n~/.openclaw/agents/<agent-id>/\n├── agent/\n│   ├── auth.json\n│   └── models.json\n└── sessions/\n    └── <sessionId>.jsonl\n\n多 Agent 路由\n\nOpenClaw 支持为不同任务创建隔离的 Agent 会话：\n\n// ~/.openclaw/openclaw.json\n{\n  agents: {\n    defaults: {\n      workspace: \"~/.openclaw/workspace\",\n      model: \"anthropic/claude-sonnet-4-5-20250929\",\n      timeoutSeconds: 600,\n    },\n    // 多 Agent 配置\n    entries: {\n      \"finance\": {\n        workspace: \"~/openclaw-workspaces/finance\",\n        model: \"anthropic/claude-sonnet-4-5-20250929\",\n      },\n      \"supervisor\": {\n        workspace: \"~/openclaw-workspaces/supervisor\",\n        model: \"anthropic/claude-opus-4-5-20250929\",\n      },\n    },\n  },\n}\n\n会话管理\n会话存储\n\n会话历史以 JSONL 格式存储：\n\n~/.openclaw/agents/<agentId>/sessions/<sessionId>.jsonl\n\n会话工具\n# 列出所有会话\nopenclaw sessions list\n\n# 查看会话历史\nopenclaw sessions history <sessionId>\n\n# 创建新会话\nopenclaw sessions new --agent <agent-name>\n\n# 删除会话\nopenclaw sessions delete <sessionId>\n\n技能系统\n技能加载顺序\n工作空间技能 (<workspace>/skills) - 最高优先级\n本地技能 (~/.openclaw/skills)\n捆绑技能 (安装包自带) - 最低优先级\n技能配置\n// ~/.openclaw/openclaw.json\n{\n  skills: {\n    entries: {\n      \"skill-name\": {\n        enabled: true,\n        apiKey: \"YOUR_API_KEY\",\n        env: {\n          \"API_KEY\": \"value\",\n        },\n        config: {\n          \"customSetting\": \"value\",\n        },\n      },\n    },\n    load: {\n      watch: true,        // 自动刷新技能\n      watchDebounceMs: 250,\n    },\n  },\n}\n\n创建自定义技能\nmkdir -p ~/.openclaw/skills/<skill-name>\ntouch ~/.openclaw/skills/<skill-name>/SKILL.md\n\n\nSKILL.md 格式：\n\n---\nname: skill-name\ndescription: 使用当...（具体触发条件）\nmetadata:\n  {\n    \"openclaw\": {\n      \"requires\": { \"bins\": [\"uv\"], \"env\": [\"API_KEY\"] },\n    },\n  }\n---\n\n# Skill Name\n\n## 概述\n核心原则简述\n\n## 何时使用\n- 触发条件 1\n- 触发条件 2\n\n## 快速参考\n| 场景 | 操作 |\n|------|------|\n| 情况 A | 执行 X |\n\n## 示例\n代码示例或工作流程\n\nAgent Loop 流程\n\nOpenClaw Agent 执行循环：\n\n1. 接收消息 → 2. 加载会话 → 3. 组装上下文 → \n4. 构建 Prompt → 5. 模型推理 → 6. 执行工具 → \n7. 流式响应 → 8. 持久化会话\n\nHook 点\n{\n  hooks: {\n    // Agent 生命周期\n    \"agent:bootstrap\": [\"script.sh\"],\n    \"agent_end\": [\"script.sh\"],\n    \n    // 工具执行\n    \"before_tool_call\": [\"script.sh\"],\n    \"after_tool_call\": [\"script.sh\"],\n    \n    // 消息处理\n    \"message_received\": [\"script.sh\"],\n    \"message_sending\": [\"script.sh\"],\n  },\n}\n\n模型配置\n配置模型\n# 为 Agent 配置模型\nopenclaw agents config <agent-name> --model <provider>/<model>\n\n# 可用模型\nopenclaw models list\n\n模型故障转移\n{\n  agents: {\n    defaults: {\n      models: [\n        \"anthropic/claude-sonnet-4-5-20250929\",\n        \"openai/gpt-4o\",\n        \"openrouter/anthropic/claude-3.5-sonnet\",\n      ],\n    },\n  },\n}\n\n沙箱模式\n启用沙箱\n{\n  agents: {\n    defaults: {\n      sandbox: {\n        enabled: true,\n        docker: {\n          image: \"node:22-alpine\",\n          setupCommand: \"apk add --no-cache git python3\",\n        },\n        workspaceRoot: \"~/.openclaw/sandboxes\",\n      },\n    },\n  },\n}\n\n沙箱技能要求\n\n技能需要在沙箱内外都存在：\n\n主机：检查二进制文件\n沙箱：通过 setupCommand 安装依赖\n记忆系统\n每日记忆\nmkdir -p ~/.openclaw/workspace/memory\ntouch ~/.openclaw/workspace/memory/$(date +%Y-%m-%d).md\n\n长期记忆\n\nMEMORY.md 仅在主会话加载，用于存储：\n\n重要决策\n用户偏好\n项目上下文\n学习总结\n记忆升级\n\n当学习具有广泛适用性时，升级到相应文件：\n\n学习类型\t升级到\n行为模式\tSOUL.md\n工作流改进\tAGENTS.md\n工具技巧\tTOOLS.md\n心跳机制\n配置心跳\n{\n  agents: {\n    defaults: {\n      heartbeat: {\n        enabled: true,\n        intervalMinutes: 30,\n        prompt: \"HEARTBEAT.md\",\n      },\n    },\n  },\n}\n\n心跳检查清单\n\n创建 HEARTBEAT.md：\n\n# 心跳检查\n\n- [ ] 检查紧急邮件\n- [ ] 查看 24 小时内日历事件\n- [ ] 检查天气（如有外出计划）\n- [ ] 无重要事项回复 HEARTBEAT_OK\n\n常见问题\nAgent 无法启动\n检查工作空间是否存在\n验证 openclaw.json 配置\n查看日志：openclaw logs\n技能未加载\n检查技能名称匹配\n验证 enabled: true\n确认环境变量/二进制文件存在\n会话历史丢失\n检查 agents/<agentId>/sessions/ 目录\n验证 JSONL 文件格式\n确认 Agent ID 正确\n最佳实践\n为专用任务创建独立 Agent - 财务、监控、开发等\n使用工作空间技能覆盖捆绑技能 - 自定义行为\n定期清理会话历史 - 避免存储膨胀\n记录学习日志 - 使用 .learnings/ 目录\n配置心跳主动检查 - 而非被动响应\n使用沙箱运行不受信代码 - 安全第一\n配置请求（交互式）\n\n创建新 Agent 前，向用户请求以下信息：\n\n必填项\n1. Agent 名称/ID（用于标识，如：finance, supervisor, dev）\n2. 工作空间路径（默认：~/openclaw-workspaces/<name>）\n3. 使用场景（如：财务管理、代码开发、群组机器人）\n\n可选项（根据场景询问）\n4. 是否需要绑定特定频道/群组？\n   → 是：询问频道类型 (feishu/whatsapp/telegram) 和 ID\n   \n5. 是否需要多 Agent 路由？\n   → 是：询问 bindings 配置\n   \n6. 是否需要安全沙箱？\n   → 是：配置 sandbox.mode: \"all\"\n   \n7. 是否需要限制工具权限？\n   → 是：配置 tools.allow/deny\n   \n8. 多人使用同一个聊天账号？\n   → 是：配置 dmScope: \"per-channel-peer\"\n   \n9. 同一用户需要跨频道共享会话？\n   → 是：配置 identityLinks\n\n请求模板\n**创建 Agent 配置请求**\n\n请提供以下信息：\n\n**必填：**\n- Agent 名称：[用于标识，如 finance/supervisor]\n- 用途：[简要描述，如\"财务管理\"或\"飞书群组机器人\"]\n\n**可选：**\n- [ ] 需要绑定特定飞书群/用户\n- [ ] 需要多 Agent 路由（多个聊天账号）\n- [ ] 需要安全沙箱隔离\n- [ ] 需要限制工具权限\n- [ ] 多人共用聊天账号（需要 dmScope 隔离）\n\n请回复或逐项提供，我将生成完整配置。\n\n部署检查清单\n\n创建新 Agent 后验证：\n\n 工作空间目录存在\n Bootstrap 文件已创建\n Agent 配置已注册\n 模型配置正确\n 技能已加载\n 会话可以创建\n 工具可以执行\n\n参考文档：\n\nOpenClaw Docs\nAgent Runtime\nSkills\nWorkspace"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/a12591771/openclaw-agent-builder",
    "publisherUrl": "https://clawhub.ai/a12591771/openclaw-agent-builder",
    "owner": "a12591771",
    "version": "0.1.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/openclaw-agent-builder",
    "downloadUrl": "https://openagent3.xyz/downloads/openclaw-agent-builder",
    "agentUrl": "https://openagent3.xyz/skills/openclaw-agent-builder/agent",
    "manifestUrl": "https://openagent3.xyz/skills/openclaw-agent-builder/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/openclaw-agent-builder/agent.md"
  }
}