🏠 OpenClaw 主页插件#

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

---

一、插件架构#

text

访客消息 → 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 接口#

text

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 会话存储