OpenClaw

第零章 写在前面

官网: link

第一章 Hello OpenClaw

第一节 下载OpenClaw

下载

node --version
npm install -g openclaw

echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
exec zsh
openclaw --version

第二节 运行OpenClaw

1.2.1 什么是GateWay(网关)

• 作用: OpenClaw是通过GateWay运行的, 你网页18789看到的是gateway dashboard可视化界面;
  • ①言外之意就是想要用OpenClaw, 得先把gateway跑起来
  • ②修改任何内容(plugin, skill)也得重启gateway

1.2.2 GateWay常用命令

作用	指令	示例
查看gateway的状态	openclaw gateway status	openclaw gateway status
开启gateway	openclaw gateway start	openclaw gateway start
关闭gateway	openclaw gateway stop	openclaw gateway stop
重启gateway	openclaw gateway restart	openclaw gateway restart

第二章 Plugin

• 教程: https://openclaw-ai.com/zh/docs/tools/plugin/

第一节 下载+使用Plugin

• https://clawhub.ai/plugins

作用	指令	示例 (voice-cal这个插件为例子)
列出已安装的插件	openclaw plugins list	openclaw plugins list
查看插件详细信息	openclaw plugins info <id>	openclaw plugins info voice-call
启用插件	openclaw plugins enable <id>	openclaw plugins enable voice-call
禁用插件	openclaw plugins disable <id>	openclaw plugins disable voice-call
卸载插件	openclaw plugins uninstall <id>	openclaw plugins uninstall voice-call
诊断插件加载问题	openclaw plugins doctor	openclaw plugins doctor
更新指定插件	openclaw plugins update <id>	openclaw plugins update voice-call
更新所有插件	openclaw plugins update --all	openclaw plugins update --all

第二节 编写+使用Plugin

• 1. 一定要去package.json中把dependencies加了, 然后npm install
• 2. openclaw才能检测到 ~/.openclaw/extentions下的插件

作用	指令	示例
检查插件加载情况	openclaw plugins inspect <id> --runtime --json	openclaw plugins inspect my-plugin --runtime --json

• 构建插件: link
• 手把手教: link
• 脚手架:

openclaw plugins init stock-quotes --name "Stock Quotes"

STEP1: API

先编译
再检查生成文件有没有过期
再校验元数据
再跑测试

openclaw.plugin.json能配置哪些

1. uiHints:

. uiHints 是"给已有配置项加标签"，不是"凭空创建配置项" 。Dashboard 只会为 configSchema.properties 里声明的字段渲染 uiHints 。你的 hhh 没有出现在 properties 里，所以不显示。
立即推===> uiHints和configSchema的properties字段都要配置

{
  "id": "test-plugin",
  "name": "Test Plugin",
  "description": "Add Test Plugin tools to OpenClaw.",
  "version": "0.1.0",
  "configSchema": {
    "type": "object",
    "additionalProperties": false,
    "properties": {
      "hhh": {"type": "string"}   // 1/2
    }
  },
  "uiHints": {
    "hhh": {                     // 2/2
      "label": "HHH",
      "help": "xixix"
    }
  },
}

第三章