星辰超级智能体TeleClaw·桌面版

文档定位：面向日常使用者的场景化操作指南，覆盖90%的办公场景

目标用户：完成快速上手的新用户、日常使用者，及需自定义模型与MCP工具扩展的用户

使用方式：按需查阅，配置前必读，非通读型文档

查看快速上手指南：https://www.teleai.com.cn/doc/bKrLmQNepNQpUHjWEfqX/pUxSKj00HB5artzpBdgZ

查看场景化操作指南：https://www.teleai.com.cn/doc/CErwWndrjH5onUuHjTkA/g1dW5HWHuGx5IbLy4t5j

版本号	更新内容	更新时间
V1.0	文档创建	2026.3.23
V1.1.	文档更新	2026.4.1

遇到任何问题，欢迎加入星辰超级智能体TecleClaw用户群进行反馈

1.核心功能（日常高频使用）

本章说明：核心功能介绍，是理解星辰超级智能体高效场景和进阶配置的基础。如果您已经熟悉基本功能，可直接跳到【进阶设置】

1.1 工作空间设置

什么是工作空间？

工作空间本质是一个指定的文件夹。

• 超级智能体·桌面版可以读取和修改工作空间内的文件，读写工作空间外的文件需要您进行授权。

• 除非指定路径，所有任务生成的文件（报告、图表、处理后的数据等）均会保存在工作空间内

• 任务运行过程中，无法修改工作空间路径

  

如何更改工作空间？

1. 点击主界面输入框左下角文件按钮
2. 在弹出的文件夹选择器中，选择新的工作空间
3. 点击【选择文件夹】即可完成
   

** 补充说明**

• 任务运行时无法更改工作空间
• 工作空间内的重要文件建议提前备份

1.2 @文件和技能引用

1.2.1. @文件引用

指定本地文件作为任务处理的输入材料。注意：文件必须在工作空间内。

使用方法

• 方法1：按钮选择（推荐新手）。点击输入框内的【@】按钮，选择【文件】标签页，在文件列表中选择文件（支持搜索）自动插入到输入框
  
• 方法2：键盘输入在输入框中输入@+文件名进行搜索，选择匹配的目标文件
  

补充说明：

• 支持连续引用多个文件，示例：@文件1.xlsx @文件2.xlsx
• 支持跨文件夹引用：展开文件夹选择对应文件即可
• 若文件夹找不到我的文件，请检查文件是否在当前工作空间内，或点击输入区文件夹按钮修改工作空间路径

1.2.2. @技能引用

明确指定任务所需的AI能力，大幅提升技能被正确调用的概率。

使用方法

• 方法1：按钮选择。点击输入框内的【@】按钮，选择【技能】标签页，在技能列表中选择技能（支持搜索），自动插入技能指令到输入框
  
• 方法2：键盘输入在输入框中输入@+技能名进行搜索，选择匹配的技能
  

常用技能：

技能名称	适用场景	示例
AI新闻周报	自动追踪科技、创投、金融领域的热点资讯，智能提炼要点并生成每日/每周简报，一键获取来源、摘要、深度解读。	使用@AI新闻周报，给我每天推送一篇AI圈新闻
合同审核	智能审查合同文件，自动标注关键条款并添加批注。	使用@合同审核技能审核@XX合同，对其中的的风险点进行批注
创建网页小应用	快速创建网页小工具，如数据看板、计算器、表单等，支持复杂交互，一键生成即用。	使用@创建网页小应用，把XX信息做成可交互的的html数据看板
创意海报设计	快速制作会议海报、宣传展板、汇报封面等办公视觉材料	使用@创意海报设计技能帮我做一份宣传海报，用色大气科技感
文档辅写	高效完成各类文档写作、优化与结构化整理。	使用@文档辅写技能，帮我梳理XX文稿的逻辑，并形成结构化报告
图表绘制	通过自然语言即可生成各类专业图表与结构化图示。例如：流程图、思维导图等	使用@图表绘制技能，帮我以XX文件为基准绘制业务流程图
深度调研	能围绕用户指定主题自动开展深度调研，跨来源收集与分析信息，并输出结构化研究结果。	使用@深度调研技能，调研现有的桌面端智能体。
智能打印	面向日常办公打印场景，支持常见文档一键打印，并智能推荐打印机、份数、单双面和纸张参数。	使用@智能打印技能，帮我打印@XX文件

补充说明

• 支持连续引用多个技能
• 无明确指定时，系统会根据任务描述自动选择技能，但精准度低于手动@明确指定
• 若技能调用失败，请检查技能名称是否正确，或补充更详细的任务描述

1.3. 技能导入与管理

统一管理所有技能，支持从本地上传第三方技能（Skill）或从官方技能广场导入预制技能，完成安全审查后即可在任务中@调用。

1.3.1 技能设置

入口：主界面 → 设置 → 技能设置

1.3.2 上传第三方技能：

• 点击技能设置页中的【添加】按钮，选择【导入技能】选项

--文件要求

-支持 .zip、.skill 格式

-根目录下必须包含 SKILL.md 文件

-SKILL.md 需以 YAML 格式编写技能名称和描述

--技能导入状态判断

• 格式正确则导入到列表，显示“审查中”状态
• 后台并行执行安全扫描 + MCP工具依赖检测
• 审查完成：显示“已通过安全检查”，技能可通过@键使用

--示例： 星辰慧记离线音频转写Skill（offline-asr）的导入和使用步骤：

星辰慧记离线音频转写 主要提供以下能力：

• 音频转写：将会议录音内容自动转换为文本。
• 会议总结：自动提取会议重点、核心讨论内容和结论。
• 纪要生成：输出结构化会议纪要，方便整理和归档。
• 多场景适用：适用于会议、访谈、讨论、复盘、培训等音频内容处理。

支持的格式：wav、mp3、m4a、pcm

Skill文件：https://drive.weixin.qq.com/s?k=ACoAuwc-AF8V0a070DAVsA6Aa-AKs

导入步骤：

• 依次点击：设置 - 技能设置 - 添加工作技能 - 导入技能；
• 在导入技能弹窗中上传
• 回到对话界面，点击【@】，选择【技能】标签页，在技能列表中选择【offline—asr】技能，自动插入技能指令到输入框；再在输入框中输入【请输出】【@】选择【文件】标签页选择匹配的音频文件【的会议纪要】，点击【发送】按钮发送此任务。完成query：使用 @offline—asr 技能 对要别的音频文件 进行识别，输出纪要

1.3.3添加官方技能

1. 点击技能设置页中的【添加】按钮，选择【添加官方技能】选项，进入官方技能广场
2. 点击【+添加】后技能立即可用，显示"官方认证"标签

1.3.4 技能启用管理

• 点按技能右侧的开关，可对技能进行启用/禁用

• 启用规则

  • 启用后技能可在 @技能弹窗中被调用
  • 同时启用的技能上限为 50 个

• MCP依赖检测

  • 缺少MCP工具时，技能卡片显示警告："⚠️ 缺少MCP工具: xxx"
  • 尝试启用时弹窗提示，点击"前往安装MCP工具"跳转到工具设置页

1.3.5 了解详情

• 点击技能卡片的【⋯】按钮，选择【了解详情】
• 输入框自动填充介绍技能的提示词，点击发送
• 智能体主动输出技能的使用方式与使用流程图

1.4. 模型切换

不同模型有不同的能力优势，可根据任务类型快速切换适配模型。

使用方法

主界面快速切换: 点击主界面右下角的模型切换按钮，在下拉列表中选择目标模型

补充说明

• 任务过程中无法切换模型，切换成功后，下次任务将使用新模型。

1.5. 定时任务

定时任务是一种自动化任务调度功能，允许您提前配置任务内容、执行时间和频率，系统将在指定时间自动执行任务。适用于定期数据汇总、周报生成、定期文件处理等重复性工作。

1.5.1 表单创建：

1. 点击设置模块菜单栏中的【定时任务】菜单，进入定时任务管理页面
2. 点击【新增定时任务】按钮（可同时启用10个定时任务，定时任务配置数量没有限制）
3. 在弹出的配置表单中填写任务信息
4. 选择【仅保存】或【保存并试运行】

1.5.2 自然语言创建：

1. 任意时刻，向星辰超级智能体发送定时任务需求（如“我要在每天上班时间收到今天的AI新闻”）
2. 在智能体对话组件中，澄清确认你的定时任务需求
3. 回复“确认”保存定时任务。

1.6 定时任务管理

在定时任务管理页面查看所有已配置的任务，可以编辑并控制价定时任务的启用/停用。

补充说明

● 请确保软件在定时任务执行时间处于运行状态，否则任务将被跳过

1.7 授权机制

当系统需要执行修改类操作时，需要用户明确授权，保障操作安全。

当工具需要授权时，会显示【等待授权】状态，提供三个选项：

选项	含义	适用场景
允许一次	仅授权本次操作	信任此次操作，但不想授权整个任务
一直允许	整个任务的后续操作都自动授权	任务需要多次修改操作，不想重复授权
拒绝	拒绝本次操作	操作不符合预期，不想执行

补充说明：

• 工具执行时间不包含等待决策的时间
• 拒绝授权后，系统会跳过该操作，继续完成其他可执行部分

1.8 预设任务卡片

预设任务是常见场景的标准化解决方案，提供任务提示词模板，帮你快速生成规范的任务指令。

使用方法：

1. 在主输入框下方查看预设任务卡片，点击需要的预设任务
2. 系统弹出提示"当前输入框已有内容，确定要覆盖吗？"
3. 点击【确认】把预设任务提示词填入主输入框

补充说明：

• 点击预设任务会覆盖输入框中已有内容
• 预设任务提示词可需要根据实际需求调整

1.9 任务状态与监控

1.9.1. 任务状态说明

状态	含义	触发条件
运行中	任务正在执行	提交任务后，AI正在处理
已完成	任务执行完成	AI完成所有操作
需介入	需要用户介入	等待授权、需要用户选择等
已暂停	任务暂停	用户手动暂停或系统暂停（如更新）

1.9.2. 任务监控区域查看

对话区会展示任务全流程内容，各模块说明如下：

显示内容	说明
用户消息	用户输入的任务描述
常规输出	系统的回复内容
深度思考	系统的推理过程
操作执行	工具调用过程
任务委派	子智能体任务执行过程

2.进阶设置

2.1. 模型设置

• ** 用途：** 通过API配置第三方模型，扩展AI模型能力，适配更多专属场景。
• ** 配置通用说明：**
  • 自定义模型通过API Key与API URL连接第三方模型服务，需确保API兼容OpenAI格式

2.1.1. 添加其他第三方模型

适用场景：需要使用其他第三方模型的特定能力，支持智谱GLM、DeepSeek、MiniMax、Kimi等主流厂商模型

配置步骤：

1. 进入【设置】→【模型设置】
2. 启用自定义模型：找到AI提供商，点击【可用】，展开模型列表
3. 填写配置信息
4. 找到对应厂商，点击【输入API密钥】按钮，输入有效的API Key
5. 保存并验证。点击【✅️】按钮确认，系统自动调用API验证配置，验证成功后，模型自动移动至已配置下方，状态显示为【已配置】

验证方法：

1. 返回主界面，点击右下角模型切换按钮
2. 确认下拉列表中显示【所选择的模型名称】
3. 执行简单任务，验证模型可用

2.1.2. 模型配置安全与性能建议

安全建议：

• 不要在公共场合分享API Key
• 定期更换API Key
• 为不同的项目使用不同的API Key（如支持）
• 监控API调用次数和费用

性能建议：

• 根据任务类型选择合适的模型，定期检查API调用额度
• 简单任务使用官方模型，节省费用
• 复杂任务使用高级模型，提升质量
• 定期检查API调用额度

2.2. 工具设置

本节将向您展示如何在日常工作流程中将 MCP工具 与 星辰超级智能体结合使用。

何时应该使用 MCP工具？

以下情况可使用 MCP工具：

• 已有 MCP 工具，且您不想构建星辰超级智能体原生工具
• 希望星辰超级智能体通过干净的 RPC 层操作本地或远程系统
• 希望在不修改星辰超级智能体核心的情况下将星辰超级智能体连接到内部 API、数据库或公司系统

以下情况不建议使用 MCP工具：

• 星辰超级智能体内置工具已能很好地完成任务
• 服务器暴露了大量危险的工具，而您没有做好过滤的准备
• 您只需要一个非常小的集成，原生工具会更简单、更安全

在连接MCP工具前，您应有的核心理解：

• MCP 是一种适配器，星辰超级智能体是您的代理，MCP 服务器为它提供工具。
• 星辰超级智能体在启动或重新加载时，通过配置文件知道这些工具，在工作中使用它们。
• 良好的 MCP 使用方法并非“连接所有东西”，而是“连接正确的东西，并尽可能减少有效访问范围”。

2.2.1 工具添加

1.点击【设置】-【工具设置】-从JSON导入/添加

2.添加一个安全的服务器。

例如：简单的数学运算服务器。

{
  "mcpServers": {
    "math-server": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-everything"
      ]
    }
  }
}

MCP 配置文件 (JSON) 标准规范： 配置文件采用标准 JSON 格式，根对象必须包含 mcpServers 键，其值为一个对象，其中每个键代表一个独立的 MCP 服务。

字段详细定义

字段名	类型	必填	说明	示例
mcpServers	Object	是	所有 MCP 服务的配置入口。	{ "server-id": { ... } }
	Key	是	服务的唯一标识符。建议使用小写字母、数字或连字符。	math-server
command	String	是	启动该服务的主程序路径或可执行命令。	npx, python, node
args	Array	是	传递给 command 的命令行参数列表。	["-y", "@mcp/server"]
env	Object	否	注入服务进程的环境变量（如 API Keys）。	{ "API_KEY": "sk-xxx" }

（如果您想要连接Notion，Figma等应用，它们通常会提供连接MCP的文档，您可以将文档提供给星辰超级智能体，并输入以下提示词：@您的对应文档，根据这份连接MCP的官方文档，给我写一份连接MCP用的JSON格式代码，只需要生成mcp_servers 内部的对象部分。）

3.验证 MCP 是否已加载

配置完成后，对应MCP出现绿色的“已连接”标识，点击编辑可以修改MCP连接，点击删除可以删除MCP。点击首页的MCP按钮，可以看到正在使用的MCP。

• 连接/断开工具
  在工具列表中找到目标工具，点击【连接】或【断开】按钮，等待状态更新
• 编辑工具
  点击工具的【编辑】按钮，在弹出的编辑器中修改配置，点击【保存MCP服务器】验证
  注：工具名称修改后，历史任务可能无法正确引用

3.系统设置

3.1 语言与外观设置

• 语言切换：支持中英文切换。

进入【设置】→【语言设置】，找到【中英文切换】下拉框，选择目标语言

• 外观切换：支持浅色模式、深色模式、跟随系统三种主题。

进入【设置】→【外观设置】，找到【系统外观】下拉框，选择目标主题，应用自动实时生效新主题

3.2 通知设置

进入【设置】→【通知设置】，可配置以下内容：

• 【开启通知】开关：开启/禁用所有系统通知
• 【声音提醒】开关：通知弹出时是否播放提示音（仅全局通知开启时可配置）

通知类型

通知类型	触发条件
任务完成通知	任务状态从"运行中"变更为"已完成"
任务暂停通知	任务状态从"运行中"变更为"已暂停"
需人工介入通知	任务状态从"运行中"变更为"需介入"

3.3 账户信息

退出登录：

进入【设置】→【账户信息】，下拉至底端，点击【退出登录】，弹窗二次确认后完成退出

修改账户信息：

进入【设置】→【账户信息】，点击【修改个人信息】，自动打开浏览器，跳转至天翼 AI 开放平台，在网页端完成账户信息修改

4.故障排查与系统维护

4.1 常见问题快速排查

4.1.1 任务执行类问题

问题1：任务卡在"等待授权"状态

• 现象：工具卡片显示"等待授权"，长时间无响应
• 可能原因：用户未及时处理授权请求，或授权请求被遮挡
• 诊断方法：展开对应工具卡片，查看是否有授权选项

解决方法：

找到显示"等待授权"的工具卡片，选择【允许一次】、【一直允许】或【拒绝】

问题2：任务执行失败

• 现象：任务状态显示"已暂停"，或显示"已完成"但结果不正确
• 诊断方法：点击任务查看详情，展开折叠组件（深度思考、操作执行、任务委派），查找错误信息或警告，根据错误类型，对应处理：

错误类型	表现	诊断方法	解决方法
文件操作失败	工具卡片显示文件写入/读取失败	检查文件是否存在、是否有权限工作空间路径是否正确	确保文件在工作空间内，检查文件是否被其他程序占用
技能调用失败	工具卡片显示技能调用失败	检查技能调用日志，确认技能是否被正确识别	使用@符号明确指定技能，如"使用@电子表格处理技能“
工具调用失败	工具卡片显示工具连接失败	检查工具连接状态，查看工具卡片错误信息	重新连接工具，检查工具配置是否正确
模型调用失败	工具卡片显示模型请求失败	检查模型配置，查看API调用日志	检查API Key是否正确，检查API调用额度，检查网络连接
网络搜索失败	工具卡片显示搜索失败	检查网络连接	恢复网络

问题3：任务执行速度慢

• 现象：任务执行时间远超预期，工具调用耗时过长
• 诊断与解决方法：

检查项	说明	正常范围	解决方法
文件大小	检查文件是否过大	建议<100MB	大文件建议拆分处理
任务复杂度	检查任务是否过于复杂	-	复杂任务建议拆解为多个子任务，分步执行
网络延迟	检查网络连接	建议<100ms	检查网络连接质量，切换稳定网络
模型响应	检查模型API响应时间	建议<5s	切换响应更快的模型，如官方基础模型

4.1.2 工具与模型配置类问题

问题1：MCP工具连接失败

• 现象：工具列表显示"已断开"，点击【连接】后仍失败，连接测试不通过
• 诊断与解决方法：
  1. 打开工具编辑页面，检查JSON配置是否正确，必填项是否完整填写
  2. 检查本地网络连接是否正常，API服务器是否可访问，防火墙是否拦截连接

问题2：API Key 填写错误

• 现象：配置时输入 API Key 错误，保存后提示验证失败或密钥无效
• 诊断与解决方法：
  1. 重新进入模型设置页面，找到 API Key 输入项
  2. 删除原有错误密钥，重新准确填写正确的 API Key
  3. 点击保存，系统将自动重新进行密钥验证

问题3：模型设置验证失败

• 现象：模型设置显示"未配置"或"配置失败"，保存后验证不通过
• 诊断与解决方法：
  • 检查 API Key：确认 Key 是否正确、是否过期、账户是否有可用调用额度
  • 检查网络连接

问题4：模型切换后未生效

• 现象：切换选择模型后，调用仍使用原模型，设置未生效
• 诊断与解决方法：
  • 检查是否在首页完成模型切换
  • 确认选择后刷新页面或重新发起任务，使模型设置生效

4.2 日志打包与问题反馈

4.2.1 日志打包

当遇到无法自行解决的问题，需要技术支持排查时，可按以下步骤打包日志：

1. 打开应用，点击左侧栏底部【设置】按钮
2. 在左侧菜单中选择【关于】
3. 找到【日志打包】按钮并点击
4. 在弹出的任务列表中，选择运行日志或需要排查的目标任务日志（支持多选）
5. 点击【打包到桌面】，系统自动打包运行日志，生成.zip 格式的日志包
6. 日志包命名格式：logs-[时间戳]-[任务 ID].zip

4.2.2 问题反馈方式

技术支持邮箱：superagent@chinatelecom.cn

反馈时间：工作日 8:30-17:30

问题反馈流程：

1. 自查：查看本手册的【故障排查与系统维护】章节
2. 收集信息：记录错误信息、系统信息、任务ID
3. 打包日志：使用日志打包功能
4. 发送邮件：使用问题反馈模板
5. 等待回复：技术支持会在1-2个工作日内回复

邮件模板：

• 主题：【问题反馈】[问题类型] [简要描述]
• 问题描述： 详细描述问题现象
• 复现步骤：分步骤说明如何触发该问题
• 期望结果：期望的正常执行结果
• 实际结果：说明实际发生的错误结果
• 系统信息：
  • 操作系统：[Windows/macOS]
  • 版本号：[Vx.x.x]
  • 任务ID：[如有]
  • 日志包：附上日志包.zip文件
• 联系方式： [姓名] [电话] [邮箱]

4.3 系统维护

版本更新

• 自动更新机制：系统每隔30分钟自动检查新版本，发现新版本后后台自动下载，更新前会提示确认
• 更新注意事项：
  1. 运行中的任务会自动暂停，建议在空闲时执行更新
  2. 更新前建议备份工作空间内的重要文件
  3. 版本更新内容可查看【设置】→【关于】，点击【版本更新日志】

附录 快速参考

常用技能、快捷键、任务模板的快速查阅表格，方便日常使用时快速查找。

1. 常用任务模板

• 数据分析模板：基于@数据文件，分析[分析维度]，生成包含[图表类型]的分析报告，输出格式参考@模板文件
• 文档撰写模板：基于@参考资料，撰写[文档类型、使用场景]，包含[内容结构]，字数约[数字]字，风格参考@范文
• PPT制作模板：基于@大纲文档，制作[数字]页PPT，内容包括[如：市场分析、功能对比、技术方案对比]，风格参考@模板
• 深度调研模板：调研[调研主题]，搜索[时间范围]的信息，关注[信息类型]，输出[报告类型]
• AI新闻周报模板：@AI新闻周报，结合网页搜索工具对近期AI新闻进行搜索汇总，形成周报
• 合同审核模板：@合同审核技能，对[要审核的合同]进行审核
• 创建网页小应用模板：@创建网页小应用技能，写一个[要开发的主题]系统网页，需要包括[关键模块]

● 查看更多任务示例，请参考【场景化操作指南】：星辰超级智能体·桌面版-场景化操作指南

2. 常用操作速查

想做什么	操作	示意图
新建任务	点击左上角【新建任务】
添加文件	输入框内点击【@】→ 选择文件
使用技能	输入框内点击【@】→ 选择技能
查看历史	左侧任务栏点击历史任务
更改工作空间	点击工作空间路径旁的文件夹图标