如何使用 OpenClaw
充分利用 RoqueOS 自动 AI 代理的实用指南。
代理界面
AI 助手应用程序分为两个主要区域：
- 聊天面板 (左侧) — 在这里您可以发送消息并跟踪回复
- 桌面预览 (右侧) — 实时流式传输代理在容器中的操作
步骤面板
在聊天面板下方，有一个实时步骤面板，显示代理正在执行的每一个操作：导航至 URL、点击元素、运行命令等。
创建会话
与代理的每次对话都会创建一个会话 — 一个带有专属 Linux 桌面的隔离 Docker 容器。开始方法：
- 在启动台中打开 AI 助手 应用程序。
- 点击 新会话。
- 容器将开始初始化（第一次可能需要 10-30 秒）。
- 当桌面出现在右侧面板时，说明代理已准备就绪。
发送任务
提示词最佳实践
在描述任务时，要具体且客观。您提供的上下文越多，结果就越好。
❌ 模糊的提示：
研究一下 Docker✅ 具体的提示：
研究 Docker Compose v2 和 v3 之间的前 5 大区别，
创建一个总结这些要点的 markdown 文件，并将其保存在 /home/user/docker-comparison.md 中任务示例
研究和文档：
前往 hetzner.com 网站，查找可用的 VPS 套餐，
并创建一个包含价格和功能的 CSV 比较表。表单自动化：
使用以下数据填写位于 [URL] 的注册表单：
姓名：John Doe，邮箱：john@example.com，套餐：基础版开发：
创建一个 Python 脚本，抓取 Hacker News 上的新闻标题，
并将前 10 条保存到 JSON 文件中。网站分析：
访问这个 GitHub 仓库 [URL]，阅读 README 文件，并向我解释
这个项目是做什么的，以及安装的先决条件是什么。代理可以在 RoqueOS 上执行的操作
OpenClaw 可以在隔离容器之外直接与您的 RoqueOS 交互：
| 操作 | 描述 |
|---|---|
| 通知 | 向您的 RoqueOS 桌面发送警报 |
| 打开应用 | 在启动台中打开特定的应用程序 |
| 打开 URL | 在 RoqueOS 浏览器中打开一个网址 |
示例用法：在完成一项耗时的任务结束时，代理可以发送一个自动通知，告诉您它已经完成了。
管理会话
活动会话
所有活动的会话都会列在应用程序的顶部。您可以：
- 点击之前的会话以恢复它
- 结束一个会话以释放服务器资源
并发会话限制
默认情况下，服务器允许最多 3 个并发会话（可以通过 AGENT_MAX_SESSIONS 配置）。请结束您不再使用的会话以节省内存。
截屏和全屏
- 截屏 — 点击相机图标来捕捉代理桌面的当前状态
- 全屏 — 将桌面视图扩展为全屏，以便更好地跟踪视觉任务
已知限制
- 代理在一个隔离的环境中运行 — 除非您通过聊天提供信息，否则它无法直接访问您的本地文件。
- 需要登录账户（电子邮件、社交网络）的任务，要求您在对话期间提供凭据。
- 默认超时为 30 分钟不活动 — 非常耗时的任务可能需要周期性的交互。
故障排除
代理没有响应
- 检查服务器是否在线：
curl http://localhost:27021/health - 确认 API 密钥已正确配置。
- 结束当前会话并创建一个新会话。
面板中没有显示桌面
容器可能仍在初始化。等待 30 秒后重新加载应用程序。
响应缓慢或不完整
这可能是来自 AI 提供商的速率限制问题。请稍等片刻再试，或者降低任务的复杂性。