---
name: meet-lxcli-guide
description: "Use when the user needs to install lxcli, configure CLI token auth, manage Meet/CO/SKY tenants, use Kanboard task and bug commands, or install lxcli-provided skills into a skill-capable agent environment."
metadata: { "openclaw": { "emoji": "🛠️", "requires": { "config": ["channels.meet"], "bins": ["lxcli"] }, "cliHelp": "lxcli --help" } }
---

# Meet lxcli Guide

用于指导安装 `lxcli`、完成首次认证、执行常用看板需求/bug 命令，以及安装 `lxcli` 提供的 skills。

## When to Use

在这些场景使用：

- 需要安装或升级 `lxcli`
- 需要从 Meet 客户端获取 CLI Token 并完成 `auth`
- 需要创建、查询、查看或评论需求/bug
- 需要把 `lxcli` 自带 skills 安装到支持 skills 的 Agent 环境

## Prerequisites

- Node.js `>= 22.0.0`
- 建议已安装 `npm` 或 `pnpm`

先检查环境：

```bash
node -v
npm -v
```

## Install lxcli

推荐全局安装：

```bash
npm install -g @meet-im/lxcli
```

或：

```bash
pnpm add -g @meet-im/lxcli
```

如果镜像未同步，显式使用官方源：

```bash
pnpm add -g @meet-im/lxcli --registry=https://registry.npmjs.org/
```

## Verify Installation

```bash
lxcli -V
lxcli --help
```

注意：版本参数是 `-V`，不是 `-v`。

## Quick Start in 5 Commands

第一次上手，按这个顺序即可：

```bash
lxcli -V
lxcli auth <name> <token> --tenant meet --env prod
lxcli users list --format table
lxcli kb --help
lxcli kb searchTasks --project_id 4 --query "status:1"
```

1. 确认 `lxcli` 已安装
2. 完成生产环境认证
3. 确认当前用户已写入本地配置
4. 查看 `kb` 可用命令
5. 跑一次最小搜索，验证 Kanboard 能正常访问

## First-Time Auth

### 1. 获取 CLI Token

在 Meet 客户端中：

1. 升级客户端到最新版本（文档要求 2.4.0 / 1.12.2 以上）
2. 点击左上角头像，打开设置页
3. 找到“AI 工具”
4. 点击“创建”或“重置” CLI Token
5. 复制并保存 Token（通常只展示一次）

### 2. 添加认证信息

```bash
lxcli auth <name> <token> --tenant <tenant>
```

- `<name>`：本地用户名称，用于区分账号
- `<token>`：客户端生成的 CLI Token
- `--tenant <tenant>`：必填，可选 `meet`、`co`、`sky`

默认推荐：日常优先使用 `meet + prod`；`staging` 通常用于开发测试。

示例：

```bash
lxcli auth ryu sp-xxx --tenant meet
```

常用扩展参数：

```bash
lxcli auth ryu sp-xxx --tenant meet --env prod
lxcli auth ryu sp-xxx --tenant meet --env staging
lxcli auth ryu sp-xxx --tenant meet --company 1
```

- `--env <env>`：`test`、`pre`、`staging`、`beta`、`prod`，默认 `prod`
- `--company <id>`：公司 ID，默认 `1`

建议：

- 生产环境：`--tenant meet --env prod`
- 开发测试：`--tenant meet --env staging`

### 3. 查看当前用户与租户

```bash
lxcli users
lxcli users list --format table
lxcli tenants list --format table
lxcli services list --format table
```

## Common Kanboard Commands

先查看可用命令：

```bash
lxcli kb --help
```

### 搜索需求/bug

```bash
lxcli kb searchTasks --help
```

实战示例：

```bash
# 查询项目 4 中状态为 1 的任务
lxcli kb searchTasks --project_id 4 --query "status:1"

# 查询标题或内容中包含“登录”的任务
lxcli kb searchTasks --project_id 4 --query "登录"
```

### 查看需求/bug 明细

```bash
lxcli kb getTask --help
lxcli kb getTask --task_id 123
```

### 创建需求/bug

快捷参数方式：

```bash
lxcli kb createTask --title "登录页优化" --project_id 4 --owner_id 23 --category_id 3
```

创建 bug：

```bash
lxcli kb createTask --title "登录按钮点击无响应" --project_id 4 --owner_id 23 --category_id 3 --params '{"title":"登录按钮点击无响应","project_id":4,"owner_id":23,"category_id":3,"is_bug":1,"description":"复现步骤：1. 打开登录页 2. 输入账号密码 3. 点击登录无响应"}'
```

完整参数方式：

```bash
lxcli kb createTask --params '{"title":"登录页优化","project_id":4,"owner_id":23,"category_id":3,"is_bug":0,"description":"支持 Markdown"}'
```

说明：

- `is_bug=1` 表示 bug
- `is_bug=0` 表示普通需求
- 复杂场景优先使用 `--params`

### 给需求增加评论

```bash
lxcli kb createComment --help
lxcli kb createComment --task_id 123 --content "已复现，待修复"
```

## Install lxcli Skills

如果你在支持 skills 的 Agent 环境中使用 `lxcli`，可以安装其自带 skills。

### 安装整个 skills 仓库

```bash
npx skills add https://github.com/LynkTechnology/lxcli -y
```

### 只安装单个 skill

```bash
npx skills add https://github.com/LynkTechnology/lxcli/tree/main/skills/kb-searchTasks -y
npx skills add https://github.com/LynkTechnology/lxcli/tree/main/skills/kb-getMe -y
```

### OpenClaw 本地链接或复制

先 clone 仓库：

```bash
git clone https://github.com/LynkTechnology/lxcli.git
cd lxcli
```

将整个 skills 目录软链接到本地：

```bash
ln -s $(pwd)/skills/* ~/.openclaw/skills/
```

或只复制需要的 skills：

```bash
cp -r skills/kb-searchTasks skills/meet-getMyInfo ~/.openclaw/skills/
```

## Common Issues

### `lxcli is not recognized`

```bash
pnpm ls -g --depth 0
where lxcli
```

如果没装上，重新安装：

```bash
pnpm add -g @meet-im/lxcli --registry=https://registry.npmjs.org/
```

安装后重新打开终端。

### registry 404

镜像未同步时改用官方源：

```bash
pnpm add -g @meet-im/lxcli --registry=https://registry.npmjs.org/
```

或：

```bash
npm install -g @meet-im/lxcli --registry=https://registry.npmjs.org/
```

### Windows 下 `--params` JSON 传参异常

```bash
lxcli <service> <method> --help
```

复杂 JSON 先从最小示例开始验证，再逐步补充字段。

## Quick Reference

```bash
lxcli -V
lxcli --help
lxcli auth <name> <token> --tenant meet --env prod
lxcli users list --format table
lxcli tenants list --format table
lxcli services list --format table
lxcli kb --help
lxcli kb getTask --task_id 123
lxcli kb createTask --help
lxcli kb createComment --help
npx skills add https://github.com/LynkTechnology/lxcli -g
```