如何使用 OpenClaw

充分利用 RoqueOS 自主 AI 代理的实用指南。

代理界面

AI 代理应用分为两个主要区域:

聊天面板（左）— 发送消息并查看响应的地方
桌面可视化（右）— 代理在容器中所做工作的实时流

Steps 面板

聊天下方，实时 Steps 面板显示代理正在执行的每个操作: 导航到 URL、点击元素、执行命令等。

创建会话

与代理的每次对话都会创建一个会话 — 一个具有专用 Linux 桌面的隔离 Docker 容器。要开始:

在 Launchpad 中打开 AI 代理 应用。
点击 新会话。
容器将被初始化（首次可能需要 10-30 秒）。
当桌面出现在右侧面板时，代理已准备就绪。

发送任务

提示的最佳实践

在描述任务时要 具体和客观。您提供的上下文越多，结果就越好。

❌ 模糊:

研究一下 Docker

✅ 具体:

研究 Docker Compose v2 和 v3 之间的 5 个主要区别，
创建一个总结要点的 markdown 文件并保存到 /home/user/docker-comparison.md

任务示例

研究和文档:

访问 hetzner.com 网站，找到可用的 VPS 计划，
并创建一个 CSV 格式的价格和资源比较表。

表单自动化:

使用以下数据填写 [URL] 的注册表单:
姓名: João Silva，邮箱: joao@exemplo.com，计划: 基本

开发:

创建一个 Python 脚本，抓取 Hacker News 的新闻标题，
并将前 10 个保存到 JSON 文件中。

网站分析:

访问这个 GitHub 仓库 [URL]，阅读 README 并向我解释
项目做什么以及安装的先决条件是什么。

代理在您的 RoqueOS 中执行的操作

RoqueClaw 不会被困在隔离的容器中 — 它通过 roqueos-cli CLI 直接在您的 RoqueOS 桌面上操作，该 CLI 预安装在代理的容器和服务器每个用户的 Terminal 应用容器中。

6 个规范操作

CLI 命令	它做什么	触发的提示示例
`roqueos-cli notify "title" "msg"`	桌面通知	"完成时通知我"
`roqueos-cli open-app <id>`	在 Launchpad 中打开应用	"打开 VS Code"
`roqueos-cli open-url <url>`	在 Roque Browser 中打开 URL	"打开项目的 GitHub"
`roqueos-cli create-file <path>`	写入文件（读取 stdin）	"将此摘要保存到 Notes"
`roqueos-cli run-terminal <cmd>`	执行命令 + 返回输出	"显示我有多少可用磁盘空间"
`roqueos-cli show-dialog "msg"`	确认模态（暂停，等待）	"删除前询问我"

您也可以直接使用 CLI（无需代理）

CLI 在每个用户的 Terminal 应用（隔离的 Ubuntu 容器）中可用。在 Launchpad 中打开 Terminal，输入 roqueos-cli --help 并直接使用。

常见用例:

bash

# 备份脚本的快速通知
./backup.sh && roqueos-cli notify "备份 OK" "23 GB 已同步"

# 构建完成时直接从 shell 打开 VS Code
yarn build && roqueos-cli open-app vscode

# 当磁盘超过 80% 时发出警告的 cron
0 9 * * * df -h | awk '$5+0 > 80 {system("roqueos-cli notify \"磁盘已满\" \"" $6 " " $5 "\"")}'

# Python 脚本直接写入用户的文件
echo "$(date): meeting notes" | roqueos-cli create-file "/home/user/notes/reuniao-$(date +%F).md"

# Plex 容器在转码完成时通知
# （在 Plex 容器中，如果共享 roqueos-server 网络）
roqueos-cli notify "Plex" "电影 X 的 4K 转码完成"

通过自然语言安装容器（隐藏的力量）

代理最常用的操作: 通过 roqueos-cli → 服务器 API → appsService.installApp 直接从目录安装 Docker 应用。

您说: "安装 Nextcloud，2GB RAM，准备好后打开"

代理执行（您可以通过 VNC 实时看到）:

在目录中识别 nextcloud
调用 roqueos-cli → POST /apps/install 带有 appId: nextcloud, memory: 2048
等待容器启动 + 健康检查
调用 roqueos-cli open-url http://localhost:<分配的端口>
通知 "Nextcloud 已就绪，初始登录 admin/admin"

与视觉 App Store 相同的 API — 只是无需您导航/点击。适用于:

大规模设置: "安装 Plex、Sonarr、Radarr、Bazarr 和 qBittorrent。配置所有应用使用 /media 存储。"
整个堆栈: "启动一个带有 MariaDB 和 phpMyAdmin 的 LAMP 堆栈"
恢复: "重新安装我崩溃前的所有应用"

管理会话

活动会话

所有活动会话都列在应用顶部。您可以:

点击恢复上一个会话
结束会话以释放服务器资源

同时会话限制

默认情况下，服务器允许最多 3 个同时会话（可通过 AGENT_MAX_SESSIONS 配置）。结束您不再使用的会话以节省 RAM。

截图和全屏

截图 — 点击相机图标以捕获代理桌面的当前状态
全屏 — 展开桌面可视化到全屏以更好地跟踪视觉任务

已知限制

代理在 隔离环境 中运行 — 除非您通过聊天提供信息，否则无法直接访问您的本地文件
需要 登录账户 的任务（邮箱、社交网络）需要您在对话中提供凭据
默认会话超时为 30 分钟无活动 — 非常长的任务可能需要定期交互

故障排除

代理无响应

验证服务器在线: curl http://localhost:27021/health
确认 API 密钥已正确配置
结束当前会话并创建新会话

桌面未出现在面板中

容器可能仍在初始化。等待 30 秒并重新加载应用。

响应缓慢或不完整

可能是 AI 提供商的速率限制问题。等待片刻后重试，或减少任务的复杂性。

如何使用 OpenClaw ​

代理界面 ​

Steps 面板 ​

创建会话 ​

发送任务 ​

提示的最佳实践 ​

任务示例 ​

代理在您的 RoqueOS 中执行的操作 ​

6 个规范操作 ​

您也可以直接使用 CLI（无需代理） ​

通过自然语言安装容器（隐藏的力量） ​

管理会话 ​

活动会话 ​

同时会话限制 ​

截图和全屏 ​

已知限制 ​

故障排除 ​

代理无响应 ​

桌面未出现在面板中 ​

响应缓慢或不完整 ​