最佳实践:学习与使用路径
这页总结的是“更容易学会、也更不容易踩坑”的使用方式,重点放在学习和上手,而不是生产运维。
先理解对象,再记命令
建议先把这四个对象分清:
- Template
- Sandbox
- Node
- Network
如果你先把页面和对象关系建立起来,后面的 Dashboard、API、CLI 会容易很多。
建议入口:
第一次体验时,不要同时学太多条线
更推荐的顺序是:
- 先跑通一个模板
- 再创建一个沙箱
- 再看日志与状态
- 最后再接 SDK 或 Agent
这样能避免“模板、网络、API、鉴权一起学”带来的混乱。
优先使用官方模板或最小示例
第一次体验时,更建议:
- 优先使用 模板商店(Template Store)
- 或先跑 代码沙箱快速入门
这样能减少镜像、探针、端口参数带来的变量。
先看 Dashboard,再回看 API
对学习者来说,Dashboard 是最好的观察窗口:
- 你可以直观看到模板状态
- 你可以看到节点、沙箱和网络配置
- 你可以更容易理解 API 背后的对象关系
建议顺序:
遇到问题时,先分流,不要乱跳页
不要在模板页、节点页、网络页之间来回猜。
更好的方式是:
- 先看 故障分流图与排查路径总览
- 再看 FAQ
- 再进入具体专题页
做示例时,优先选与你目标最接近的那一个
例如:
- 想做最小代码执行:先看代码沙箱示例
- 想做浏览器自动化:先看 Playwright 示例
- 想做 Agent 集成:先看 OpenAI Agents / OpenClaw 示例
不要一开始就选最复杂的例子。