OpenClaw自动问答页面生成指南

部署OpenClaw后，若遇到生成的问答页面空白、格式错乱或未生成HTML文件，通常是由于关键配置步骤缺失。以下将系统介绍如何正确配置，以确保“自动生成结构化问答页面”功能正常运行。

一、启用OpenClaw内置HTML生成Skill

首先需确保OpenClaw具备生成HTML的能力，这依赖于一个专门的技能（Skill）。若该技能未启用，则无法进行后续操作。

1. 登录OpenClaw WebUI管理后台（通常地址为 http://localhost:3000）。

2. 在左侧导航栏点击「Skills」，进入后选择「Browse Marketplace」。

3. 在搜索框中输入 html-generator-v3 进行查找。请确认版本号为 v3.2.1（2026年4月发布） 或更高，以保证功能完整与稳定。

4. 点击「Install」安装。安装完成后，返回「Skills」列表页，找到“html-generator-v3”并将其右侧的「Enable」开关打开，状态变为启用。请注意，安装后需手动启用。

二、配置本地HTML输出路径与权限

启用技能后，需指定HTML文件的输出目录，并确保系统有写入权限。权限问题常导致生成失败。

1. 创建用于存放生成页面的目录，例如在终端执行：mkdir -p /var/www/openclaw-qa。

2. 将该目录所有权授予运行OpenClaw服务的用户：sudo chown -R $(whoami):$(whoami) /var/www/openclaw-qa。

3. 在OpenClaw配置文件中指定输出路径。打开配置文件 ~/.openclaw/openclaw.json，在根对象中添加字段：
"output": { "html": { "baseDir": "/var/www/openclaw-qa", "indexPath": "index.html" } }。

4. 保存配置文件后，重启OpenClaw服务使配置生效：openclaw restart。

三、绑定问答专用模型与结构化提示词

需配置一个能按指定HTML格式输出内容的AI模型，以确保生成内容的结构符合要求。

1. 进入WebUI的「Models」设置页面，点击「Add Provider」，选择「Custom」类型以配置自定义模型端点。

2. 填写Provider名称（如 qa-html-llm），并将Base URL设置为本地模型服务地址（例如 http://localhost:8000/v1）。

3. 在「System Prompt」系统指令字段中，粘贴强约束性指令以格式化模型输出：
你必须将每个问答对严格输出为一个

包裹，技术术语加标签。

4. 保存自定义模型Provider。然后，在「Skills」页面找到已启用的「html-generator-v3」技能，在其配置的「Model Binding」选项中选择刚创建的 qa-html-llm，完成技能与模型的绑定。

四、注入文档源并触发HTML生成任务

将待处理的文档（如Markdown或PDF格式的技术手册）交给OpenClaw处理。推荐使用自动监听模式。

1. 创建用于存放输入文档的目录：mkdir -p ~/openclaw-input/docs。

2. 将文档（例如“redis-persistence.md”或“k8s-networking.pdf”）复制到该目录下。

3. 进入「Skills」→「html-generator-v3」的配置页面，在「Input Directory」字段中设置上一步创建的目录绝对路径（例如macOS为 /Users/$(whoami)/openclaw-input/docs，Linux为 /home/$(whoami)/openclaw-input/docs）。

4. 打开「Auto-Process on File Change」开关，并确认「Output Format」选项为 single-page-html。此后，向监控目录放入或更新文档时，OpenClaw将自动启动解析、问答提取和页面生成流程。

五、验证生成页面的可访问性与样式完整性

配置完成后，建议通过本地Web服务器预览生成的HTML页面，以验证其可访问性与样式是否完整。

1. 在终端中切换到输出目录：cd /var/www/openclaw-qa。

2. 使用Python启动简易HTTP服务器：python3 -m http.server 8080 --directory .。

3. 在浏览器中访问 http://localhost:8080。此时应能看到完整的网页，问答项默认以可折叠形式呈现。

4. 右键点击页面并选择“查看网页源代码”，检查源码中是否包含样式表链接（例如 ），并确认同目录下存在“style.css”文件，以确保样式与交互功能正确加载。

按照以上五个步骤逐一检查与配置，通常可解决OpenClaw问答页面生成失败或格式异常的问题，从而获得专业、可交互的知识库页面。