平时做技术实践时，很多问题不是概念不会，而是细节没串起来。拿“在OpenClaw中安装本地插件的流程步骤”来说，它看着像小点，放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际采用顺序，把思路、关键写法和容易踩坑的地方讲清楚，便于大家直接对照操作。
结合项目来看，OpenClaw 上的很多插件能够从 ClawHub 一键安装。但开发时更常用的是：插件还在你自己的电脑上——一个本地目录，或者打好的 .tgz 包。这篇教程讲的就是这种本地安装。
你需准备什么
- 本机已安装
openclaw命令行，同时能正常执行openclaw --version - 要装插件的那台机器上，Gateway 正在运行（装到本机就对本机装；装到服务器就 SSH 到服务器再装）
- 一份可安装的插件：
- 本地目录（里面有
openclaw.plugin.json/package.json等），或 npm pack打出来的.tgz文件
- 本地目录（里面有
注意：只把某个 tool 的 JSON 描述文件拷进 workspace，不等于安装插件。必须走 openclaw plugins install。
方式一：从本地目录安装（最常用）
假设插件在 ./my-plugin：
openclaw plugins install ./my-plugin
装完后检查是否被识别：
openclaw plugins list
openclaw plugins inspect my-plugin --runtime
把 my-plugin 换成你插件在 openclaw.plugin.json 里声明的 id。
期望看到类似：
- 列表里该插件为 enabled
inspect里 Status: loaded- 若插件注册了 tool，能在输出里看到 tool 名称
然后重启或 reload Gateway，让运行时真正加载插件。
方式二：从.tgz包安装
先打好包（在插件项目目录）：
npm pack
# 会生成类似 my-plugin-0.1.0.tgz
再安装：
openclaw plugins install npm-pack:./my-plugin-0.1.0.tgz --force
从实现思路看，较新的 OpenClaw（比如 2026.9 一带）对「非 ClawHub 来源」可能还会要求你确认能力声明，这时加上：
openclaw plugins install npm-pack:./my-plugin-0.1.0.tgz --force --accept-capabilities
同样用 plugins inspect 验收，随后重启 Gateway。
让模型真的能调用插件里的工具
有些插件的 tool 标成了 optional。插件「已加载」不等于对话里一定能调到。
常用做法是在对应 Agent 的设置里用 alsoAllow 额外放行（不要把整个 tools.allow 收成只剩少数几个工具，以免影响正常聊天）：
{
"tools": {
"profile": "full",
"alsoAllow": ["your_tool_name"]
}
}把 your_tool_name 换成插件实际注册的 tool 名；有多个就都写上。改完后按你环境的要求 reload / 重启。
怎么算装成功了
按下面三条自检即可：
openclaw plugins inspect <插件id> --runtime→ Status: loaded- 设置里已放行需的 tool（如用了
alsoAllow） - 打开对话，让模型做一件必须靠该 tool 才能完成的事 → 聊天里出现 tool call，而不是只在正文里「口头说做完了」
常用问题
装完了，对话里还是没有这个工具？
理解这一步时，多半是 optional tool 没放进 allowlist / alsoAllow，或装完没重启 Gateway。
我在自己电脑上装好了，线上还是没有？
插件装在「执行 plugins install 的那台 Gateway」上。本机安装不会同步到远程服务器，要在目标机器（或对应容器）里再装一次。
控制台 / 面板的插件列表里看不到？
落到代码里，有的管理面板只展示特定安装渠道（比如装到 extensions/ 的托管插件）。CLI 装成功、runtime loaded，功能仍然可用；以 plugins inspect 为准。
提示要 accept capabilities / 不信任的来源？
本地路径和 .tgz 不在 ClawHub 审核列表里，属正常提示。确认插件来源可信后，采用文档要求的 --force / --accept-capabilities 即可。
小结
- 准备本地目录或
.tgz openclaw plugins install …plugins inspect … --runtime确认 loaded- 按需设置
alsoAllow - 重启 Gateway，用真实对话验收 tool call
按这五步，本地插件就能在 OpenClaw 里跑起来。
从实现思路看，总的来说，OpenClaw适合结合实际项目边做边理解。先抓住核心思路，再逐步补上细节和边界处理，最后效果会更稳定，也更容易复用。
