教程 1:本地跑通(最小闭环)
目标:能启动、能收消息、能产出一条可验证的结果(不需要上生产,不需要公网)。
# 安装与引导(示例)
npm install -g openclaw@latest
openclaw onboard
# 启动网关(端口/路径按需替换)
openclaw gateway --port <PORT>
教程 2:接入一个通道
目标:把一个“消息入口”接进来,并用最少权限完成回写。公开教程只写字段说明与占位符,不写你的真实密钥。
- 先明确:入口消息长什么样,哪些字段需要持久化/审计。
- 再明确:回写动作有哪些(回复、创建工单、写入 CRM 等)。
- 最后按官方文档/插件 README 配置通道参数,并用“最小流量”做验证。
公开内容占位符示例(不要替换成真实值):
<CHANNEL_ID>
<WEBHOOK_URL>
<VERIFY_TOKEN>
<SIGNING_SECRET>
教程 3:做成插件(可复用)
目标:把“能力”从脚本升级为插件:可安装、可升级、可回滚。
my-plugin/
openclaw.plugin.json
package.json
src/index.ts
建议同时提供 schema/文档,让配置变成“能被校验的输入”。
上线前清单(对外站点)
- 不要把控制面变成公网网站;对外的只有内容与文档。
- 所有示例必须用占位符:<TOKEN>、<API_KEY>、<HOST>。
- 未知路径应该返回 404(不要兜底成首页 200)。
- 屏蔽内部产物目录(例如 /internal/、/logs/、/.git/)。
下一步
如果你准备开始写内容,建议先把“不要公开哪些信息”这篇文章读完,再决定教程颗粒度。