星辰超级智能体TeleAgent（Linux版）

快速上手指南

文档定位：面向国产操作系统用户的安装部署指南

使用方式：安装前请先确认运行环境，安装时按步骤操作

版本记录

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

产品概述

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

我能为您做什么？

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

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

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

根据模版写一份党建PPT

整理报销单据并完成报销

一、 安装前准备

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，麒麟9000C……
内存	不低于8GB	建议16GB以上，运行更流畅
磁盘空间	不低于2GB可用空间	安装程序本身及工作空间缓存
网络	安装与登录均需联网

2、 安装包获取

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

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

二、 安装应用

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

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

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

常见问题：

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

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

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

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

2、 统信UOS桌面操作系统 V20

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

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

常见问题：

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

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

三、 启动与登录

1、 启动应用

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

2、 登录

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

四、 常用操作速查

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

查看更多功能使用指引，请查阅【产品操作手册】： 星辰超级智能体桌面版操作手册，TeleAgent，工作空间设置，@技能引用，MCP工具配置，AI智能体教程-天翼AI开放平台-中国电信

五、 常见问题排查

1、 安装类问题

问题现象	可能原因	解决方法
双击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微信客服渠道

2、 启动类问题

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

附录 后续使用指引

● 完整版操作手册：星辰超级智能体桌面版操作手册，TeleAgent，工作空间设置，@技能引用，MCP工具配置，AI智能体教程-天翼AI开放平台-中国电信