🏠 OpenClaw 主页插件

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

一、插件架构

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

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

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

2.1 创建 Agent

# 在 OpenClaw 中创建 Agent
# 名称如 "Alice客服"
# 模型选择 openclaw-default

2.2 上传公开知识库

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

2.3 生成 API Key

在插件配置中设置：

agent:
  id: "agent_123"
  api_key: "xxx"
  model: "openclaw-default"

三、技能功能

3.1 初始化插件

首次使用时运行：

bash {baseDir}/scripts/init.sh

这会：

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

3.2 配置插件

编辑配置文件：

open ~/.openclaw/homepage/config.yaml

必需配置：

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

3.3 启动插件服务

bash {baseDir}/scripts/start.sh

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

3.4 停止插件服务

bash {baseDir}/scripts/stop.sh

3.5 测试接口

bash {baseDir}/scripts/test.sh

四、调用方式

4.1 HTTP 接口

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

4.2 多访客隔离

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

五、OpenClaw Agent 使用

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

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

六、扩展功能（未来）

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