OpenClaw 深度实践
OpenClaw 是一个自托管的多渠道 AI Gateway。它把模型、会话、工具、Skills、插件和消息渠道组织在一个长期运行的 Gateway 中。
这个专栏只保留两类内容:
- 能够按明确版本复现的使用和扩展方式;
- 来自真实故障、包含证据链和验证结果的排障记录。
当前版本的最短上手
Section titled “当前版本的最短上手”安装最新稳定版本:
npm install -g openclaw@latestopenclaw --version运行交互式配置并安装后台服务:
openclaw onboard --install-daemon确认 Gateway:
openclaw gateway status发起一次 Agent 请求:
openclaw agent --message "用三点总结当前工作区状态"命令和配置会随版本演进。复制任何示例前,都应先核对:
openclaw --versionopenclaw helpopenclaw doctor官方入口:
Tool、Skill 和 Plugin 怎么分
Section titled “Tool、Skill 和 Plugin 怎么分”| 能力 | 用途 |
|---|---|
| Tool | 让模型调用一个具体动作 |
| Skill | 教 Agent 如何完成一类任务 |
| Plugin | 向运行时注册 Tool、Hook、Channel、Provider、Service 或其他扩展 |
| Hook | 在明确生命周期事件发生时执行逻辑 |
| Slot | 替换 memory、context engine 等排他性核心能力 |
如果只是给 Agent 增加一套操作步骤,优先使用 Skill;如果只是增加一个可调用动作,优先使用 Tool;只有需要介入运行时生命周期或提供完整扩展包时,才使用 Plugin。
详细设计见:
当前保留的生产排障
Section titled “当前保留的生产排障”这些文章保留协议差异、失败表现、调查过程、生产边界和来源链接,也代表这个专栏后续文章的最低标准。
OpenClaw 相关教程必须记录:
- OpenClaw 版本;
- Node.js 与操作系统版本;
- 使用的模型 Provider 和协议;
- 完整可执行命令;
- 关键配置,但不包含真实密钥;
- 成功和失败输出;
- 官方文档或源码依据;
- 最后验证日期。
无法提供这些证据时,文章应明确标注为“设计讨论”或“伪代码”,不能写成实测教程。