Agent Skills
› openclaw/clawhub
› convex-agent
convex-agent
GitHub在Convex应用中集成AI Agent和RAG后端，支持持久化对话、工具调用及向量搜索。通过Convex AI Gateway默认管理模型凭证，简化LLM集成并保障密钥安全。
Trigger Scenarios
需要为应用添加AI助手或聊天功能
实现基于文档的检索增强生成(RAG)系统
集成大语言模型以提供智能服务
Install
npx skills add openclaw/clawhub --skill convex-agent -g -y
SKILL.md
Frontmatter
{
"name": "convex-agent",
"description": "Add an AI agent \/ RAG backend (@convex-dev\/agent) to the Convex app."
}
Add an AI agent / RAG backend
Install @convex-dev/agent for durable threads, message history, tool-calls, and vector search/RAG — the backend for an in-app AI agent. Call models through the Convex AI Gateway by default: Convex holds the provider credentials, so there is no LLM key to obtain, store, or rotate.
Workflow
- Install @convex-dev/agent + @convex-dev/ai-sdk-provider; add the agent component to convex.config.ts.
- Define the agent (tools, instructions) with
languageModel: convexGateway("provider/model")— no API key needed (needs convex 1.45+ on a Convex Cloud deployment, paid plan). - Create threads + stream messages; persist history in Convex.
- For RAG: embed docs into a vector index and retrieve in the tool. The gateway does not serve embeddings yet, so store the embedding provider's key via the
envmicro power. - Only if the gateway is unavailable (free plan, self-hosted, local backend): call the provider SDK with a key stored via the
envmicro power.
Rules
- Default to the Convex AI Gateway (
convexGatewayfrom @convex-dev/ai-sdk-provider) for model calls; fall back to a provider key in Convex env only where the gateway is unavailable (free plan, self-hosted, local backend). - Never expose a provider API key client-side; when one is needed (embeddings, gateway fallback), keep it in Convex env via the
envmicro power. - Run model calls in actions ('use node' if the SDK needs it).
- Persist threads/messages in Convex for durability + reactivity.
Version History
-
826992b
Current 2026-09-22 15:37
新增Convex AI Gateway默认支持，无需配置LLM密钥；更新示例代码并修复相关文档问题。
- d6a8c68 2026-08-20 02:43
