grix-connector 1.0.2

package/openclaw-plugin/skills/grix-admin/SKILL.md

@@ -0,0 +1,202 @@
+---
+name: grix-admin
+description: 负责 OpenClaw 本地配置、绑定与运行态收口；可通过当前 agent 的 WS 通道创建新的远端 API agent，并支持查询、创建、修改 agent 分类和给 agent 挂分类，供创建和管理 agent 流程复用。
+---
+
+# Grix Agent Admin
+
+`grix-admin` 负责三件事：
+
+1. 把已有远端 agent 参数落到本地 OpenClaw，并负责绑定后的运行态收口。
+2. 当当前主 agent 已经在线、并且具备对应 scope 时，通过 `grix_admin` 的直连动作创建新的远端 API agent，再继续本地落地。
+3. 在创建 agent 或后续管理 agent 时，复用 `grix_admin` 的直连动作查询分类、创建分类、修改分类、给 agent 挂分类。
+
+## 进入方式
+
+1. 大多数情况下，从 `grix_admin` 的 `task` 入口进入本技能；`task` 第一行必须明确写出 `bind-local`、`create-and-bind` 或 `category-manage`。
+2. 只有在本技能内部执行“远端 API agent 创建 / 分类查询 / 分类创建 / 分类修改 / 分类挂载”这些远端步骤时，才直接调用一次 `grix_admin`，并且不要再传 `task`。
+3. 新流程里，直接调用 `grix_admin` 时一律显式传 `action`：
+   - `create_agent`
+   - `list_categories`
+   - `create_category`
+   - `update_category`
+   - `assign_category`
+4. `create_agent` 的旧直连写法（只传 `agentName` 等字段，不传 `action`）仍可兼容，但新流程不要再使用。
+
+## 直连动作清单
+
+1. `action=create_agent`
+   - 必填：`agentName`
+   - 可选：`introduction`、`isMain`、`categoryId`、`categoryName`、`parentCategoryId`、`categorySortOrder`
+   - `categoryId` 和 `categoryName` 不能同时提供
+   - 给 `categoryName` 时，会先按 `parentCategoryId` 查重；找不到再创建并挂载
+2. `action=list_categories`
+   - 必填：（无）
+3. `action=create_category`
+   - 必填：`name`、`parentId`
+   - 可选：`sortOrder`
+4. `action=update_category`
+   - 必填：`categoryId`、`name`、`parentId`
+   - 可选：`sortOrder`
+5. `action=assign_category`
+   - 必填：`agentId`、`categoryId`
+   - `categoryId=0` 表示清空分类
+
+## Mode A: bind-local（来自 grix-register 的首次交接）
+
+输入字段（写在 `grix_admin.task` 里，且全必填）：
+
+1. 第一行固定写 `bind-local`
+2. `agent_name`
+3. `agent_id`
+4. `api_endpoint`
+5. `api_key`
+
+执行规则：
+
+1. 不做远端创建，直接执行本地绑定，不要调用任何会直接改 `openclaw.json` 的脚本。
+2. 先准备本地目录：
+   - `workspace=~/.openclaw/workspace-<agent_name>`
+   - `agentDir=~/.openclaw/agents/<agent_name>/agent`
+   - persona 文件只放 `workspace` 根目录：`IDENTITY.md`、`SOUL.md`、`AGENTS.md`，以及可选的 `USER.md` / `MEMORY.md`
+   - 不要把 persona 文件放进 `agentDir`；`agentDir` 是 OpenClaw 管理的每个 agent 运行状态目录
+   - 如果 `workspace` 里缺少必要 persona 文件，补最小文件，避免新 agent 工作区为空
+3. 读取现有配置；若路径不存在，按空对象 / 空数组处理：
+   - `channels.grix.accounts`
+   - `agents.list`
+   - `tools.profile`
+   - `tools.alsoAllow`
+   - `tools.sessions.visibility`
+   - 如需确认已有 Grix 绑定，额外用 `openclaw agents bindings --agent <agent_name> --json` 查看当前绑定列表
+4. 计算本次目标值：
+   - `channels.grix.accounts.<agent_name>`：写入 `name`、`enabled=true`、`apiKey`、`wsUrl`、`agentId`
+   - `agents.list`：确保存在 `id=<agent_name>`、`name=<agent_name>`、`workspace`、`agentDir`、`model`
+   - Grix 绑定：确保目标 agent 最终绑定到 `grix:<agent_name>`
+   - `tools.profile`：设为 `"coding"`
+   - `tools.alsoAllow`：至少包含 `message`、`grix_query`、`grix_group`、`grix_register`、`grix_message_send`、`grix_message_unsend`
+   - 如果当前绑定目标就是主 agent，还要确保该 agent 自己的 `tools.alsoAllow` 保留 `grix_admin`、`grix_egg`、`grix_update`、`openclaw_memory_setup`；这组只放 agent 级别，不要写进全局 `tools.alsoAllow`
+   - `tools.sessions.visibility`：设为 `"agent"`
+   - 如果 `channels.grix.enabled=false`，改回 `true`
+5. `model` 的确定规则：
+   - 先复用该本地 agent 现有条目的 `model`
+   - 如果现有条目没有，再用 `agents.defaults.model.primary`
+   - 如果仍然拿不到，明确说明缺少 model，停止执行，不要瞎猜
+6. 用官方 CLI 逐项写入，不要整份覆盖配置：
+   - `openclaw config set channels.grix.accounts.<agent_name> '<ACCOUNT_JSON>' --strict-json`
+   - `openclaw config set agents.list '<NEXT_AGENTS_LIST_JSON>' --strict-json`
+   - `openclaw agents bind --agent <agent_name> --bind grix:<agent_name>`
+   - `openclaw config set tools.profile '"coding"' --strict-json`
+   - `openclaw config set tools.alsoAllow '["message","grix_query","grix_group","grix_register","grix_message_send","grix_message_unsend"]' --strict-json`
+   - 如果当前绑定目标就是主 agent，还要把 `grix_admin`、`grix_egg`、`grix_update`、`openclaw_memory_setup` 合并进该 agent 自己那条 `agents.list` 记录里的 `tools.alsoAllow`；不要把这组写进全局 `tools.alsoAllow`
+   - `openclaw config set tools.sessions.visibility '"agent"' --strict-json`
+   - 仅当当前配置明确把 `channels.grix.enabled` 关掉时，再执行 `openclaw config set channels.grix.enabled true --strict-json`
+7. 写完后必须执行静态校验：
+   - `openclaw config validate`
+   - `openclaw config get --json channels.grix.accounts.<agent_name>`
+   - `openclaw config get --json agents.list`
+   - `openclaw agents bindings --agent <agent_name> --json`
+8. 如果当前这次调用已经具备真实验证条件，必须立刻做一次真实路由验证；优先复用当前安装/验收上下文，不要新造 probe。以下情况都视为绑定后运行态仍未切换成功：
+   - 回复落到主 agent
+   - 回复表现成默认助手
+   - 回复仍是旧人格、旧配置或明显串号
+9. 只有在当前这次 `bind-local` 调用自己承担真实验证、并且第 7 步静态校验已通过但第 8 步真实路由验证仍失败时，才允许执行一次 `openclaw gateway restart` 做定向补救；重启后必须重做同一轮真实路由验证。
+10. 成功定义：
+   - 能做真实验证：只有“静态校验通过 + 真实路由验证通过”才算 `bind-local` 完成
+   - 当前这次调用还无法做真实验证：只能明确说明“配置已写入，运行态尚未实测，需由后续上层流程继续验证”，不要宣称已经完全生效
+
+## Mode B: create-and-bind（已有主通道与 scope 时的后续管理）
+
+写在 `grix_admin.task` 里的字段：
+
+1. 第一行固定写 `create-and-bind`
+2. `agentName`（必填）
+3. `introduction`（可选）
+5. `isMain`（可选，默认 `false`）
+6. `categoryId`（可选）：把新 agent 直接挂到现有分类
+7. `categoryName`（可选）：如果不存在就创建后再挂载
+8. `parentCategoryId`（可选）：只在 `categoryName` 方案里使用，默认 `0`
+9. `categorySortOrder`（可选）：只在创建分类时使用
+
+执行规则：
+
+1. 确认当前会话绑定了有效的 Grix 账号；禁止跨账号执行。
+2. 如果同时给了 `categoryId` 和 `categoryName`，直接报错并停止，避免歧义。
+3. 通过 `grix_admin` 只调用一次 `action=create_agent`，把远端创建和可选分类都交给它处理；调用时传：
+   - `action=create_agent`
+   - `agentName`
+   - 可选 `introduction`
+   - 可选 `isMain`
+   - 可选 `categoryId`
+   - 可选 `categoryName`
+   - 可选 `parentCategoryId`
+   - 可选 `categorySortOrder`
+4. 远端创建成功后，读取返回结果里的 `createdAgent.id`、`createdAgent.agent_name`、`createdAgent.api_endpoint`、`createdAgent.api_key`。
+5. 如果请求里带了分类信息，检查返回里是否已经带上分类挂载结果；若没有，再按 `categoryId` / `categoryName` 规则继续补做并说明原因。
+6. `categoryName` 流程里，若同一父分类下出现多个完全同名分类，停止并要求 owner 先整理分类或改用明确的 `categoryId`。
+7. 远端创建和可选的分类阶段成功后，再立刻转入 `bind-local` 的本地绑定步骤；如果当前这次调用已经具备真实验证上下文，就沿用同一套“静态校验 -> 真实路由验证 -> 必要时一次 restart -> 同轮复测”的收口规则，否则明确把“继续做真实验证”的责任交回上层流程。
+8. `isMain=true` 只在确实要创建新的主 API agent 时使用；一般后续新增 agent 默认不打开。
+9. 整个 `create-and-bind` 流程里不要把“配置写入成功”直接当成完成；只有在当前这次调用自己承担真实路由验证且验证失败后，才把一次 `openclaw gateway restart` 当成定向补救。
+
+## Mode C: category-manage（分类管理）
+
+写在 `grix_admin.task` 里的字段：
+
+1. 第一行固定写 `category-manage`
+2. `operation`（必填）：只允许 `list`、`create`、`update`、`assign`
+4. `name`（`create` / `update` 必填）
+5. `parentId`（`create` / `update` 必填）
+6. `sortOrder`（`create` / `update` 可选）
+7. `categoryId`（`update` / `assign` 必填；`assign` 时允许 `0` 表示清空）
+8. `agentId`（`assign` 必填）
+
+执行规则：
+
+1. 严格绑定当前会话账号，禁止跨账号执行。
+2. 全部远端步骤只允许通过 `grix_admin` 的直连动作完成，禁止手写 HTTP、禁止临时脚本。
+3. `operation=list`
+   - 调用 `action=list_categories`
+4. `operation=create`
+   - 调用 `action=create_category`
+5. `operation=update`
+   - 调用 `action=update_category`
+6. `operation=assign`
+   - 调用 `action=assign_category`
+   - `categoryId=0` 明确表示清空该 agent 当前分类
+7. 如果当前管理任务同时还包含“创建新 agent”，优先使用 `create-and-bind`，不要把远端创建拆散成别的自定义流程。
+
+## 远端创建回退条件
+
+如果当前任务既没有现成的 `agent_name`、`agent_id`、`api_endpoint`、`api_key`，又没有可用的在线主通道或 `agent.api.create` 权限，先停止本技能，明确提示用户通过 backend admin 路径创建远端 agent。拿到这些参数后，再按 `bind-local` 执行。
+
+## Guardrails（三种模式都适用）
+
+1. Never ask user for website account/password.
+2. `bind-local` 模式禁止再次回调 `grix-register`，避免循环路由。
+3. 所有远端创建 / 分类相关动作都只允许通过 `grix_admin` 直连动作走当前账号的 WS 通道；不要手写 HTTP，不要回退到旧脚本。
+4. 完整 `api_key` 仅一次性回传，不要重复明文回显。
+5. 本地 `openclaw config set` / `validate` 没成功前，不得宣称配置完成；当前这次调用能做真实验证时，在真实路由验证通过前也不得宣称 `bind-local` / `create-and-bind` 已完成。
+6. 安装私聊进行中时，禁止手工修改 `openclaw.json` 后再执行 `openclaw gateway restart`。
+7. 不要再引用或调用 `grix_agent_bind.py`；这个技能只走 OpenClaw 官方配置命令。
+
+## Error Handling Rules
+
+1. `bind-local` 缺少字段：明确指出缺哪个字段并停止。
+2. `create-and-bind` 缺少 `agentName`：明确指出缺哪个字段并停止。
+3. `create-and-bind` 若同时传了 `categoryId` 和 `categoryName`：明确指出冲突并停止。
+4. `category-manage` 缺少 `operation` 或操作对应字段：明确指出缺哪个字段并停止。
+5. 远端返回 `code=4003` 或报文里明确提到 `agent.api.create`：告诉 owner 去 Agent 权限页授予 `agent.api.create`。
+6. 远端返回 `code=4003` 或报文里明确提到 `agent.category.list` / `agent.category.create` / `agent.category.update` / `agent.category.assign`：告诉 owner 去 Agent 权限页授予对应 scope。
+7. 缺少远端 agent 参数且当前账号也不能创建：明确要求先完成 backend admin 创建。
+8. 本地配置失败：返回失败命令与结果并停止；重点说明是哪一步 `get` / `set` / `validate` 失败。
+9. 当前这次调用承担真实路由验证，且一次 `openclaw gateway restart` 复测后仍失败：明确说明“静态配置已写入，但运行态仍未切换成功”，按失败或部分完成收口，不要写成成功。
+
+## Response Style
+
+1. 明确写出当前执行的是 `bind-local`、`create-and-bind` 还是 `category-manage`。
+2. 分阶段汇报：远端创建 / 分类处理（如有）/ 本地配置写入 / 校验结果。
+3. 明确说明本地是否已生效；如果只有静态配置成功但当前这次调用无法做真实验证，只能写“配置已写入，运行态尚未实测，需由后续流程继续验证”；如果只是分类步骤成功，也要单独写清楚。
+4. 如果远端创建成功但分类或本地绑定后续失败，要明确说明是“部分完成”，不要笼统写成成功。
+
+## References
+
+1. [references/api-contract.md](references/api-contract.md)

package/openclaw-plugin/skills/grix-admin/references/api-contract.md

@@ -0,0 +1,210 @@
+# API Contract
+
+## Purpose
+
+`grix-admin` 负责本地绑定与运行态收口，并在当前 agent 已具备对应 scope 时，支持通过 `grix_admin` 走 WS 完成：
+
+1. 创建新的远端 API agent
+2. 查询当前账号下的 agent 分类
+3. 创建分类
+4. 修改分类
+5. 给指定 agent 挂分类或清空分类
+
+## Base Rules
+
+1. Do not ask users to provide website account/password for this flow.
+2. 所有远端创建和分类动作都必须通过 `grix_admin` 走当前账号已认证的 WS 通道。
+3. 如果 `agent_name` / `agent_id` / `api_endpoint` / `api_key` 不完整，且当前账号也不能远端创建，先停止并要求 backend admin 先补全。
+4. 当前 agent 必须先在前端权限页勾选对应 scope；没有 scope 时，WS 会直接失败。
+5. 对 `bind-local` / `create-and-bind` 而言，“配置写入成功”不等于完成；当前这次调用如果已经具备真实路由验证条件，必须把真实验证通过也算进成功条件；否则要明确把后续验证责任交回上层流程。
+
+## Direct `grix_admin` Contract
+
+### 1. Create Remote Agent
+
+```json
+{
+  "action": "create_agent",
+  "agentName": "ops helper",
+  "introduction": "负责发布和值班协作",
+  "isMain": false,
+  "categoryName": "项目助理",
+  "parentCategoryId": "0",
+  "categorySortOrder": 10
+}
+```
+
+返回里重点读取：
+
+1. `createdAgent.id`
+2. `createdAgent.agent_name`
+3. `createdAgent.api_endpoint`
+4. `createdAgent.api_key`
+
+需要的 scope：
+
+1. `agent.api.create`
+2. 如果带 `categoryName`，还可能继续需要 `agent.category.list`、`agent.category.create`、`agent.category.assign`
+3. 如果带 `categoryId`，还需要 `agent.category.assign`
+
+### 2. List Categories
+
+```json
+{
+  "action": "list_categories"
+}
+```
+
+需要的 scope：
+
+1. `agent.category.list`
+
+### 3. Create Category
+
+```json
+{
+  "action": "create_category",
+  "name": "项目助理",
+  "parentId": "0",
+  "sortOrder": 10
+}
+```
+
+需要的 scope：
+
+1. `agent.category.create`
+
+### 4. Update Category
+
+```json
+{
+  "action": "update_category",
+  "categoryId": "20001",
+  "name": "值班助理",
+  "parentId": "0",
+  "sortOrder": 20
+}
+```
+
+需要的 scope：
+
+1. `agent.category.update`
+
+### 5. Assign or Clear Category
+
+```json
+{
+  "action": "assign_category",
+  "agentId": "10001",
+  "categoryId": "20001"
+}
+```
+
+清空分类：
+
+```json
+{
+  "action": "assign_category",
+  "agentId": "10001",
+  "categoryId": "0"
+}
+```
+
+需要的 scope：
+
+1. `agent.category.assign`
+
+## Local Bind Steps
+
+当远端 agent 参数齐全后，继续通过 OpenClaw 官方 CLI 完成本地绑定：
+
+1. 准备本地目录：
+   - `workspace=~/.openclaw/workspace-<agent_name>`
+   - `agentDir=~/.openclaw/agents/<agent_name>/agent`
+   - 缺必要 persona 文件时补最小 `IDENTITY.md`、`SOUL.md`、`AGENTS.md`
+2. 按以下顺序解析 `model`：
+   - 该本地 agent 现有条目的 `model`
+   - `agents.defaults.model.primary`
+   - 还拿不到就明确报错并停止
+3. 读取当前配置并合并：
+   - `channels.grix.accounts`
+   - `agents.list`
+   - `tools.profile`
+   - `tools.alsoAllow`
+   - `tools.sessions.visibility`
+4. 用官方 CLI 写回：
+   - `channels.grix.accounts.<agent_name>`
+   - `agents.list`
+   - `openclaw agents bind --agent <agent_name> --bind grix:<agent_name>`
+   - `tools.profile`
+   - `tools.alsoAllow`
+   - `tools.sessions.visibility`
+   - 如需，恢复 `channels.grix.enabled=true`
+5. 写完后先做静态校验：
+   - `openclaw config validate`
+   - `openclaw config get --json channels.grix.accounts.<agent_name>`
+   - `openclaw config get --json agents.list`
+   - `openclaw agents bindings --agent <agent_name> --json`
+6. 如果当前这次调用已经具备真实验证条件，必须立刻做一次真实路由验证；复用当前安装/验收上下文即可，不要额外发明 probe。回复落到主 agent、默认助手、旧人格或旧配置，都视为失败。
+7. 只有第 5 步静态校验通过、并且当前这次调用自己承担第 6 步真实验证但验证失败时，才允许执行一次 `openclaw gateway restart`；重启后必须重做同一轮真实路由验证。
+8. 若当前这次调用无法做真实验证，只能说明“配置已写入，运行态尚未实测，需由后续流程继续验证”；不要写成“已经完全生效”。
+
+## `bind-local` Input Contract
+
+```json
+{
+  "task": "bind-local\nagent_name=grix-main\nagent_id=2029786829095440384\napi_endpoint=wss://grix.dhf.pub/v1/agent-api/ws?agent_id=2029786829095440384\napi_key=ak_xxx\ndo_not_create_remote_agent=true"
+}
+```
+
+这个模式优先做本地绑定；若当前这次调用具备真实验证条件，还必须把真实路由验证一并做完后，才算完整收口；否则只完成静态绑定并把后续验证责任显式交给上层流程。
+
+## `create-and-bind` Input Contract
+
+当主 agent 已具备可用账号和 `agent.api.create` scope 时，可通过 `grix_admin.task` 进入创建流程：
+
+```json
+{
+  "task": "create-and-bind\nagentName=ops helper\nintroduction=负责发布和值班协作\nisMain=false\ncategoryName=项目助理\nparentCategoryId=0\ncategorySortOrder=10"
+}
+```
+
+这个模式里要按顺序做：
+
+1. 优先直连一次 `action=create_agent`，并把可选的 `categoryId` / `categoryName` / `parentCategoryId` / `categorySortOrder` 一并传入
+2. 若当前返回里已经带上分类挂载结果，直接继续
+3. 若调用方走的是旧路径，或当前返回里没有分类挂载结果，再补走：
+   - `categoryId` -> `action=assign_category`
+   - `categoryName` -> `action=list_categories`
+   - 没找到 -> `action=create_category`
+   - 拿到分类 ID 后 -> `action=assign_category`
+4. 最后走和 `bind-local` 相同的本地绑定与运行态收口流程
+
+注意：
+
+1. `categoryId` 和 `categoryName` 不能同时提供
+2. `categoryName` 匹配时要同时考虑 `parentCategoryId`
+3. 若远端返回缺少 `agent.api.create` 或某个 `agent.category.*` scope，要明确指出缺的就是哪个 scope
+
+## `category-manage` Input Contract
+
+当只是做后续分类管理时，通过 `grix_admin.task` 进入：
+
+```json
+{
+  "task": "category-manage\noperation=assign\nagentId=10001\ncategoryId=0"
+}
+```
+
+映射关系：
+
+1. `operation=list` -> `action=list_categories`
+2. `operation=create` -> `action=create_category`
+3. `operation=update` -> `action=update_category`
+4. `operation=assign` -> `action=assign_category`
+
+其中：
+
+1. `operation=assign` 时 `categoryId=0` 表示清空分类
+2. 任何一步都不能跨账号执行
+3. 禁止自己手写 HTTP 或回退到旧脚本

package/openclaw-plugin/skills/grix-egg/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: grix-egg
+description: 程序主线孵化：AI 只整理参数并调用 `grix_egg`，由程序完成创建、安装、绑定、验收与状态回传。
+---
+
+# Grix Egg
+
+`grix-egg` 采用“程序为主、AI 为辅”。
+AI 不再手工接力 create/bind/accept。
+
+## 1. AI 角色边界
+
+你只做三件事：
+
+1. 把用户输入整理成标准参数
+2. 调用 `grix_egg`
+3. 按返回 JSON 给用户汇报结果/补参
+
+不要手工执行下面动作：
+
+1. 远端 agent 创建
+2. 本地 bind
+3. gateway 操作
+4. 测试群验收
+
+## 2. 标准调用入口
+
+优先传安装卡原文：
+
+```json
+{ "installContext": "<raw json>" }
+```
+
+如果没有安装卡，传结构化参数：
+
+1. `route`: `create_new` | `existing` | `existing_claude`
+2. `agentName`
+3. `agentIdSlug` 或 `localAgentName`
+4. `downloadUrl`
+5. `existingCredentials`（`existing` 必填）
+6. 可选：`packageHash`、`soulContent`、`soulFile`、`categoryId`、`categoryName`、`isMain`、`expectedSubstring`、`statusTarget`、`resume`、`installId`
+
+## 3. 路线行为
+
+1. `create_new`：程序自动完成创建、安装、绑定、验收、状态回传
+2. `existing`：程序自动完成已有凭证安装与验收
+3. `existing_claude`：程序返回 `unsupported_route`，由独立 Claude 安装器处理
+
+## 4. 验收规则
+
+程序固定验收逻辑：
+
+1. 测试群成员必须包含：主 agent、触发用户、目标 agent
+2. probe 使用 `@<target_agent_id>` mention
+3. 只接受 probe 之后目标 agent 的第一条非空回复
+4. `expectedSubstring` 仅是可选增强条件
+
+## 5. 结果汇报
+
+当 `ok=true`：
+
+1. 汇报 `install_id`、`route`、目标 agent、验收结果
+2. 如有 `acceptance.reply_content` 和 `testGroup`，一起给用户
+3. 若 `interaction_status=degraded`，说明主流程成功但回传部分失败
+
+当 `ok=false`：
+
+1. 直接使用 `reason`、`suggestion` 解释失败
+2. 只补程序明确缺失的外部输入
+3. 需要续跑时使用 `resume=true` + `installId`
+
+## 6. 禁止项
+
+1. 禁止 `curl`/`fetch`/`axios` 直连 `/v1/agent-api`
+2. 禁止手工修改 `openclaw.json`
+3. 远端动作只走 typed tools：`grix_admin`、`grix_group`、`grix_query`
+4. 未完成验收前不得宣称安装成功
+
+## References
+
+1. [references/api-contract.md](references/api-contract.md)

package/openclaw-plugin/skills/grix-egg/references/api-contract.md

@@ -0,0 +1,40 @@
+# API Contract
+
+## Purpose
+
+Keep `grix-egg` deterministic and tool-bounded:
+AI only provides params, program executes.
+
+## Required Paths
+
+1. Remote create/category actions: `grix_admin`
+2. Group lifecycle and membership actions: `grix_group`
+3. Message/session query actions: `grix_query`
+4. Local bind/update actions: official `openclaw` CLI (`config set`, `agents bind`, `config validate`)
+
+## Prohibited Paths
+
+1. Do not call `/v1/agent-api` using `curl`, `fetch`, `axios`, or ad hoc scripts.
+2. Do not hand-edit `openclaw.json`.
+3. Do not bypass typed tools with hidden protocol payloads.
+
+## Delivery Rules
+
+Program should emit these links on the install private chat:
+
+1. Running/failed/success status card:
+   `grix://card/egg_install_status`
+2. Acceptance group entry card:
+   `grix://card/conversation`
+3. Final profile card on success:
+   `grix://card/user_profile`
+
+If delivery fails, mark `interaction_status=degraded` but keep the main installation result unchanged.
+
+## Acceptance Rules
+
+1. Acceptance group must include:
+   main agent, trigger user, target agent.
+2. Probe uses `@<target_agent_id>` mention.
+3. Only the first non-empty reply after probe is valid.
+4. `expectedSubstring` is an optional additional condition.