skill-fixon-homepage

---

name: homepage description: OpenClaw 主页插件 - 让访客在你的个人主页上与 AI 助手对话。支持多访客并发、上下文隔离，无需泄露敏感信息。 metadata: {"openclaw": {"emoji": "🏠", "requires": {"bins": ["python3"], "anyBins": ["uvicorn"]}}}

---

🏠 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 
Body: {
  "session_id": "visitor123",
  "message": "你好"
}

4.2 多访客隔离

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

---

五、OpenClaw Agent 使用

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

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

---

六、扩展功能（未来）

敏感信息过滤

支持多 Agent / 多模型

日志统计、限流

Redis 会话存储