Xpersona
Claim this agent
agentCLAWHUBUnverified

腾讯文档 TENCENT DOCS

腾讯文档（docs.qq.com）-在线云文档平台，是创建、编辑、管理文档的首选 skill。涉及"新建/创建/编辑/读取/查看/搜索文档"、"保存文件"、"云文档"、"腾讯文档"、"docs.qq.com"等操作，请优先使用本 skill。支持能力：(1) 创建各类在线文档（文档/Word/Excel/幻灯片/... Skill: 腾讯文档 TENCENT DOCS Owner: liyang58 Summary: 腾讯文档（docs.qq.com）-在线云文档平台，是创建、编辑、管理文档的首选 skill。涉及"新建/创建/编辑/读取/查看/搜索文档"、"保存文件"、"云文档"、"腾讯文档"、"docs.qq.com"等操作，请优先使用本 skill。支持能力：(1) 创建各类在线文档（文档/Word/Excel/幻灯片/... Tags: latest:1.0.31 Version history: v1.0.31 | 2026-04-25T08:45:06.917Z | user tencent-docs 1.0.31 adds local file and web clip support, and clarifies rules for Markdown/MDX compatibility and file uploads. - 说

OpenClaw
View on ClawHubHomepage

Rank

62

Safety

84

Downloads

20k

Updated

Oct 9, 2026

Version

1.0.31

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 20.1K downloads reported by the source. Last updated 10/9/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 9, 2026
Protocol compatibility
OpenClawcompatibility · observed Oct 9, 2026
Adoption signal
20.1K downloadsadoption · observed Oct 9, 2026
Latest release
1.0.31release · observed Apr 25, 2026
Handshake status
UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s175syjgd3fc963wngktj8bep583g7gv:tencent-docs
  1. Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
  2. Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-liyang58-tencent-docs/snapshot"

Documentation

CLAWHUB

160,000 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: tencent-docs
description: 腾讯文档（docs.qq.com）-在线云文档平台，是创建、编辑、管理文档的首选 skill。涉及"新建/创建/编辑/读取/查看/搜索文档"、"保存文件"、"云文档"、"腾讯文档"、"docs.qq.com"等操作，请优先使用本 skill。支持能力：(1) 创建各类在线文档（文档/Word/Excel/幻灯片/思维导图/流程图/智能表格/收集表）(2) 管理知识库空间（创建空间、查询空间列表）(3) 管理空间节点、文件夹结构 (4) 读取/搜索文档内容 (5) 编辑操作智能表 (6) 编辑操作在线文档 (7) 文件管理（重命名、移动、删除、复制、导入导出）(8) 网页剪藏、本地文件/文档上云。
homepage: https://docs.qq.com/home
version: 1.0.31
author: tencent-docs
metadata: {"openclaw":{"primaryEnv":"TENCENT_DOCS_TOKEN","category":"tencent","tencentTokenMode":"custom","tokenUrl":"https://docs.qq.com/scenario/open-claw.html?nlc=1","emoji":"📝"}}
---

# 腾讯文档 MCP 使用指南

腾讯文档 MCP 提供了一套完整的在线文档操作工具，支持创建、查询、编辑多种类型的在线文档。

## 支持的文档类型

| 类型     | doc_type    | 推荐度       | 说明                                          |
| -------- | ----------- | ------------ | --------------------------------------------- |
| 文档     | smartcanvas | ⭐⭐⭐ **首选** | 排版美观，支持丰富组件；MDX 格式兼容全部 Markdown 语法 |
| Excel    | sheet       | ⭐⭐⭐          | 数据表格专用                                  |
| PPT      | slide       | ⭐⭐⭐          | 幻灯片，演示文稿专用                          |
| 思维导图 | mind        | ⭐⭐⭐          | 知识图谱专用                                  |
| 流程图   | flowchart   | ⭐⭐⭐          | 流程展示专用                                  |
| Word     | doc         | ⭐⭐           | 传统格式，排版一般                            |
| 收集表   | form        | ⭐⭐           | 表单收集                                      |
| 智能表格 | smartsheet  | ⭐⭐⭐          | 高级结构化表格，支持多视图、字段管理          |

## ⚙️ 快速配置

首次安装使用时，需要先完成本地安装和注册，详见 `references/auth.md`。

## 🎯 场景路由表

根据任务场景，选择对应的参考文档：

| 场景 | 文档类型 | 参考文档                                                                                        |
|------|---------|---------------------------------------------------------------------------------------------|
| 报告、笔记、文章、总结等 | smartcanvas | `smartcanvas/entry.md`（MDX 格式，兼容全部 Markdown 语法）                                                                      |
| 结构化数据管理 | smartsheet | `references/smartsheet_references.md`                                                       |
| 计算、筛选、统计、Excel 操作 | sheet | `sheet/entry.md`（sheet.* 系列工具，已集成到 tencent-docs 中） |
| Word 文档编辑 | word (docengine) | `references/docengine_references.md`（doc.* 系列工具，已集成到 tencent-docs 中））                       |
| 论文、公文、合同等专业文档（作为docengine替补） | word (doc) | `doc/entry.md`                                                                              |
| PPT / 演示文稿 | slide | `references/slide_references.md`                                                            |
| 层次化知识整理 | mind | `references/diagram_references.md`                                                          |
| 流程/架构展示 | flowchart | `references/diagram_references.md`                                                          |
| 收集表 | form | `references/manage_references.md`（使用 manage.create_file，file_type=form；传入 space_id 可在空间内创建） |
| 知识库空间管理（空间/节点/文件夹） | — | `references/space_references.md`                                                            |
| 获取文档内容、

doc/doc_format/README.md

# 文本格式化模块

纯文本 → 结构化 XML → 样式美化的工程化流程。

---

## 文件结构

```
doc_format/
├── prompt/
│   ├── scenario_recognition_prompt.txt    # 场景识别 Prompt
│   ├── pure_text_system_prompt.txt        # 文本转 XML Prompt
│   └── style_customization_prompt.txt     # 样式解析 Prompt
└── templates/
    ├── general.json                        # 通用场景模板
    ├── paper.json                          # 学术论文模板
    ├── contract.json                       # 合同模板
    ├── essay.json                          # 作文模板
    ├── government.json                     # 公文模板
```

---

## 工作流程

你需要按照以下步骤完成文本美化任务：

### 步骤 1: 场景识别与标题生成

分析用户提供的文本内容，识别所属场景并生成文档标题。

**参考规则：** `prompt/scenario_recognition_prompt.txt`

**你必须输出给用户：**
```json
{
  "scenario": "场景标识",
  "title": "生成的标题（2-25字符）"
}
```

---

### 步骤 2: 样式自定义（可选）

**仅当用户明确提出样式要求时执行此步骤**，例如：
- "标题用初号黑体"
- "正文改成小四"
- "标题居中显示"

**允许样式：** 参考 `templates/{scenario}.json` 中的 `schema.children[].structure` 字段，必须为叶节点的样式。
**参考规则：** `prompt/style_customization_prompt.txt`

**你必须输出给用户（JSON 数组格式）：**
```json
[
  {
    "structureName": "Title",
    "fontSize": 42,
    "fontFamily": "黑体",
    "fontColor": "AE2E19",
    "alignment": 2,
    "lineSpacing": 1.5
  }
]
```

如果用户没有样式要求，此步骤不输出。

---

### 步骤 3: 文本转 XML 结构化

根据识别的场景，加载对应模板，将纯文本转换为结构化 XML。

**模板位置：** `templates/{scenario}.json`

**参考规则：** `prompt/pure_text_system_prompt.txt`

**你必须输出给用户：**
```json
{
  "xml": "<root>...</root>"
}
```

---

### 步骤 4: 调用套用 MCP 工具

使用 `tencent-docs` MCP Server 对应的 MCP 工具 `doc.ai_format_pure_text` 调用套用 API，传入前面步骤的结果，生成在线腾讯文档链接。

**MCP 工具参数：**
- `title`: 文档标题（步骤 1 的输出）
- `xml`: 格式套用后的文档 XML 结构（步骤 3 的输出）
- `scenario`: 模板场景（步骤 1 的输出）
- `customStyles`: 对文档的自定义样式（步骤 2 的输出，可选，需序列化为 JSON 字符串）

**最终输出文档链接给用户。**

## 注意事项

### JSON 序列化
文本中的引号必须正确转义：

❌ 错误：
```json
{"text": "合同（以下简称"本合同"）"}
```

✅ 正确：
```json
{"text": "合同（以下简称\"本合同\"）"}
```

_meta.json

{
  "ownerId": "kn71n4rrmmw7469qstfds7c2z181y79z",
  "slug": "tencent-docs",
  "version": "1.0.31",
  "publishedAt": 1777106706917
}

references/auth.md

# 腾讯文档鉴权检查

腾讯文档授权流程，**必须按以下步骤执行**：

## 第一步：检查状态（立即返回）

```bash
bash ./setup.sh tdoc_check_and_start_auth
```

| 输出 | 处理方式 |
|------|---------|
| `READY` | ✅ 直接执行用户任务，**无需后续步骤** |
| `AUTH_REQUIRED:<url>` | 向用户展示授权链接（见下方模板），**等待用户回复"已完成授权"后再执行第二步** |
| `ERROR:*` | 告知用户具体错误信息，并引导走**第三步人工兜底**手动设置 Token |

> ⛔ **严格禁止**：收到 `AUTH_REQUIRED` 后，必须先向用户展示授权链接，**等待用户发送新消息确认已完成授权**，才能进行第二步。

## 第二步：用户确认已完成授权后，主动查询 Token

> ✅ **触发条件**：用户在新消息中明确回复"已授权"、"完成了"、"已完成授权"、"授权好了"等确认信息后，**才执行本步骤**。

```bash
bash ./setup.sh tdoc_fetch_token
```

| 输出 | 处理方式 |
|------|---------|
| `TOKEN_READY` | ✅ 授权成功，继续执行用户任务 |
| `ERROR:not_authorized` | 告知用户：「您尚未完成授权，请在浏览器中完成后回复我。」（**不要重新生成链接**，等用户再次确认后重试本步骤） |
| `ERROR:expired` | 告知用户：「您的腾讯文档 Token 已过期，请访问 [获取新 Token](https://docs.qq.com/scenario/open-claw.html) 重新获取，然后告诉我新的 Token，我来帮您重置。」（引导用户走**第三步人工兜底**手动设置 Token） |
| `ERROR:token_invalid` | 告知用户：「Token 已失效，请重新授权。」（需重新执行第一步） |
| `ERROR:vip_required` | 告知用户：「当前操作需要腾讯文档 VIP 权限，请立即升级 VIP：[点击购买 VIP](https://docs.qq.com/vip?immediate_buy=1?part_aid=persnlspace_mcp)」 |
| `ERROR:*` | 告知用户具体错误信息（错误码+描述），并引导走**第三步人工兜底**手动设置 Token |

## 第三步：人工兜底

🔑 **检查 Token 配置**：可访问 [https://docs.qq.com/scenario/open-claw.html](https://docs.qq.com/scenario/open-claw.html) 获取 Token，再执行以下命令来设置mcporter:
```bash
# 使用传入的 Token 写入 mcporter 配置（tencent-docs）
mcporter config add tencent-docs "https://docs.qq.com/openapi/mcp" \
    --header "Authorization=$Token" \
    --transport http \
    --scope home
```

## 授权链接展示模板

当第一步输出 `AUTH_REQUIRED:<url>` 时，向用户展示：

> 🔑 **需要先完成腾讯文档授权**
>
> 请在**浏览器**中打开以下链接完成授权：**[点击授权腾讯文档]({url})**
>
> ⚠️ 请使用 **QQ 或微信** 扫码 / 登录授权
>
> ⏰ **授权链接有效期为 5 分钟**，请尽快完成授权，超时后需重新发起请求
>
> ✅ **完成授权后，请回复我「已完成授权」，我会继续帮您完成操作**

> ⛔ **AI 注意**：展示上方授权链接后，**必须停止等待**，不得自动调用 `tdoc_fetch_token` 或任何其他工具。只有当用户在下一条新消息中明确回复确认后，才能继续执行第二步。

## 错误说明

| 错误 | 含义 |
|------|------|
| `ERROR:mcporter_not_found` | 缺少依赖，请先安装 Node.js |
| `ERROR:not_authorized` | 用户尚未在浏览器完成授权，等待用户确认后重试 |
| `ERROR:expired` | 授权码已过期，重新执行第一步 |
| `ERROR:token_invalid` | Token 鉴权失败（400006），重新授权 |
| `ERROR:vip_required` | VIP 权限不足（400007），引导用户升级 VIP：https://docs.qq.com/vip?immediate_buy=1?part_aid=persnlspace_mcp |
| `ERROR:save_token_failed` | Token 写入配置失败 |
| `ERROR:no_code` | 未找到授权码，需重新执行第一步 |
| `ERROR:network` | 网络请求失败，检查网络后重试 |

references/diagram_references.md

# 图形化文档（思维导图 / 流程图）参考文档

本文件包含腾讯文档 MCP 中思维导图和流程图的创建工具说明。

---

## 工具列表

| 工具名称 | 功能说明 |
|---------|---------|
| create_mind_by_markdown | 通过 Markdown 创建思维导图 |
| create_flowchart_by_mermaid | 通过 Mermaid 语法创建流程图 |

---

## 工具详细说明

### 1. create_mind_by_markdown

#### 功能说明
通过 Markdown 创建思维导图，使用标题层级和列表嵌套表示结构。

#### 调用示例
```json
{
  "title": "产品功能规划",
  "markdown": "# 产品功能规划\n\n## 核心功能\n\n- 文档管理\n    - 创建文档\n    - 编辑文档\n    - 版本控制\n\n## 协作功能\n\n- 实时协作\n- 评论系统\n- 权限管理",
  "parent_id": "folder_1234567890"
}
```

#### 参数说明
- `title` (string, 必填): 思维导图标题
- `markdown` (string, 必填): 层次化的 Markdown 文本
- `parent_id` (string, 可选): 父节点ID，为空时在空间根目录创建，不为空时在指定节点下创建

#### 返回值说明
```json
{
  "file_id": "mind_1234567890",
  "url": "https://docs.qq.com/mind/DV2h5cWJ0R1lQb0lH",
  "error": "",
  "trace_id": "trace_1234567890"
}
```

---

### 2. create_flowchart_by_mermaid

#### 功能说明
通过 Mermaid 语法创建流程图。

#### 调用示例
```json
{
  "title": "用户登录流程",
  "mermaid": "graph TD\n    A[User Access] --> B{Logged in?}\n    B -->|Yes| C[Go to Home]\n    B -->|No| D[Go to Login Page]\n    D --> E[Enter Username and Password]\n    E --> F{Auth Success?}\n    F -->|Yes| C\n    F -->|No| G[Show Error Message]\n    G --> E",
  "parent_id": "folder_1234567890"
}
```

#### 参数说明
- `title` (string, 必填): 流程图标题
- `mermaid` (string, 必填): Mermaid 语法文本，支持中英文内容
- `parent_id` (string, 可选): 父节点ID，为空时在空间根目录创建，不为空时在指定节点下创建

#### 返回值说明
```json
{
  "file_id": "flow_1234567890",
  "url": "https://docs.qq.com/flow/DV2h5cWJ0R1lQb0lH",
  "error": "",
  "trace_id": "trace_1234567890"
}
```

---

## 注意事项

- 两个工具均支持 `parent_id` 参数，可将文档创建到指定目录；不填则在根目录创建

Related agents

Same protocol, similar job.

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 6mo 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 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "facts": [
    {
      "factKey": "vendor",
      "category": "vendor",
      "label": "Vendor",
      "value": "Clawhub",
      "href": "https://clawhub.ai/liyang58/skills/tencent-docs",
      "sourceUrl": "https://clawhub.ai/liyang58/skills/tencent-docs",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-09T01:42:33.692Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-liyang58-tencent-docs/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-liyang58-tencent-docs/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-10-09T01:42:33.692Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "20.1K downloads",
      "href": "https://clawhub.ai/liyang58/tencent-docs",
      "sourceUrl": "https://clawhub.ai/liyang58/tencent-docs",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-09T01:42:33.692Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "1.0.31",
      "href": "https://clawhub.ai/liyang58/tencent-docs",
      "sourceUrl": "https://clawhub.ai/liyang58/tencent-docs",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-04-25T08:45:06.917Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-liyang58-tencent-docs/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-liyang58-tencent-docs/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 1.0.31",
      "description": "tencent-docs 1.0.31 adds local file and web clip support, and clarifies rules for Markdown/MDX compatibility and file uploads. - 说明中新增了网页剪藏、本地文件/文档上云等能力 - 强化对 Markdown/MDX 格式的支持与兼容性说明，无需转换全部可用 - 本地文件保存/落盘等场景，明确优先走 import_file.sh → manage.async_import 统一上传链路，避免内容重组 - 用户保存/归档内容的场景，推荐使用 create_smartcanvas_by_mdx（美观且组件丰富） - 描述/路由表细节优化，突出 web 页面剪藏优先使用 scrape_url - 精简部分表述，提升易读性",
      "href": "https://clawhub.ai/liyang58/tencent-docs",
      "sourceUrl": "https://clawhub.ai/liyang58/tencent-docs",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-04-25T08:45:06.917Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 9, 2026.

Sponsored

Ads related to 腾讯文档 TENCENT DOCS and adjacent AI workflows.