What makes 腾讯乐享知识库-私有化版本 notable?

1K downloads. Trust evidence available

How should 腾讯乐享知识库-私有化版本 be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

腾讯乐享知识库-私有化版本

乐享知识库 MCP 全功能 Skill（私有化部署版）。当用户提到「乐享」「知识库」「个人知识库」「我的知识库」「lexiang」，或提供乐享链接，或涉及知识库的搜索/写入/编辑/文件/配置等操作时使用。

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.0k

Updated

Oct 11, 2026

Version

1.0.0

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1K downloads reported by the source. Last updated 10/11/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 11, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 11, 2026
Adoption signal: 1K downloadsadoption · observed Oct 11, 2026
Latest release: 1.0.0release · observed Jul 9, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s1786rt68jz3shqts3q6e64w4h83nfyz:lexiang-private-skills

Install using `clawhub skill install s1786rt68jz3shqts3q6e64w4h83nfyz:lexiang-private-skills` in an isolated environment before connecting it to live workloads.
No published capability contract is available yet, so validate auth and request/response behavior manually.
Review the upstream CLAWHUB listing at https://clawhub.ai/lexiang/lexiang-private-skills before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-lexiang-lexiang-private-skills/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

35,759 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: lexiang-knowledge-private
version: 1.0.0
description: "乐享知识库 MCP 全功能 Skill（私有化部署版）。当用户提到「乐享」「知识库」「个人知识库」「我的知识库」「lexiang」，或提供乐享链接，或涉及知识库的搜索/写入/编辑/文件/配置等操作时使用。"
---

# 乐享知识库 MCP Skill（私有化部署版）

当用户提到「**乐享**」「**知识库**」「**个人知识库**」「**我的知识库**」「**lexiang**」，或提供乐享链接，或给出 `space_id`、`entry_id`、`/spaces/`、`/pages/` 等乐享标识时，读取本 Skill。

> **私有化说明**：本 Skill 适用于私有化部署的乐享实例。用户访问域名为企业自定义私有域名（如 `https://lexiang.mycompany.com`），与 SaaS 版不同，**链接直接使用私有化域名，无需判断域名结构**。

---

## ⛔ MANDATORY RULES — 必须遵守

1. **遇到 401 / 连接断开**：立即停止重试，读取 `references/setup.md`；引导用户重新获取 token
2. **写入操作**：必须基于用户明确提供的目标（URL/ID/名称确认），**禁止**自行遍历或猜测目标
3. **链接生成**：必须使用 `whoami()` 返回的 `company.company_domain` 作为域名，**禁止**使用 MCP endpoint 拼接用户链接
4. **company_from**：私有化域名已指向对应企业，链接中**不需要拼接 `company_from` 参数**
5. **强制检索**：当用户消息同时包含「乐享/知识库」等平台词 + 「文档/论文/文章/内容/资料/笔记/之前写的/上次的/风格」等内容词时，**必须先调用 `search_kb_search` 或 `search_kb_embedding_search` 获取实际内容**，不得凭空分析或直接生成回答
6. **大批量保护**：文件/条目数量 > 20 个时，**必须分批执行**（每批 ≤ 20 个）；操作前告知用户数量和策略，禁止一次性提交导致 token 超限，详见 `references/files.md`

---

## 🔗 链接生成规则（全局通用）

私有化版本链接生成规则：

**`{domain}` = `whoami()` 返回的 `company.company_domain`（即企业私有化域名）**

链接格式：`{domain}/pages/{entry_id}`

> **私有化域名已指向对应企业，无需拼接 `company_from` 参数。**
> 如 `whoami()` 返回 `company_domain` 为 `https://lexiang.mycompany.com`，则链接为：
> `https://lexiang.mycompany.com/pages/{entry_id}`

**禁止**使用 MCP 端点域名拼接用户访问链接。

---

## 🛡️ 写入安全红线（全局通用）

- 🚫 禁止遍历团队/知识库列表后自行选择写入目标
- 🚫 禁止根据名称"看起来合适"就决定写入
- 🚫 禁止在未确认时执行写入

> 完整安全规则（允许写入的条件、工具分类）见 `references/base.md`

---

## 📋 意图路由表

根据用户意图，Read 对应参考文件：

| 用户意图 | 读取文件 | 典型触发词 |
|---------|---------|-----------|
| 配置乐享 / 401 错误 / Token 过期 | `references/setup.md` | 「配置乐享」「token 过期」「连不上」「401」 |
| 搜索 / 查找 / 阅读 / 浏览 | `references/search.md` | 「找一下」「搜索」「读一下这个页面」「打开链接」 |
| 创建文档 / 写入 / 保存 / 导入 | `references/writer.md` | 「写到乐享」「创建文档」「保存到知识库」「存到我的知识库」「保存到个人知识库」「导入」 |
| 编辑已有页面 / Block 操作 | `references/blocks.md` | 「修改这个页面」「加个标题」「删掉这段」「在 /pages/xxx 里…」 |
| 上传/下载文件（PDF/Word/图片等） | `references/files.md` | 「传个 PDF」「上传文件」「下载这个文件」 |
| 导入腾讯会议 | `references/connectors.md` | 「把会议录制导入」「导入会议录制」 |
| 数据模型 / URL 规则 / 完整安全规则 | `references/base.md` | 由上述模块内部引用 |

### ⚠️ 易混淆场景

| 场景 | 正确模块 | 说明 |
|------|---------|------|
| 用户提供 `/pages/xxx` 链接 + 要求「加内容/修改」 | `references/blocks.md` | 操作**已有页面** |
| 用户提供 `/spaces/xxx` 链接 + 要求「写入/创建」 | `references/writer.md` | 在知识库下**新建文档** |
| 用户提供 `/pages/xxx` 链接 + 仅要求「读/总结」 | `references/search.md` | **只读**操作 |
| 上传 PDF/Word/图片 | `references/files.md` | 二进制文件，非文本文档 |
| 创建 Markdown 文本文档 | `references/writer.md` | 文本内容，非二进制 |
| 「乐享里有一篇关于 X 的文档」 | `references/search.md` → 先搜索 | **必须先检索**，不能直接回答 |
| 「看看乐享里 XX 的写作风格」 | `references/search.md` → 先读取 | **必须先读取内容**，不能凭空分析 |
| 「分析一下我知识库里关于 X 的内容」 | `references/search.md` → 先搜索 | **必须先检索**，不能凭空生成 |

### ⚠️ 跨模块任务

需要同时读取多个文件时，按流程顺序读取：

- **搜索后写入**：先 `references/search.md` → 再 `references/writer.md`
- **读取后编辑**：先 `references/search.md` → 再 `references/blocks.md`
- **上传后记录**：先 `references/files.md` → 再 `references/writer.md`
- **生成内

README.md

# lexiang-private-skills

**乐享知识库 MCP Skill（私有化部署版，v1.0.0）**

为 AI Agent 提供乐享知识库的全功能操作能力，包括搜索阅读、文档写入、Block 编辑、文件上传、外部导入等。

> **适用场景**：企业私有化部署的乐享实例，访问域名为企业自定义域名，与 SaaS 版本独立维护。

---

## 快速开始

访问你的乐享私有化 MCP 配置页面获取配置信息：

```
https://{你的乐享私有化域名}/ai/claw
```

登录后即可获取：
- **MCP Endpoint**：填入 mcp.json 的 `url` 字段
- **LEXIANG_TOKEN**：访问令牌（格式 `lxmcp_xxx`）

填入 `mcp.json`：

```json
{
  "mcpServers": {
    "lexiang": {
      "url": "你的MCP_ENDPOINT",
      "transportType": "streamable-http",
      "headers": {
        "Authorization": "Bearer 你的LEXIANG_TOKEN"
      }
    }
  }
}
```

---

## 目录结构

```
lexiang-private-skills/
├── SKILL.md                  # 顶层路由入口（意图识别 → 参考文件）
├── mcp.json                  # MCP 配置模板
├── README.md                 # 本文件
├── assets/                   # 静态资源
├── references/               # 参考文档（19 份）
│   ├── base.md               # 数据模型、URL 规则、完整安全规则、工具发现
│   ├── setup.md              # Token 配置、续期、故障排查
│   ├── search.md             # 关键词/语义搜索、内容读取、目录浏览
│   ├── writer.md             # 新建文档、导入内容、公众号收藏
│   ├── blocks.md             # 已有页面的 Block 级增删改移
│   ├── files.md              # 二进制文件上传/下载（三步流程）
│   ├── connectors.md         # 腾讯会议录制导入
│   ├── index.md              # 完整索引 + 按场景推荐加载顺序
│   ├── block-schema.md       # Block 类型完整字段定义
│   ├── block-update.md       # 批量更新 Block 方法
│   ├── common-errors.md      # 常见错误排查（高频错误速查表）
│   ├── content-reorganize.md # 文档结构重组方案
│   ├── doc-templates.md      # 文档类型与大纲模板
│   ├── folder-sync.md        # 文件夹同步方案
│   ├── markdown-import.md    # Markdown 导入详解
│   ├── markdown-to-block.md  # Markdown 转 Block 指南
│   ├── mcp-examples.md       # 复杂 Block 结构示例
│   ├── skill-maintenance.md  # Skill 维护指南
│   └── theme-config.md       # 主题配色配置
└── scripts/                  # 辅助脚本
    ├── upload-files.py       # 批量文件上传（支持单文件/文件夹/并行/dry-run）
    ├── sync-folder.ts        # 文件夹增量同步到乐享知识库
    └── test_upload_files.py  # 上传脚本测试
```

---

## 模块说明

根据用户意图，Agent 读取 `references/` 下对应的参考文件：

| 用户意图 | 参考文件 | 典型触发词 |
|---------|---------|-----------|
| 配置乐享 / 401 错误 / Token 过期 | `references/setup.md` | 「配置乐享」「token 过期」「连不上」「401」 |
| 搜索 / 查找 / 阅读 / 浏览 | `references/search.md` | 「找一下」「搜索」「读一下这个页面」 |
| 创建文档 / 写入 / 保存 / 导入 | `references/writer.md` | 「写到乐享」「创建文档」「保存到知识库」 |
| 编辑已有页面 / Block 操作 | `references/blocks.md` | 「修改这个页面」「加个标题」「删掉这段」 |
| 上传/下载文件 | `references/files.md` | 「传个 PDF」「上传文件」「下载这个文件」 |
| 导入腾讯会议 | `references/connectors.md` | 「导入会议录制」 |
| 数据模型 / URL 规则 / 安全规则 | `references/base.md` | 由上述模块内部引用 |

> 完整路由规则和易混淆场景见 `SKILL.md`

---

## 核心规则

- **写入安全**：必须基于用户明确提供的目标（URL/ID/确认），禁止自行遍历或猜测
- **链接生成**：使用 `whoami().company.company_domain` 作为私有化域名直接拼接，无需追加 `company_from` 参数
- **401 处理**：不重试，引导用户打开 `{私有化域名}/ai/claw` 续期（点续期按钮即可恢复，无需重新配置）
- **强制检索**：用户提到「乐享里的文档/内容」时，必须先搜索再回答，禁止凭空生成

> 完整规则详见 `SKILL.md` 和 `references/base.md`

---

## 辅助脚本

| 脚本 | 说明 |
|------|------|
| `scripts/upload-files.py` | 批量文件上传（支持单文件/文件夹/并行/dry-run） |
| `scripts/sync-folder.ts` | 文件夹增量同步到乐享知识库 |
| `scripts/test_upload_files.py` | 上传脚本测试 |

```bash
#

scripts/README.md

# Lexiang Scripts

乐享文档写入辅助脚本集合。

## 安装依赖

### TypeScript 脚本

```bash
npm install -g ts-node typescript
npm install @types/node
```

### Python 脚本

```bash
pip install aiohttp requests
```

## 脚本列表

### sync-folder.ts

本地文件夹增量同步到乐享知识库。

```bash
# Dry run 模式（仅生成计划）
npx ts-node sync-folder.ts --local ./docs --entry-id abc123 --dry-run

# 完整参数
npx ts-node sync-folder.ts \
  --local ./docs \
  --entry-id <parent_entry_id> \
  --space-id <space_id> \
  --state-file .sync-state.json \
  --dry-run
```

### upload-files.py

并行上传文件到乐享。

```bash
# 单文件上传
python upload-files.py --files doc1.md doc2.pdf --entry-id abc123

# 文件夹批量上传
python upload-files.py --folder ./docs --entry-id abc123 --parallel 5

# 输出上传计划到 JSON
python upload-files.py --folder ./docs --entry-id abc123 --output plan.json --dry-run
```



## 工作流示例

### 1. 项目文档同步

```bash
# 1. 首次同步（dry run 检查）
npx ts-node sync-folder.ts --local ./project-docs --entry-id root123 --dry-run

# 2. 执行同步
# 将生成的 MCP 调用序列提供给 AI 助手执行

# 3. 后续增量同步
# 脚本会自动检测变更，只同步修改的文件
```

### 2. Markdown 文档导入

```bash
# 1. 生成上传计划
python upload-files.py --folder ./markdown-docs --entry-id target123 --output plan.json

# 2. 查看计划
cat plan.json

# 3. 执行上传（通过 AI 助手）
# 将 plan.json 中的 MCP 调用提供给 AI 助手
```

## 注意事项

1. **MCP 调用需要通过 AI 助手执行**：脚本生成 MCP 调用参数，实际执行需要 AI 助手的 MCP 能力
2. **文件上传是 3 步流程**：apply_upload → HTTP PUT → commit_upload
3. **同步状态文件**：`.lexiang-sync-state.json` 记录同步状态，请勿删除
4. **大文件建议分批**：单次 MCP 调用的数据量有限制
5. **Block 写入使用 MCP 工具**：直接调用 `block_convert_content_to_blocks` 将 Markdown/HTML 转换为块结构，无需手动构建

_meta.json

{
  "ownerId": "kn72bkq17fhyp4f0c7c8mvqq8d86zrsm",
  "slug": "lexiang-private-skills",
  "version": "1.0.0",
  "publishedAt": 1783578255650
}

references/base.md

# 乐享 MCP 基础知识（私有化部署版）

> 本文件为所有功能模块的共享基础层，包含数据模型、URL 规则、安全约束、工具发现等通用知识。
> **核心规则（URL 生成 + 写入安全红线）已在 SKILL.md 中内联，本文件为详细参考。**

---

## ⛔ 必读（调用前必须理解）

1. 本服务**直接暴露所有业务工具**（如 `team_list_teams`、`search_kb_search` 等），可直接调用
2. 调用前先确认工具参数定义，**以 MCP 返回的 schema 为准**
3. 不确定参数时，使用 `get_tool_schema(tool_name="xxx")` 获取最新定义

---

## 📊 数据模型

### 核心概念

| 概念 | 说明 |
|------|------|
| **Team（团队）** | 顶级组织单元，一个团队下可以有多个知识库(Space) |
| **Space（知识库）** | 知识的容器，属于某个团队，包含多个条目(Entry)，有 `root_entry_id` 作为根节点 |
| **Entry（条目）** | 知识库中的内容单元，可以是页面(page)、文件夹(folder)或文件(file)，支持树形结构(parent_id) |
| **File（文件）** | 附件类型的条目，如 PDF、Word、图片等 |

### 层级关系

```
Team → Space → Entry（树形结构，root_entry_id 为根）
                  ├── page（页面）
                  ├── folder（文件夹）
                  └── file（文件）
```

### URL 规则（私有化版本）

`{domain}` = `whoami()` 返回的 `company.company_domain`（即企业私有化域名，如 `https://lexiang.mycompany.com`）

> **⛔ 严禁使用 MCP endpoint 拼接任何用户可访问的链接！** MCP 域名仅用于接口调用，不是用户访问地址。

| 资源 | URL 格式 |
|------|----------|
| 团队首页 | `{domain}/t/{team_id}/spaces` |
| 知识库 | `{domain}/spaces/{space_id}` |
| 知识条目 | `{domain}/pages/{entry_id}` |

**链接生成规则（私有化版本，所有操作通用）：**

私有化域名已指向对应企业，**直接使用 `{domain}` 拼接，无需附加 `company_from` 参数**：

```
链接 = {domain}/pages/{entry_id}
```

示例：`whoami()` 返回 `company_domain` 为 `https://lexiang.mycompany.com`，则：
- 条目链接：`https://lexiang.mycompany.com/pages/abc123`
- 知识库链接：`https://lexiang.mycompany.com/spaces/xyz789`

### URL 解析规则

当用户提供链接时，从 URL 路径中提取 ID（**忽略查询参数**）：

| URL 路径 | 提取方式 |
|----------|----------|
| `/spaces/{space_id}` | 取 `spaces/` 后面的部分作为 `space_id` |
| `/pages/{entry_id}` | 取 `pages/` 后面的部分作为 `entry_id` |
| `/t/{team_id}/spaces` | 取 `t/` 后面的部分作为 `team_id` |

---

## 🛡️ 写入操作安全规则

> **核心原则**：写入、修改、删除操作 **必须基于用户明确提供的目标信息**，禁止 Agent 自行选择或猜测目标。

### 🚫 绝对禁止

1. 禁止遍历团队/知识库列表后自行选择写入目标
2. 禁止根据名称"看起来合适"就决定写入
3. 禁止在未确认时执行写入

### ✅ 允许写入的条件（满足之一即可）

| 条件 | 示例 |
|------|------|
| 用户提供了明确 URL | `"写到这里：https://lexiang.mycompany.com/spaces/xxx"` |
| 用户提供了明确 ID | `"写入 space_id 为 xxx 的知识库"` |
| 用户指定名称 + Agent 回显确认 | Agent 搜到后展示详情，用户确认 |
| 用户要求保存到个人知识库且 `whoami` 返回了个人知识库 | `"保存到我的知识库"` → 自动写入个人知识库 |

### 写入 vs 读取工具分类

**写入操作**（需满足安全规则）：
`entry_create_entry`、`entry_import_content`、`entry_import_content_to_entry`、`block_update_block`、`block_update_blocks`、`block_create_block_descendant`、`block_delete_block`、`block_delete_block_children`、`block_move_blocks`、`entry_rename_entry`、`entry_move_entry`、`file_apply_upload`、`file_commit_upload`、`file_create_hyperlink`

**只读操作**（不受安全规则限制，可直接执行）：
`team_list_teams`、`team_describe_team`、`team_list_frequent_teams`、`space_list_spaces`、`space_describe_space`、`entry_list_children`、`block_list_block_children`、`search_kb_search`、`search_kb_embedding_search`、`space_list_recently_spaces`、`entry_list_latest_entries`、`entry_describe_ai_parse_content`、`file_describe_file`、`file_download_file`、`whoami`

---

## 🔍 工具发现与调用

本服务**直接暴露所有业务工具**，可直接调用。同时提供以下辅助元工具：

| 元工具 | 用途 |
|--------|------|
| `list_tool_categories` | 列出所有工具分类及其工具列表 |
| `search_tools`

Github ReposUpdated 2d agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW

Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular