Contents
show
📅 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 自动创建页面和添加标签。
三、待跟进事项
- OpenClaw 任务自动化：测试通过飞书下发指令，让 OpenClaw 调用 WordPress REST API 批量创建知识库页面和标签。
- 知识库内容填充：在 WordPress 后台按层级创建页面（父页面/子页面），完善左侧导航树。
- 样式微调：根据实际内容展示效果，进一步调整 CSS 细节。
如果还需要更详细的子条目或特定代码片段记录，随时告诉我，我帮你补充到笔记里。
请喝一杯咖啡
这些内容都是我一个人查资料、跑数据、核事实写出来的。如果对你有用，可以请我喝一杯咖啡。
微信扫码 · 微信支付
支付宝扫码个人收款码 · 微信支付 / 支付宝
本文采用 CC BY 4.0 许可。欢迎转载与引用，请注明作者并附上原文链接。
Licensed under CC BY 4.0. Quoting and republishing are welcome with attribution and a link back to this article.