# 📅 2026-04-16 事件总结：OpenClaw 调试与 WordPress 知识库搭建
### 一、OpenClaw 状态检查与飞书连接问题
|问题|现象|解决方案|
| :—–| :———————–| :————————————————————————————-|
|**重复插件警告**|`duplicate plugin id detected: feishu`|删除手动安装的飞书插件目录 `~/.openclaw/extensions/feishu`，重启网关。|
|**飞书消息无回复**|发送指令后机器人不响应|确认飞书后台事件订阅方式为“长连接”，并发布应用版本。同时检查权限 `im:message` 等是否已开通。|
|**任务执行失败（文件编辑错误）**|日志显示 `edit failed: Could not find exact text`|删除残留文件 `/Users/suiwen/.openclaw/workspace/macro_market_monitor_workflow.json`，重新下发指令并要求使用 `write_file` 工具覆盖写入。|
|**网关状态判断**|不确定服务是否运行|使用 `openclaw gateway status` 命令，重点看 `Runtime: running (pid xxx, state active)` 即为正常。|
**关键命令备忘：**
– 查看状态：`openclaw gateway status`
– 实时日志：`openclaw logs –follow`
– 重启服务：`openclaw gateway restart`
—
### 二、WordPress 自定义知识库页面搭建（思源风格）
|阶段|问题|解决方案|
| :—–| :—————————————-| :——————————————————————————————————————————-|
|**HTML/CSS 嵌入失效**|在「自定义 HTML」区块粘贴代码后样式错乱|改用**自定义页面模板**方式，创建 `siyuan-kb-template.php` 文件，避免主题样式干扰。|
|**找不到模板选项**|页面编辑器中“模板”下拉菜单不出现|1. 确保子主题文件夹内有 `index.php` 文件。
2. 切换主题再切回，强制刷新模板缓存。
3. 在 `functions.php` 中用 `add_filter(‘theme_page_templates’)` 强制注册模板。|
|**左侧导航静态无法修改**|内容硬编码在 HTML 中，后台无法增删文档|改造为动态导航，利用 WordPress 原生“页面层级”功能，通过 PHP 递归生成树形菜单。|
|**页面与文章的认知混淆**|不理解何时用“页面”何时用“文章”|**页面**：适合固定层级结构（如知识库目录）。**文章**：适合按时间发布的动态内容。知识库建议用“页面”构建层级，或用插件为“文章”增加层级功能。|
**最终成果：**
– 成功部署左右分栏的知识库模板，左侧树形导航由 WordPress 后台的“页面”层级自动生成，右侧显示完整内容及标签。
– 左上角文字改为“Awen的笔记本”并可点击返回首页。
– 支持 OpenClaw 通过 REST API 自动创建页面和添加标签。
—
### 三、待跟进事项
1. **OpenClaw 任务自动化**：测试通过飞书下发指令，让 OpenClaw 调用 WordPress REST API 批量创建知识库页面和标签。
2. **知识库内容填充**：在 WordPress 后台按层级创建页面（父页面/子页面），完善左侧导航树。
3. **样式微调**：根据实际内容展示效果，进一步调整 CSS 细节。
—
如果还需要更详细的子条目或特定代码片段记录，随时告诉我，我帮你补充到笔记里。