第一次使用指南

一键安装智能体教程

安装完成后，先确认三件事：能打开工具、能得到 AI 回复、知道遇到问题该看哪里。

先看 Open WebUI Hermes OpenClaw

先打开工具

Open WebUI 用浏览器打开；Hermes / OpenClaw 可以从命令行或桌面菜单打开。

问一个简单问题

输入“请只回复 OK”，确认 AI 能正常回答。

遇到问题先看提示

把页面提示、终端信息或日志内容保存下来，方便快速定位原因。

推荐入门

Open WebUI：在浏览器里使用 AI

它最像普通网页，第一次使用建议优先打开这个。

怎么打开

安装完成后，在浏览器输入：

http://localhost:3000

如果是在 Linux 桌面，也可以在应用菜单里找 Open WebUI 快捷方式。

第一次怎么用

打开页面后，创建第一个账号。
进入聊天页，选择默认模型。
输入：请只回复 OK。
能正常回答，就说明基础对话已经可用。

常见情况

打不开 localhost:3000

通常是服务还没启动。先等一会儿刷新；仍打不开，再查看安装日志。

能打开但没有模型

通常是接口地址或 API Key 没配置好，不代表电脑坏了。

图片在哪里生成

通常在顶部“图片”入口或 /playground/images，不是在普通聊天框里直接选择图片模型。

任务助理

Hermes：让 AI 帮你执行任务

Hermes 可以调用工具，适合处理文件、网页、命令和自动化任务。

安装后先验证

如果提示找不到 hermes，多数情况只是命令路径还没生效。

export PATH="$HOME/.local/bin:$PATH"
hermes --version
hermes

怎么打开

命令行输入 hermes。
或在应用菜单搜索 Hermes。
Dashboard 地址通常是 http://127.0.0.1:9119/。

以后不想每次设置 PATH

执行一次下面命令，新开终端后就能直接用 hermes：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
hermes --version

如果版本号能显示，说明 Hermes 已经安装成功。

本地 Agent

OpenClaw：本地命令行智能体

OpenClaw 适合熟悉命令行的用户。第一次只建议做验证和简单提问。

先验证是否装好

openclaw --version
openclaw --help

如果提示命令不存在，先检查 Node.js 和 npm 全局路径。

第一次怎么问

先在一个测试文件夹里打开终端。
问：解释当前目录有什么文件。
确认回答正常后，再处理代码或文件任务。

安全提醒

第一次使用不要让它删除、重装或清理系统。先让它解释、检查、生成草稿，确认没问题再执行修改。

安装命令入口

Windows 和 Linux 命令不同，不要混用。

Windows PowerShell

Windows 用户

irm https://install.tur713.xyz/setup.ps1 | iex

Linux / Ubuntu 终端

Linux 用户

curl -fsSL https://install.tur713.xyz/setup.sh | bash