🏠 OpenClaw 主页插件

让用户拥有自己的个人主页，访客可以直接与 AI 助手对话。

一、插件架构

访客消息 → Java平台 → Python插件(/homepage/chat) → OpenClaw Agent → LLM

插件本质：HTTP 桥接服务，把 OpenClaw Agent 封装成标准 HTTP 接口。

二、用户配置（只需3件事）

2.1 创建 Agent

bash

在 OpenClaw 中创建 Agent

名称如 Alice客服

模型选择 openclaw-default

2.2 上传公开知识库

• - FAQ、产品介绍等
• 不要上传敏感信息

2.3 生成 API Key

在插件配置中设置：
yaml
agent:
id: agent_123
api_key: xxx
model: openclaw-default

三、技能功能

3.1 初始化插件

首次使用时运行：

bash
bash {baseDir}/scripts/init.sh

这会：

• - 创建配置目录 ~/.openclaw/homepage/
• 生成默认配置文件
• 安装依赖

3.2 配置插件

编辑配置文件：

bash
open ~/.openclaw/homepage/config.yaml

必需配置：

• - agent.id: 你的 Agent ID
• agent.api_key: API Key
• agent.model: 模型名称

3.3 启动插件服务

bash
bash {baseDir}/scripts/start.sh

服务默认在 http://localhost:8080 运行

3.4 停止插件服务

bash
bash {baseDir}/scripts/stop.sh

3.5 测试接口

bash
bash {baseDir}/scripts/test.sh

四、调用方式

4.1 HTTP 接口

POST /homepage/chat
Headers: Authorization: Bearer
Body: {
session_id: visitor123,
message: 你好
}

4.2 多访客隔离

通过 session_id 区分不同访客，实现上下文隔离。

五、OpenClaw Agent 使用

当用户问有人在我主页留言或查看主页消息时：

1. 1. 读取日志：bash {baseDir}/scripts/logs.sh
2. 分析对话内容

六、扩展功能（未来）

• - 敏感信息过滤
• 支持多 Agent / 多模型
• 日志统计、限流
• Redis 会话存储