快速上手指南

文档定位：TeleAgent新用户首次使用指南，让您在5分钟内完成第一次成功任务

阅读目标时间：5分钟

产品概述

星辰超级智能体TeleAgent，一键安装在个人电脑上的Agent产品，能干可靠的AI办公搭子。

我能为您做什么？

完成一份商务合作统计表并做成html互动网页

撰写一份行业大会发言稿并打印出来

对某个新政策进行集中调查研究，监测和挖掘商机

根据模版写一份党建PPT

整理报销单据并完成报销

1.安装

下载地址 ：https://www.teleai.com.cn/product/teleagent

安装要求 ：您的windows系统版本应不低于windows10（Windows Server 版本不低于 2016），mac系统版本应不低于macOS 13（Mac OS版本不低于MacOS 13 Ventura）。

1.1 Windows用户

1)打开上述下载地址，选择适合的版本进行下载（如遇浏览器安全警告，请参考下文【常见问题】）

2)下载完成后，双击下载安装包进行安装

3)选择安装用户及安装位置，等待完成

4)完成后启动应用

首次使用需要授权网络访问，在下图弹窗选择「允许」。

1.2 Mac用户

1).打开上述下载地址，选择适合的版本进行下载

2).双击.dmg文件，将应用图标拖到Applications文件夹

• 完成后即可启动应用

1.3 Linux与信创用户

1.3.1 安装前环境要求

	要求	说明
操作系统	银河麒麟桌面操作系统 V10 SP1（2203及以上，建议2503）统信UOS桌面操作系统 V20（1050及以上，建议1070）
CPU	Intel/AMD/海光/兆芯(x86_64)鲲鹏/飞腾(ARM 64)	具体支持国产CPU型号：兆芯 KX-U6780A、KX-7480、KX-7680，海光3350、3450，飞腾D2000、D3000、D3000M，鲲鹏 920S……
内存	不低于8GB	建议16GB以上，运行更流畅
磁盘空间	不低于2GB可用空间	安装程序本身及工作空间缓存
网络	安装与登录均需联网

1.3.2 安装包获取

在星辰超级智能体桌面版 TeleAgent - 中国电信自研AI办公助手-天翼AI开放平台-中国电信可下载信创安装包。

*下载后请先核对文件名后缀是不是 .deb，文件大小是否正常，确认拷贝未损坏。

1.3.3 安装应用

银河麒麟桌面操作系统V10 SP1

1. 下载完成后，双击运行.deb安装包。
2. 安装器打开后点击"一键安装"，等待完成。（如遇拦截警告，请参考下文【常见问题】）

3. 完成后点击“确认”即可完成安装。

常见问题：

Q：双击安装没反应怎么办？

A：在安装包上点击右键【打开方式】-【安装器】。

Q：安装时麒麟安全中心弹出拦截提示【您正在安装未知来源应用"teleagent"】怎么办？

A：点击"允许安装"即可。这个拦截只在首次安装时出现，后续更新版本不再出现。

统信UOS桌面操作系统 V20

1. 下载完成后，双击运行.deb安装包。
2. 安装器打开后点击安装，等待完成。

3. 安装成功后点击“完成”即可完成安装。

常见问题：

Q：双击安装没反应怎么办？

A：在安装包上点击右键【打开方式】-【软件包安装器】。

1.3.4 启动与登录

启动应用

点击屏幕左下角的开始菜单/启动器菜单，找到TeleAgent，鼠标左键单击启动

登录

启动后弹出登录窗口，按引导完成手机号/账号登录，即可开始使用啦！

1.3.5 常见问题排查

安装类问题

问题现象	可能原因	解决方法
双击deb包没反应	默认打开方式不对	右键选"用软件安装打开"，或终端 dpkg -i命令安装
提示依赖缺失	系统缺运行库	终端执行 sudo apt install -f 自动补齐依赖
安装中途报错退出	安装包损坏或权限不够	重新下载deb包进行安装
麒麟一直弹"未知来源"拦截	安全策略没放行	到麒麟安全中心把 teleagent 加进信任名单
安装成功但搜不到程序	.desktop文件没生成

安装失败类问题

1. 收集系统信息

打开"终端"，执行以下命令：

uname -a
uname -m
cat /etc/os-release
echo "桌面会话：$XDG_SESSION_TYPE"
echo "DISPLAY=$DISPLAY"
echo "WAYLAND_DISPLAY=$WAYLAND_DISPLAY"
ldd --version | head -n 1

截图保存这些输出，并确认安装包架构匹配：

• x86_64：使用 amd64/x86_64 安装包
• aarch64 或 arm64：使用 arm64 安装包

如不匹配，更换安装包后重试

2. 检查是否限制了应用安全

• UOS: 安全中心 → 安全工具 → 应用安全 → 允许任意应用

• Kylin：安全中心 → 应用保护 → 允许安装任意来源的应用程序

3. 如执行前两步无效

提供您的系统信息，截图安装失败的报错日志，点击联系客服进行反馈TeleAgent微信客服渠道

启动类问题

问题现象	解决方法
程序启动后白屏或闪退	一般是显卡驱动问题，更新系统显卡驱动到最新版；或终端启动看报错日志。
登录后卡在加载界面	一般是网络问题，检查网络连接；若有代理需把相关域名放行。
收不到验证码	核对手机号是否填错、手机信号是否正常，60秒后重试；若仍失败请联系客服。

双击应用无反应、启动后闪退

1.排查 GPU 和桌面协议

a. 强制 X11并禁用 GPU

打开“终端”，执行以下命令

GDK\_BACKEND=x11 ELECTRON\_ENABLE\_LOGGING=1 teleagent \\--ozone-platform=x11 \\--disable-gpu \\--disable-gpu-sandbox \\--enable-logging=stderr \\--v=1 \\2>&1 | tee "\$HOME/teleagent-diagnostics/startup-x11.log"

如果这样可以打开，通常说明问题与 Wayland、GPU 或显卡驱动有关。

b. 检查缺失的动态库

TELEAGENT_PATH="$(readlink -f "$(command -v teleagent)")"
ldd "$TELEAGENT_PATH" | grep 'not found'

如果有输出，表示发现缺失的动态库，请截图后联系TeleAgent客服

TeleAgent微信客服渠道

2.生成并导出系统日志文件

# 1. 允许当前终端生成 core 文件
ulimit -c unlimited

# 2. 查看机器当前 core 保存规则
cat /proc/sys/kernel/core_pattern

然后进入一个有写权限的目录启动程序：

mkdir -p ~/teleagent-corecd ~/teleagent-core

ulimit -c unlimited
teleagent --enable-logging=stderr --v=1

应用发生错误后，该目录会生成类似：core.teleagent.284594.1786085654 的文件

执行以下命令打开目录，找到该文件联系客服，上传该文件

TeleAgent微信客服渠道

xdg-open "$HOME/teleagent-core"

白屏、闪退、卡死、界面异常等问题

1. 重启电脑，如果重启后可正常运行 APP

左下角头像-设置-关于-日志打包，日志文件会自动打包在桌面，联系TeleAgent客服并上传日志TeleAgent微信客服渠道

2. 重启后仍无法正常运行，手动导出应用日志

打开“终端“，执行以下命令打包：

tar --ignore-failed-read -czf \"$HOME/teleagent-diagnostics/teleagent-logs.tar.gz" "$HOME/.config/TeleAgent/logs" "$HOME/.local/share/TeleAgent/log" "$HOME/teleagent-diagnostics/startup.log" "$HOME/teleagent-diagnostics/startup-x11.log" "$HOME/teleagent-diagnostics/startup-wayland.log"

最终文件为：~/teleagent-diagnostics/teleagent-logs.tar.gz

执行以下命令开启日志目录，找到该文件，联系TeleAgent客服并上传文件TeleAgent微信客服渠道

xdg-open "$HOME/teleagent-diagnostics"

2.任务执行

点击头像浮窗，可以进行各类快捷操作，查看会员状态，积分情况，快速进入设置

1).认识工作空间+准备文件

当您首次进入星辰超级智能体桌面版时，您将看到如下界面：

请将示例文件销售订单明细数据表.xlsx下载并存入工作空间文件夹（默认工作空间为C:\Users[用户名].local\share\TeleAgent\TeleAgent的工作空间），我们将在此工作空间开始您的第一个任务。

(如果您找不到这个文件夹，在桌面上新建【星辰超级智能体的工作空间】，并把需要操作的文件放在文件夹里，在发送指令前选择该文件夹作为工作空间即可)

2).输入指令

将以下指令复制并粘贴到输入框中：

分析 @销售订单明细数据表.xlsx 中的销售数据，重点关注地区分布和利润结构，并生成一份包含核心数据洞察的分析报告。

常见问题

Q：我的文件没有高亮显示怎么办？

A：有两种方式可以让星辰超级智能体引用您的文件：

方法1：在输入框中输入 @ 符号，选择对应的文件

方法2：点击输入框底部的回形针按钮，从文件列表中选择

3).执行任务

点击右下角【发送】按钮，等待系统处理。当对话区出现"任务已完成"提示时，即代表任务执行成功。

4).查看结果

打开工作空间文件夹（例如：C:\Users\[用户名].local\share\TeleAgent\TeleAgent的工作空间），查看生成的分析报告。

接下来您可以做什么

● 试试这些任务？

以下为您提供3个实用任务示例，帮助您快速掌握更多用法：

任务类型	示例指令	文件下载	注意事项
报销辅助	帮我整理医疗补充保险的发票信息，并填写本次报销所需的文件@基金个人授权书。报销所需的发票在压缩包@发票.zip中，请先解压并识别发票信息，然后将相关信息填写到授权书中。注意：刘备是我的父亲，身份证号是10000000000000。	基金个人授权书.docx发票.zip	/
深度调研+网页开发	近期AI Agent技术快速发展，其中 OpenClaw 作为热门开源项目受到行业高度关注。用户希望系统性了解该项目的技术架构、产品定位及行业影响，并形成一份具有研究深度的分析报告，做成可以互动的html格式，为企业技术规划和产品决策提供参考。	/	/
周报合并	帮我把@文件夹下的15份周报，合并成一份，要有重点，不要长篇大论；其中重点业务方向为：智能体平台产品建设、重点项目进展；	周报合并.zip	文件下载后，建议解压上传

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

常见问题

Q: 想学习更多用法？

A: 查看《用户操作手册》获取更多进阶操作指南

星辰超级智能体·桌面版操作手册

Q: 需要配置新模型？

A: 查看《用户操作手册》的【进阶配置】章节

星辰超级智能体·桌面版操作手册

Q: 任务总是失败？

A: 查看《用户操作手册》的【故障排查】章节获取解决方案

星辰超级智能体·桌面版操作手册

常用操作速查

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

● 查看更多功能使用指引，请查阅【产品操作手册】：星辰超级智能体·桌面版操作手册

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