- 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-default2.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 IDagent.api_key: API Keyagent.model: 模型名称
3.3 启动插件服务
bash {baseDir}/scripts/start.sh服务默认在 http://localhost:8080 运行
3.4 停止插件服务
bash {baseDir}/scripts/stop.sh3.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 使用
当用户问"有人在我主页留言"或查看主页消息时：
- 读取日志：
bash {baseDir}/scripts/logs.sh - 分析对话内容
六、扩展功能（未来）
- 敏感信息过滤
- 支持多 Agent / 多模型
- 日志统计、限流
- Redis 会话存储