Lexiang

腾讯乐享知识库 API

腾讯乐享知识库是企业级知识管理平台，提供知识库、团队协作、文档管理、AI助手等功能。

数据模型

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

层级关系：Team -> Space -> Entry（树形结构，root_entry_id 为根）

URL 规则

生成知识库链接时，必须使用企业专属域名（如 csig.lexiangla.com），禁止使用 https://lexiang.tencent.com/wiki/{id} 格式。

优先使用 API 响应中的 links 字段；如果 API 未返回完整链接，根据上述规则拼接。

凭证配置

环境变量

export LEXIANG_APP_KEY="your_app_key"
export LEXIANG_APP_SECRET="your_app_secret"
export LEXIANG_STAFF_ID="your_staff_id"  # 写操作必需

凭证配置优先级

1. 环境变量（最高优先级）
2. ~/.openclaw/openclaw.json 中的 skills.entries.lexiang.env 字段
3. ~/.config/lexiang/credentials JSON 文件

初始化（加载凭证 + 获取 Token）

执行 scripts/init.sh 脚本自动处理凭证加载和 Token 获取：

source scripts/init.sh
# 之后可使用 $LEXIANG_TOKEN 和 $LEXIANG_STAFF_ID

Token 有效期 2 小时，获取频率限制 20次/10分钟。脚本会自动缓存到 ~/.config/lexiang/token。

API 调用基础

请求头

# 读操作
-H "Authorization: Bearer $LEXIANG_TOKEN"
-H "Content-Type: application/json; charset=utf-8"

# 写操作（额外需要）
-H "x-staff-id: $LEXIANG_STAFF_ID"

需要 x-staff-id 的接口

所有写操作（创建/更新/删除）、AI 搜索/问答、权限设置

创建知识节点的格式

使用 JSON:API 规范格式，通过 relationships 指定所属知识库和父节点：

{
  "data": {
    "type": "kb_entry",
    "attributes": {"entry_type": "page", "name": "标题"},
    "relationships": {
      "space": {"data": {"type": "kb_space", "id": "SPACE_ID"}},
      "parent_entry": {"data": {"type": "kb_entry", "id": "PARENT_ID"}}
    }
  }
}

通用限制

• 频率限制：大部分接口 3000次/分钟
• 权限要求：需在 AppKey 的授权范围内

核心工作流

1. 查询知识

# 获取团队列表
curl "https://lxapi.lexiangla.com/cgi-bin/v1/kb/teams?limit=20" \
  -H "Authorization: Bearer $LEXIANG_TOKEN"

# 获取知识库列表
curl "https://lxapi.lexiangla.com/cgi-bin/v1/kb/spaces?team_id={team_id}&limit=20" \
  -H "Authorization: Bearer $LEXIANG_TOKEN"

# 获取知识列表
curl "https://lxapi.lexiangla.com/cgi-bin/v1/kb/entries?space_id={space_id}&limit=20" \
  -H "Authorization: Bearer $LEXIANG_TOKEN"

# 获取文档内容（HTML 格式）
curl "https://lxapi.lexiangla.com/cgi-bin/v1/kb/entries/{entry_id}/content?content_type=html" \
  -H "Authorization: Bearer $LEXIANG_TOKEN"

2. 创建文档

两种方式对比：

推荐方式：上传 Markdown 文件

使用 scripts/upload_file.sh 脚本：

source scripts/init.sh
bash scripts/upload_file.sh ./document.md SPACE_ID [PARENT_ENTRY_ID]

3. AI 搜索与问答

# AI 搜索
curl -X POST "https://lxapi.lexiangla.com/cgi-bin/v1/ai/search" \
  -H "Authorization: Bearer $LEXIANG_TOKEN" \
  -H "x-staff-id: $LEXIANG_STAFF_ID" \
  -H "Content-Type: application/json; charset=utf-8" \
  -d '{"query": "搜索关键词"}'

# AI 问答（research=true 使用专业研究模式）
curl -X POST "https://lxapi.lexiangla.com/cgi-bin/v1/ai/qa" \
  -H "Authorization: Bearer $LEXIANG_TOKEN" \
  -H "x-staff-id: $LEXIANG_STAFF_ID" \
  -H "Content-Type: application/json; charset=utf-8" \
  -d '{"query": "问题内容", "research": false}'

使用块接口的关键注意事项

对于需要使用在线文档块接口的场景，注意以下要点（详细示例见 references/api-blocks.md）：

1. 新建文档不传 parent_block_id：直接插入内容到页面根节点
2. 列表块字段名不同于类型名：bulleted_list 用 bulleted 字段，numbered_list 用 numbered 字段
3. 标题块字段需匹配：h1 用 heading1，h2 用 heading2，不是 text
4. 嵌套块必须使用 children 和 block_id：表格/引用/高亮块通过临时 ID 建立父子关系
5. 不支持嵌套的类型：h1-h5、code、image、attachment、video、divider、mermaid、plantuml

常见错误排查

详细 API 参考

按需查阅以下参考文件获取完整的接口文档：

HTTP 错误码