JClaw用户使用文档

面向平台用户的入门指南，介绍 JClaw 平台的基本使用方法，以及平台当前提供的两个智能体服务：OpenClaw 和 Hermes。

1. 平台简介

JClaw 是一个 AI 智能体托管平台。平台基于 jAccount 实现统一身份认证，为每位用户自动创建独立、隔离的个人工作环境（容器），并提供可直接通过浏览器访问的智能体服务。

2. 登录与账号

打开平台入口地址（ https://agents.sjtu.edu.cn）。
点击「JAccount 登录」按钮，跳转到上海交通大学 jAccount 统一身份认证 页面。
输入您的 jAccount 账号与密码完成登录。
登录成功后自动返回平台首页。

新注册账号需管理员审批后才能正常使用，审批结果会通过交我办消息渠道告知。

3. 首页与智能体服务

登录后进入平台首页，页面主要包含：

平台名称与简介：展示平台名称（JClaw）及定位说明。

智能体服务卡片：列出当前可用的服务，每张卡片包含服务图标、名称和简介，如：

卡片	图标	说明
OpenClaw	🦞	AI 智能体对话服务，内置办公、生信、论文评审等多个智能体
Hermes	☤	自进化 AI 智能体，提供 OpenAI 兼容 API 接口

顶部导航栏包含「首页」「文件」「终端」「账号」等入口（以实际页面为准）。

4. 服务生命周期管理

4.1 首次使用（创建）

在首页点击某个服务卡片（如 OpenClaw 或 Hermes）。
点击启动，平台会自动创建属于您的独立服务实例。
首次创建需要拉取镜像或初始化环境，请耐心等待，一般需要几分钟。
页面会显示状态变化

状态	含义	您需要做什么
`pending` / `starting`	容器启动中	等待
`running` / `healthy`	服务已就绪	点击入口按钮开始使用
`stopped`	服务已停止	点击「启动」恢复
`not-found`	服务实例尚未创建	点击「启动」创建

4.2 开始使用

服务就绪后，页面会显示可用的入口按钮，例如：

OpenClaw：配置面板、聊天界面
Hermes：配置面板、聊天界面

点击对应按钮即可在页面中打开该入口，浏览器标签页之间可以同时打开多个入口。

4.3 停止 / 重启 / 销毁

点击顶部导航栏的「账号」，点击下拉的服务管理，能够对个人服务进行管理。

停止（Stop）：停止服务实例运行。停止后可再次启动，数据和配置仍然保留。
重启（Restart）：重新启动服务实例，用于服务异常或刷新环境。
销毁（Destroy）：销毁当前实例。销毁后个人工作区数据（workspace）仍然保留，下次启动时会自动恢复到新的实例中。

提示：服务资源紧张，请及时销毁不再使用的服务实例，节省资源配额。

5. 智能体入口说明

平台中的每个服务可能包含多种入口类型：

导航栏入口

入口名称	用途
终端	网页版命令行终端，可直接在容器中执行命令
文件管理	查看和上传工作区文件

服务入口

入口名称	用途
聊天界面	与智能体对话的网页界面，日常使用的主要入口
配置面板	管理模型、渠道、API Key、插件等配置

不同服务提供的入口不同，以实际页面展示为准。

6. 智能体一：OpenClaw

6.1 服务简介

OpenClaw（🦞，内部代号"龙虾"）是一个 AI 对话智能体服务，支持多模型、多智能体切换与插件扩展。

6.2 首次使用步骤

在首页点击 OpenClaw 卡片。
点击启动，等待状态变为 运行中 。
建议先打开 配置面板（主入口）完成初始化：
- 配置模型 API Key，必须；
- 需要接入的消息渠道（如飞书等），非必须；
- 首次进入时面板会显示初始化向导，按提示完成即可。
回到首页打开 聊天界面 开始对话。

6.3 内置智能体预设

OpenClaw 预置了多个垂直领域智能体，根据使用场景选择：

① 办公小龙虾（sjtu-workassistant）

面向上海交通大学相关行政事务的办公助手，适合处理：

校内通知、公文、函件的起草与润色
邮件撰写与回复
会议纪要与会议安排
工作报告、总结、SOP、FAQ 等办公文档
与学校各院系/部门的办事流程有关的信息整理

使用建议：尽量提供真实的背景信息（如部门名称、场合、接收对象），并明确输出格式（如"请输出正式的通知格式"）。

② 生信小龙虾（bioinformatics）

面向生物信息学与科研计算的专业智能体，适合处理：

基因组学、转录组学、单细胞与空间组学的分析流程设计与代码编写
序列分析、注释、变异解读
生物医学数据库查询、工具选型
差异表达分析（如 pydeseq2）、统计建模与机器学习
文献检索、综述整理、论文图表的绘制

使用建议：分析前明确告知物种、组织/细胞类型、测序类型（如 scRNA-seq）、参考基因组版本和数据所在路径，能得到更可靠的分析方案。

7. 智能体二：Hermes

7.1 服务简介

Hermes（☤，来自 Nous Research）是一个自进化 AI 智能体服务。它以 gateway 模式运行，向用户暴露：

配置面板：配置模型 API Key 与消息渠道；
聊天界面：查看服务运行状态、日志与会话信息。

7.2 快速开始

在首页点击 Hermes 卡片。
等待状态变为 运行中 。
打开 配置面板，配置：
- 模型服务商的 API Key，必须；
- 需要接入的消息渠道（如飞书等），非必须；
- 首次进入时面板会显示初始化向导，按提示完成即可。
之后可以通过 聊天界面 使用服务。

8. 常见问题

Q1: 打开服务后页面一直显示"启动中"

服务启动需要时间，请等待 1–2 分钟后刷新页面。如果长时间无响应，请尝试停止后重新启动服务。

Q2: 点击"聊天界面"无法打开

请确认服务状态为 运行中 ，并且您的浏览器没有拦截弹窗或新标签页。也可以使用页面上的"独立打开"链接在浏览器新标签中访问。

Q3: 服务被销毁后数据会丢吗？

个人工作区数据（workspace）会被保留，下次启动服务时会自动恢复。但服务实例本身的运行时配置（如临时安装的软件包）不会保留，需要重新安装。

Q4: 可以对其他用户造成影响吗？

不可以。每个用户的容器都是独立隔离的，您只能看到和管理自己的服务实例。

Q5: 用完了怎么处理？

建议不再使用时，请及时销毁服务实例，释放资源配额。

9. 附录

9.1 术语表

术语	含义
服务实例（Container）	平台为单个用户创建的独立运行环境
工作区（workspace）	用户的数据目录，销毁实例后仍然保留

9.2 需要更多帮助？

平台使用问题：联系平台管理员，computing@sjtu.edu.cn。
智能体使用技巧：在聊天界面中直接向智能体提问即可。