openclaw-openwebui-moss：在 Open WebUI 中集成 OpenClaw Moss AI 代理

This production-grade OpenClaw plugin integrates Moss AI agents into OpenWebUI, enabling safe multi-agent routing, strict access control, and channel-based workflows. It supports editing, development, and operations scenarios, with OpenAI compatibility and self-hosting capabilities.

OpenWebUI is a popular self-hosted LLM web interface with ChatGPT-like UX, running on private servers. OpenClaw is an emerging AI agent platform for creating/managing Moss agents (each with unique identities and capabilities). This plugin connects the two, allowing seamless use of Moss agents in OpenWebUI.

The plugin uses an OpenAI-compatible API layer. Workflow:

1. OpenWebUI sends OpenAI API requests (GET /v1/models or POST /v1/chat/completions)
2. Plugin loads Moss config from filesystem
3. Builds prompt (IDENTITY.md + context files + user messages)
4. Relays request to OpenClaw API
5. Converts result to OpenAI format.

Model discovery: Dynamic from ~/.openclaw/workspace/moss-models/ — each folder is a model (folder name as model.id, IDENTITY.md required; loads .md/.txt files as context).

Prompt Construction: Loads model folder → uses IDENTITY.md as system message → adds context files → combines with chat history. Optional Config: config.json in model folders sets agentId (default main) or maxContextBytes. Installation: Local dev (pnpm install/build, env vars like OPENCLAW_API_URL; Docker (compose up -d --build); embed in OpenClaw. OpenWebUI Integration: Add OpenAI connection (API URL to provider port, any API key) → Moss agents appear as models.

1. Editing Teams: Moss agent for content review/editing with style guides.
2. Dev Teams: Specialized agents (React, Python, security code review) with relevant docs.
3. Ops Teams: Agent with runbooks/troubleshooting guides.
4. Multi-Tenant: Isolate agents via model folders for different teams/projects.

Security mechanisms:

• File system isolation (per agent folders)
• Config validation (skip invalid configs, log warnings)
• Token authentication (OpenClaw Gateway Token)
• On-request model loading (avoids automatic execution of malicious files).

Limitations: No streaming chat.completions; uses last user message only; simple context file拼接; no RAG/vector search; no tools/attachments. Future: Add streaming support; better long-dialogue context management; vector DB integration; tool calling.

openclaw-openwebui-moss is a well-designed bridge between OpenWebUI and OpenClaw ecosystems. Its file-driven model discovery, OpenAI-compatible layer, and flexible config make it a powerful AI agent management platform for teams using both tools.