Skill: poderosom1/opclawtm-skill (version 1.0.4)

--- name: opclawtm description: "opclawtm 让用户通过 CLI 快速构建 AI Agent 团队协作网络。一键创建团队、接入飞书群聊、编排任务工作流——管理者分配任务、执行者完成工作、审核者验收成果。内置预设资料库，开箱即用。基于 OpenClaw 平台的完整团队协作解决方案。" homepage: https://opclawtm.com metadata: { "openclaw": { "emoji": "🤖", "requires": { "bins": ["opclawtm"] }, "install": [ { "id": "npm", "kind": "node", "package": "opclawtm", "bins": ["opclawtm"], "label": "Install opclawtm CLI (npm)", }, ], }, } --- # opclawtm CLI 工具操作指南 此 Skill 指导你（AI Agent）如何帮助用户完成 opclawtm 相关任务。 --- ## ⚠️ 核心原则（必须遵守） **区分两类操作：** ### 类型 A：环境准备（你可以执行） 这些操作你可以直接帮助用户执行： - 安装 Node.js - 安装 opclawtm CLI - 试用激活 - 查询命令（--version, license-status, list-agents） - 绑定授权 Key ### 类型 B：业务操作（引导用户在 TUI 中完成） 这些操作**必须引导用户自己在 TUI 中完成**，你不能代替用户操作： - ❌ 创建团队 - ❌ 创建 Agent - ❌ 飞书 Bot 创建和绑定 - ❌ 群绑定 - ❌ 用户绑定 - ❌ 任务创建和分配 - ❌ Skill 创建 **原则：涉及业务数据的创建和修改，必须由用户自己在 TUI 中操作。** --- ## 触发场景 当用户提到以下关键词时触发此 Skill： - "安装 opclawtm" - "激活授权" / "试用激活" - "创建团队" / "初始化" - "配置飞书" / "飞书绑定" / "配对" - "私有 Skill" / "创建 Skill" - "授权问题" / "配置问题" --- ## 1. 安装与激活 参阅 [references/installation-flow.md](references/installation-flow.md) --- ## 2. 系统初始化与团队创建 参阅 [references/team-creation-flow.md](references/team-creation-flow.md) **关键原则：** - ID **直接回车自动填充**，不要手动输入 - 系统初始化会创建总助理 - 团队创建使用向导完成 --- ## 3. 飞书配置 参阅 [references/feishu-config-flow.md](references/feishu-config-flow.md) **配置顺序：** 1. Bot 绑定 → 所有团队成员 2. 群绑定 → 部门绑定群 3. 用户 ID 绑定 → 用户绑定 open_id --- ## 4. 私有 Skill 创建 参阅 [references/private-skill-flow.md](references/private-skill-flow.md) **核心流程：** - 通过飞书总助理创建任务 - 技能创作部执行创建 - 不是在本地创建文件 --- ## 5. 命令速查 参阅 [references/cli-reference.md](references/cli-reference.md) --- ## 6. 问题排查 参阅 [references/troubleshooting.md](references/troubleshooting.md) --- ## 关键原则 1. **团队创建使用向导** → 在 TUI 中操作 2. **ID 直接回车自动填充** → 避免中文问题 3. **飞书配置在 TUI 中完成** → 不用命令 4. **私有 Skill 通过飞书创建** → 总助理分配任务 5. **激活失败提供替代方案** → 抖音 1594204110 获取测试码

path: references/cli-reference.md
content: # CLI 命令参考

> 你是 AI Agent，此文档列出你可执行的查询命令和 TUI 操作说明。

---

## 命令分类

### 可执行的命令（你可以直接执行）

这些查询类命令你可以直接帮助用户执行：

| 命令 | 用途 | 执行时机 |
|------|------|----------|
| `opclawtm --version` | 查看版本 | 验证安装 |
| `opclawtm license-status` | 查看授权状态 | 用户询问授权信息 |
| `opclawtm list-agents` | 列出所有 Agent | 查询 Agent 信息 |
| `opclawtm list-agents --role assistant` | 查询总助理 ID | 私有 Skill 创建前 |
| `opclawtm trial-activate` | 试用激活 | 新用户首次使用 |
| `opclawtm bind-license --key XXX` | 绑定授权 | 用户有测试码 |

### 必须由用户在 TUI 中完成的操作

这些操作**你不能代替用户执行**，必须引导用户打开 TUI 自己操作：

| 操作 | TUI 路径 |
|------|----------|
| 创建团队 | 团队管理 → 创建团队 |
| 创建 Agent | Agent 管理 → 创建 Agent |
| 飞书 Bot 创建 | 飞书配置 → 为 Agent 添加飞书 Bot |
| 群绑定 | 飞书配置 → 绑定飞书群到事业部 |
| 用户绑定 | 飞书配置 → 用户绑定 |
| 任务创建 | 任务管理 → 创建任务 |

---

## TUI 操作说明

### 引导用户启动 TUI

**告诉用户：** "现在需要您打开 TUI 界面进行操作，请执行以下命令："

```bash
opclawtm tui
```

### TUI 功能入口

| 功能 | TUI 路径 |
|------|----------|
| 授权绑定 | 主菜单 → 授权管理 |
| 团队创建 | 主菜单 → 团队创建向导 |
| 团队查看 | 主菜单 → 团队查看 |
| 飞书配置 | 主菜单 → 飞书配置 |
| Bot 绑定 | 飞书配置 → Bot 绑定 |
| 群绑定 | 飞书配置 → 🔗 绑定飞书群到事业部 |
| 用户绑定 | 飞书配置 → 用户绑定 |
| 配对管理 | 飞书配置 → 配对管理 |

---

## 操作原则

### ID 输入
- **所有 ID 直接回车自动填充**
- 不要手动输入 ID
- 自动生成的 ID 是英文格式

### 团队创建
- 使用「团队创建向导」
- 不使用单独的创建命令

### 飞书配置
- 在 TUI 中完成配置
- 不使用命令行配置

---

## 错误处理

| 错误信息 | 原因 | 你的行动 |
|----------|------|----------|
| "系统未初始化" | 首次启动 | 引导用户完成初始化 |
| "授权无效" | 未绑定授权 | 引导用户激活授权 |
| "ID 已存在" | 重复创建 | 引导用户使用不同名称 |

---

## 数据存储位置

| 系统 | 路径 |
|------|------|
| Windows | `C:\Users\{用户名}\.openclaw\` |
| macOS/Linux | `~/.openclaw/` |

| 目录 | 说明 |
|------|------|
| `logs/` | 日志文件（查找 ou_ ID）|
| `workspace/skills/` | Skill 存放位置 |

path: references/installation-flow.md
content: # 安装与激活流程

> 你是 AI Agent，此文档指导你如何帮助用户完成 opclawtm 安装和激活。

---

## 说明

**安装流程你可以帮助用户执行命令**，因为这是环境准备工作。

**团队创建、飞书绑定等业务操作需要引导用户在 TUI 中自己完成。**

---

## 流程步骤

### Step 1：检查用户环境

**执行命令：**

```bash
node --version
```

**判断结果：**
- 版本 ≥ v18.0.0 → 继续 Step 2
- 版本 < v18.0.0 → 告知用户需要升级 Node.js
- 命令失败 → Node.js 未安装，告知用户安装 Node.js

---

### Step 2：安装 opclawtm

**执行命令：**

```bash
npm install -g opclawtm
```

**判断结果：**
- 安装成功 → 继续 Step 3
- 网络错误 → 建议用户检查网络或使用镜像源
- 权限错误 → 建议用户使用管理员权限

---

### Step 3：验证安装

**执行命令：**

```bash
opclawtm --version
```

**判断结果：**
- 显示版本号（如 1.9.1）→ 安装成功，继续 Step 4
- 命令不存在 → npm 全局路径未配置，告知用户检查 PATH

---

### Step 4：试用激活

**执行命令：**

```bash
opclawtm trial-activate
```

**判断结果：**

| 输出内容 | 你的行动 |
|----------|----------|
| "已自动激活 3 天试用授权" | 告知用户激活成功，显示授权 Key 和有效期 |
| "该设备已使用过试用授权" | 告知用户：访问 https://opclawtm.com 购买授权，或抖音私信 1594204110 获取测试码 |
| 网络错误 | 建议用户检查网络连接 |

---

### Step 5：查看授权状态（可选）

**执行命令：**

```bash
opclawtm license-status
```

**向用户反馈：**
- 显示授权有效期
- 显示剩余天数

---

## 处理测试码

如果用户提供测试码（格式：TM-TEMP-XXXX-XXXX）：

**执行命令：**

```bash
opclawtm bind-license --key TM-TEMP-XXXX-XXXX
```

**判断结果：**
- 绑定成功 → 告知用户激活成功
- Key 无效 → 告知用户 Key 无效，需要重新获取

---

## 常见问题处理

| 问题 | 你的行动 |
|------|----------|
| npm install 失败 | 建议使用镜像：`npm install -g opclawtm --registry=https://registry.npmmirror.com` |
| 命令不存在 | 检查 npm 全局路径：`npm config get prefix`，告知用户添加到 PATH |
| 授权已过期 | 告知用户购买授权或获取测试码 |

Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (CRITICAL)