Skip to content

最佳实践:学习与使用路径

这页总结的是“更容易学会、也更不容易踩坑”的使用方式,重点放在学习和上手,而不是生产运维。

先理解对象,再记命令

建议先把这四个对象分清:

  • Template
  • Sandbox
  • Node
  • Network

如果你先把页面和对象关系建立起来,后面的 Dashboard、API、CLI 会容易很多。

建议入口:

第一次体验时,不要同时学太多条线

更推荐的顺序是:

  1. 先跑通一个模板
  2. 再创建一个沙箱
  3. 再看日志与状态
  4. 最后再接 SDK 或 Agent

这样能避免“模板、网络、API、鉴权一起学”带来的混乱。

优先使用官方模板或最小示例

第一次体验时,更建议:

这样能减少镜像、探针、端口参数带来的变量。

先看 Dashboard,再回看 API

对学习者来说,Dashboard 是最好的观察窗口:

  • 你可以直观看到模板状态
  • 你可以看到节点、沙箱和网络配置
  • 你可以更容易理解 API 背后的对象关系

建议顺序:

  1. Web Dashboard 快速上手
  2. API 总览

遇到问题时,先分流,不要乱跳页

不要在模板页、节点页、网络页之间来回猜。

更好的方式是:

  1. 先看 故障分流图与排查路径总览
  2. 再看 FAQ
  3. 再进入具体专题页

做示例时,优先选与你目标最接近的那一个

例如:

  • 想做最小代码执行:先看代码沙箱示例
  • 想做浏览器自动化:先看 Playwright 示例
  • 想做 Agent 集成:先看 OpenAI Agents / OpenClaw 示例

不要一开始就选最复杂的例子。

相关文档