spacesuit

🦺 OpenClaw安全优先工作区框架

🥥7总安装量 2评分人数 2
100% 的用户推荐

OpenClaw官方工作区框架脚手架,提供安全优先的会话协议、Git工作流、记忆系统和跨平台协作规范,帮助团队建立标准化的AI Agent工作环境。

A

基本安全,请在特定环境下使用

  • 来自社区或个人来源,建议先隔离验证
  • ✅ 无危险函数(eval/exec/system/subprocess),无代码注入漏洞
  • ✅ 完善的输入验证与错误处理,所有脚本使用 `set -euo pipefail` 安全模式
  • ✅ 临时文件使用 mktemp 创建并通过 trap 正确清理,关键操作有 dry-run 和备份机制
  • ✅ 无静默数据收集或网络外传行为,数据仅本地处理
  • ⚠️ T3 来源(个人开发者项目),建议代码审计后用于生产环境
  • ⚠️ 脚本操作工作区文件,建议升级前备份重要数据

使用说明

核心用法

Spacesuit 是专为 OpenClaw 工作区设计的框架层脚手架工具,采用"电池全包"设计理念。用户通过 make init 首次安装,或 make upgrade 升级现有工作区。其核心机制是标记保护式合并:框架内容包裹在 <!-- SPACESUIT:BEGIN --> / <!-- SPACESUIT:END --> 标记内,升级时仅替换标记区域,用户自定义内容完全保留。

框架生成 8 个核心文件:AGENTS.md(会话协议与工具配置)、SOUL.md(人格脚手架)、TOOLS.md(工具组织)、HEARTBEAT.md(状态检查框架)、IDENTITY.md/USER.md(身份模板)、MEMORY.md(长期记忆结构)、SECURITY.md(安全基线)。每个文件都区分"框架提供的基础内容"和"用户自定义区域"。

显著优点

安全优先设计:内置 pre-action 检查清单、破坏性操作保护、stand-down 协议、secret 传输策略、prompt 注入防御和数据分级制度,将安全内建于工作流而非事后补救。

工程化规范:强制 pre-commit 检查、worktree 约定、并行 Agent 协调、P0-P5 任务分级、决策审计日志,将软件工程最佳实践引入 AI 协作场景。

跨平台无缝衔接:结构化上下文传输协议支持 Slack/Discord/Telegram 之间的 Agent 状态迁移,解决多平台协作的上下文丢失痛点。

元认知框架:内置 Dunning-Kruger aware 的专家优先研究方法论,帮助 Agent 避免过度自信,提升复杂任务的处理质量。

升级安全:dry-run 模式预览变更、差异对比脚本、标记保护机制三重保障,确保迭代过程中用户数据零丢失。

潜在缺点与局限性

平台锁定:专为 OpenClaw 设计,非 OpenClaw 环境无法使用,生态迁移成本较高。

学习曲线陡峭:涵盖会话协议、Git 工作流、安全基线、优先级系统等十余个子系统,团队需要投入时间理解并内化这些约定。

个人来源风险:作者为个人开发者 jontsai,虽代码质量优秀,但长期维护承诺、社区支持规模与企业级项目存在差距。

可选依赖问题:sync-operators.sh 依赖 jq 工具,虽做了存在性检查,但在精简环境中可能功能受限。

无图形界面:纯命令行和 Markdown 驱动,对非技术背景用户不够友好。

适合的目标群体

  • OpenClaw 重度用户:需要规范化、可复现的 Agent 工作环境的个人或团队
  • AI-Native 团队:将 AI Agent 作为核心生产工具,需要工程化协作规范的初创公司
  • 多平台协作者:在 Slack、Discord、Telegram 之间频繁切换,需要上下文无缝迁移的用户
  • 安全敏感场景:处理机密数据、需要审计追踪和合规要求的金融、法律、医疗领域
  • 技术管理者:希望建立团队级 Agent 配置标准,降低成员间协作摩擦的 Tech Lead

使用风险

数据覆盖风险:虽升级机制有标记保护,但若用户误将自定义内容写在标记区域内,仍会被覆盖。建议升级前运行 ./scripts/diff.sh 或使用 --dry-run 预览。

依赖可用性:项目处于早期阶段(v0.3.0),API 和文件结构可能随版本变化,需要关注升级日志。

权限管理:脚本需要对工作区文件进行读写操作,在共享服务器或多用户环境中需正确设置文件权限。

备份建议:尽管有保护机制,重要配置文件仍建议纳入常规备份策略,防范极端情况。

spacesuit 内容

文件夹图标base文件夹
文件夹图标scripts文件夹
文件夹图标templates文件夹
文件夹图标tests文件夹
手动下载zip · 40.8 kB
AGENTS.mdtext/markdown
请选择文件