核心用法
agent-init 是一个专为 OpenClaw 生态设计的智能体工作空间初始化技能。它通过强制性的多轮交互式访谈收集用户需求，自动生成标准化的 Markdown 配置文件（IDENTITY.md、SOUL.md、AGENTS.md、TOOLS.md、USER.md、HEARTBEAT.md、BOOTSTRAP.md），构建完整的 Agent 个性化档案。
标准工作流程：
1. Phase 1 访谈（不可跳过）：分批询问 2-3 个问题，涵盖身份定位、用户画像、环境配置、行为边界四个维度
2. Phase 2 环境检查：运行 check-env.sh 检测 Python/uv 环境状态
3. Phase 3 文件生成：按固定顺序生成 7 类配置文件，每份文件需用户确认后再写入
4. Phase 4 差异化写入：根据容器实例或外部实例类型选择对应的写入方式
5. Phase 5 验证：确认文件已正确落地
关键技术特性：
- 强制使用
uv作为 Python 包管理器（禁止直接使用 pip） - AGENTS.md 采用"扩展而非替换"策略，保留默认基础设施模板
- 支持 Docker 容器内执行与主机文件系统两种部署模式
显著优点
1. 结构化配置体系：将 Agent 配置拆解为 7 个正交文件，职责分离清晰（身份、灵魂、工具、用户、代理、心跳、启动），避免单文件臃肿
2. 用户中心设计：强制访谈机制确保生成配置高度贴合实际需求，避免"一刀切"模板
3. 环境感知能力：自动检测 Python/uv 环境，提供一键修复脚本，降低环境配置门槛
4. 容器原生支持：区分容器实例与外部实例的差异化写入策略，适配云原生部署场景
5. 安全设计意识：明确禁止在配置文件中硬编码密钥（文件内容会被注入每轮对话），符合安全最佳实践
潜在缺点与局限性
1. 远程代码执行风险：check-env.sh 使用 curl -LsSf https://astral.sh/uv/install.sh | sh 模式安装 uv，属于典型的"curl pipe bash"供应链攻击面。若 astral.sh 被入侵或 DNS 劫持，恶意代码将直接执行
2. T3 来源可信度：发布者为 GitHub 个人账号 szsip239，非知名组织或基金会，代码更新缺乏第三方审计机制
3. Docker 权限隐患：建议用户使用 docker exec 操作容器，若 Docker 以 root 运行可能导致权限提升
4. 令牌消耗压力：明确提醒"所有工作区文件每轮消耗 token"（单文件 20KB 限制，总计 150KB），复杂配置可能导致上下文成本激增
5. 功能边界模糊：访谈问题设计较开放，对新手用户可能产生引导负担；缺乏预设模板快速通道
适合的目标群体
- OpenClaw 生态用户：正在使用或计划使用 OpenClaw 框架的开发者与团队
- AI Agent 架构师：需要为不同场景快速构建个性化 Agent 配置的技术负责人
- DevOps/平台工程师：需要在容器环境中批量部署和标准化 Agent 工作空间的运维人员
- 进阶终端用户：理解 Agent 配置原理、愿意投入时间进行深度定制的技术爱好者
不适合：追求一键开箱即用的纯业务用户、对供应链安全极度敏感的金融/政府场景
使用风险与注意事项
| 风险类别 | 具体表现 | 缓释建议 |
|---------|---------|---------|
| **供应链攻击** | curl\|sh 模式执行远程脚本 | 手动下载安装脚本并校验 SHA256；改用 pip/brew 安装 uv |
| **权限提升** | Docker root 执行、PATH 修改 | 使用非 root Docker 运行；安装前审查脚本内容 |
| **来源可信度** | T3 个人开发者，更新不可控 | 隔离环境先行测试；订阅更新通知；审查代码变更 |
| **性能瓶颈** | 大配置文件消耗对话 token | 保持文件精简；定期清理非活跃配置 |
| **配置漂移** | 多文件手动维护易出错 | 版本控制配置文件；建立配置变更 review 流程 |
关键操作建议：执行 --install 前务必查看 check-env.sh 脚本内容，确认 astral.sh 域名正确性；生产环境建议禁用自动安装，采用预构建镜像方式部署。