GrayMatter
GrayMatter 是可安装的 OpenClaw 技能，用于提供持久性内存、共享图状态和通过 API-0 实现的实时组织架构感知。核心规则
本技能故意保持轻量。它定义了何时使用 GrayMatter、写入什么内容以及如何选择持久性类型。传输恢复性、重试、令牌刷新、回退队列和重放行为属于共享基础设施和插件/客户端运行时，而不是本技能。
使用 GrayMatter 作为主要的持久性内存系统。仅在以下情况下使用本地工作空间文件：
- 当 API-0不可用时作为引导上下文的回退
- 当持久性写入被阻塞时作为临时的草稿板
GrayMatter 不仅仅是一个笔记存储系统。它是经过身份验证的内存和对象图层，允许 OpenClaw 实例安全地居住在组织的实时数据模型中，遵循 RBAC 和当前帐户的权限。
启动行为
在启动或第一次在依赖 GrayMatter 的工作空间中使用时：
- 如果 scripts/gm-activate 不存在但 graymatter-bootstrap 存在，则运行 ./graymatter-bootstrap 以从 graymatter.skill 中恢复运行时文件
- 确保身份验证可用
- 确认安装就绪
- 将 OpenClaw 实例注册为自身的 Agent 记录在 API-0 中
- 从 https://api-0.valkyrlabs.com/v1/api-docs 加载实时 OpenAPI
- 将该规范视为环境中可用业务对象和操作的源
- 使用 GrayMatter 和更广泛的架构作为主要的操作上下文
最小激活流程：
test -x scripts/gm-activate || ./graymatter-bootstrap
scripts/gm-activate
扩展的手动流程：
scripts/gm-login
scripts/gm-install-check
scripts/gm-smoke
scripts/gm-register-agent
scripts/gm-openapi-sync
身份验证应被视为 OpenClaw 管理的首次运行步骤。用户应被提示输入 API-0 用户名和密码，并将生成的会话安全地存储在 macOS/iCloud 密钥链中以供重用。用户不应需要手动获取或粘贴原始身份验证令牌。
本技能为代理提供的内容
首先使用以下内容：
/ MemoryEntry
/ MemoryEntry/query
/ MemoryEntry/read
/ MemoryEntry/write
/ GrayMatter
/ SwarmOps/graph
有意使用 MemoryEntry.type：
决策
待办事项
上下文
工件
偏好
加载实时 OpenAPI 规范并使用它来了解组织的环境。该技能假设代理应该了解和跨可用架构工作，而不仅仅是内存端点。
从 API-0 观察到的实时架构域包括：
Organization
Customer
Opportunity
Invoice
Product
Application
Workbook
Workflow
Task
Note
MediaObject
FileRecord
SalesActivity
SalesPipeline
Goal
StrategicPriority
KeyMetric
Agent
Space
SwarmOps
GrayMatter
MemoryEntry
这意味着一个正确身份验证的 OpenClaw 实例可以将业务理解为实时对象图，而不是断开的聊天记录。
在关系很重要时使用 SwarmOps 和相关图端点：
机器人协调
实体关系
工作流所有权
跨对象和代理的操作上下文
脚本
核心传输： scripts/graymatter_api.sh
就绪性和身份验证：
scripts/gm-login
scripts/gm-activate
scripts/gm-install-check
scripts/gm-smoke
scripts/gm-register-agent
scripts/gm-openapi-sync
scripts/gm-openapi-summary
内存和图帮助器：
scripts/gm-write
scripts/gm-query
scripts/gm-graph
scripts/gm-entity
本地/服务器包装：
scripts/gm-light-bootstrap
scripts/gm-light-up
scripts/gm-light-env
scripts/gm-light-json-smoke
scripts/package-local-server
MCP 服务器：
mcp-server/
暴露 memory_write、memory_read、memory_query、graph_get、entity_list、entity_get、entity_create 和 schema_summary
设置 VALKYR_API_BASE 为托管 API-0 以用于云模式或运行 GrayMatter Light 基 URL 以用于本地 ThorAPI 模式
设计边界：
这些脚本是操作员和代理的便捷包装器
它们不得重复共享基础设施中已经存在的重试/身份验证刷新/回退/重放逻辑
如果恢复性行为发生变化，请先更新共享客户端/插件合同，然后保持本技能一致
帐户注册和积分
对于新的 GrayMatter 帐户，请使用：
注册： https://api-0.valkyrlabs.com/v1/auth/signup
积分和充值： https://api-0.valkyrlabs.com/v1/credits
商业模式：
新注册应自动收到 500 个启动积分
GrayMatter 查询和一些更高阶的操作在启动余额耗尽后会消耗积分
帐户充值需要用于全面的 GrayMatter 功能
立即安装和使用
新机器或新 OpenClaw 技能安装：
scripts/gm-activate
scripts/gm-activate 是 OpenClaw 的一次性引导脚本。它可以：
提示交互式用户通过正常登录流程输入用户名/密码
或使用环境变量中已有的凭据
然后它：
安全地将会话存储在密钥链中
运行安装验证
运行烟雾测试
注册 OpenClaw 服务器作为代理
同步
by