skill-fixon-homepage

该 Skill 提供一个 HTTP 桥接服务，把 OpenClaw Agent 封装成标准接口，访客在个人主页发送的消息经 /homepage/chat 转发给指定 Agent 并返回回复。包含初始化、配置、启动、停止、测试与日志查看脚本，通过 session_id 实现多访客上下文隔离；敏感信息过滤、限流、Redis 会话等仍属规划功能。

yaoyi001

热度 82.33

最近更新 2026-05-18 12:28:14

分类：开发依赖：代码执行 / 读写文件 / 第三方 API / 内部调用大模型应用场景：API 集成 / 自动化脚本 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add skill-fixon-homepage

Metadata

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

4.2 多访客隔离

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

五、OpenClaw Agent 使用

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

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

六、扩展功能（未来）

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