OpenClaw 作用与定位 大模型接入指南

一、OpenClaw 是什么OpenClaw是一个开源的多通道 AI 网关Multi-channel AI Gateway核心定位是将大语言模型LLM能力接入多种通讯渠道IM、语音、平台同时提供 Agent 运行时、工具系统、记忆系统和插件体系让 AI 不只是聊天机器人而是可以主动执行任务的数字助手。1.1 核心能力矩阵能力维度说明多渠道接入同时接入 Telegram、飞书、Discord、微信、企业微信、WhatsApp、Line、Signal 等 20 消息平台Agent 运行时内置完整的 Agent 执行引擎支持多 Agent 并发、工具调用、子任务分解工具系统Skills可插拔的技能体系通过 SKILL.md 定义工作流扩展 Agent 能力边界记忆系统多级记忆架构短期会话 → 每日日志 → 长期记忆LanceDB 向量库大模型路由支持多个模型提供方可配置默认模型、按场景路由、降级策略插件体系支持第三方扩展可开发自定义 Channel 插件、Provider 插件浏览器自动化内置 CDP 协议浏览器控制可操控真实浏览器完成网页任务定时/周期任务内置 Crontab 引擎支持定时提醒、定期检查、延迟任务1.2 架构概览code复制┌─────────────────────────────────────────────────────┐ │ OpenClaw Gateway │ │ │ │ ┌─────────┐ ┌──────────┐ ┌───────────────────┐ │ │ │ Channel │ │ Agent │ │ Tools / Skills │ │ │ │Plugins │ │ Runtime │ │ │ │ │ │(20平台)│ │ │ │ • Web Search │ │ │ └────┬────┘ └─────┬────┘ │ • Browser Control │ │ │ │ │ │ • File I/O │ │ │ │ ┌──────┴─────┐ │ • Cron / Remind │ │ │ │ │ LLM Router│ │ • 200 Skills │ │ │ │ │ Memory │ │ from SkillHub │ │ │ │ └───────────┘ └────────────────────┘ │ └───────┼──────────────────────────────────────────────┘ │ ┌────▼───────────────┐ │ Model Providers │ │ • OpenAI / Azure │ │ • Claude (Anthropic)│ │ • Gemini / DeepSeek│ │ • 腾讯混元 / 百度 │ │ • 本地 Ollama / LM Studio │ │ • 自定义 OpenAI-compat API│ └────────────────────┘二、大模型接入方式OpenClaw 支持三类大模型接入路径下面逐一说明。2.1 方式一OpenAI 兼容 API最通用适用于所有提供 OpenAI 兼容接口的模型服务包括OpenAI 官方GPT-4o、GPT-4o-mini 等Azure OpenAI Service硅基流动 / Fireworks AI / Together AI 等第三方聚合平台几乎所有国产大模型 API腾讯混元、百度文心、字节豆包、DeepSeek 等配置方法在openclaw.json的providers节点下添加json复制{ providers: { my-openai: { baseUrl: https://api.example.com/v1, apiKey: sk-xxxxxxxxxxxxxxxx, api: openai-compat, models: [ { id: gpt-4o, name: GPT-4o, input: [text, image], reasoning: true }, { id: deepseek-chat, name: DeepSeek V3, input: [text] } ] } } }关键参数说明baseUrlAPI 端点需包含/v1路径apiKey访问密钥api接口类型写openai-compat即兼容 OpenAI 格式models[].id实际调用的模型 ID与 baseUrl 对应服务中的模型名一致models[].reasoning是否启用思维链推理需要模型支持2.2 方式二直接 Provider 插件最深度OpenClaw 为部分主流模型提供了原生 Provider 插件支持更好的功能特性如 thinking 预算、流式输出、工具调用优化。已内置支持的 ProviderProvider说明claudeAnthropic Claude 系列支持 native tools、thinkinggoogle-geminiGoogle Gemini 系列openaiOpenAI 官方带 function calling 优化qclawQClaw 自有路由当前主配置方式lmstudio本地 LM StudioOllama 类本地推理ollama本地 Ollama配置示例Anthropic Claudejson复制{ providers: { claude: { apiKey: ${ANTHROPIC_API_KEY}, models: [ { id: claude-sonnet-4-7-20250611, name: Claude Sonnet 4, input: [text, image], reasoning: true, thinkingBudgetTokens: 16000 } ] } } }配置示例本地 LM Studiojson复制{ providers: { lmstudio: { baseUrl: http://localhost:1234/v1, apiKey: lm-studio, api: openai-compat, models: [ { id: local-model, name: Qwen2.5-7B, input: [text] } ] } } }2.3 方式三MCPModel Context Protocol扩展接入OpenClaw 支持通过 MCP 协议接入外部 AI 工具/数据源不是 LLM 本身而是 LLM 可以调用的工具生态json复制{ mcpServers: { filesystem: { command: npx, args: [-y, modelcontextprotocol/server-filesystem, C:\\Users\\17616\\Documents] }, fetch: { command: npx, args: [-y, modelcontextprotocol/server-fetch] } } }三、模型路由与 Agent 绑定3.1 设置默认模型在 Agent 配置中指定model.primaryjson复制{ agents: { defaults: { model: { primary: qclaw/modelroute } } } }3.2 多模型路由策略OpenClaw 支持按场景自动选择模型通过models配置中的label标签匹配json复制{ agents: { defaults: { model: { primary: qclaw/modelroute, routing: { code: claude/claude-sonnet-4-7-20250611, creative: qclaw/pool-kimi-k2.7-code-highspeed, fast: qclaw/modelroute } } } } }3.3 环境变量注入敏感信息推荐将 API Key 等敏感信息放在环境变量中避免明文写入配置文件json复制{ providers: { claude: { apiKey: ${ANTHROPIC_API_KEY} } } }在系统环境变量中设置powershell复制# Windows PowerShell $env:ANTHROPIC_API_KEY sk-ant-xxxxx四、实战配置清单快速接入国产模型以腾讯混元为例json复制{ providers: { hunyuan: { baseUrl: https://hunyuan.cloud.tencent.com/hunyuan-api/v1, apiKey: ${HUNYUAN_API_KEY}, api: openai-compat, models: [ { id: hunyuan-pro, name: 混元 Pro, input: [text] } ] } } }快速接入 DeepSeekjson复制{ providers: { deepseek: { baseUrl: https://api.deepseek.com/v1, apiKey: ${DEEPSEEK_API_KEY}, api: openai-compat, models: [ { id: deepseek-chat, name: DeepSeek V3, input: [text] }, { id: deepseek-reasoner, name: DeepSeek R1推理, input: [text], reasoning: true } ] } } }接入本地 Ollamajson复制{ providers: { ollama-local: { baseUrl: http://localhost:11434/v1, apiKey: ollama, api: openai-compat, models: [ { id: qwen2.5:7b, name: Qwen 2.5 7B本地, input: [text] } ] } } }注意Ollama 默认模型名称格式为model:tag需要与ollama list输出一致。五、完整 openclaw.json 参考结构json复制{ version: 2, agents: { defaults: { model: { primary: qclaw/modelroute }, workspace: C:\\Users\\用户名\\.qclaw\\workspace, maxConcurrent: 3, timeoutSeconds: 72000, heartbeat: { isolatedSession: true, lightContext: true, model: qclaw/modelroute } }, list: [ { id: main, default: true, name: QClaw, reasoningDefault: stream, skills: [find-skills, online-search, xbrowser, qclaw-cron-skill], identity: { name: QClaw } } ] }, providers: { qclaw: { baseUrl: ${QCLAW_LLM_BASE_URL}, apiKey: ${QCLAW_LLM_API_KEY}, api: openai-compat, models: [ { id: modelroute, name: modelroute, input: [text, image], reasoning: true } ] }, claude: { apiKey: ${ANTHROPIC_API_KEY}, models: [ { id: claude-sonnet-4-7-20250611, name: Claude Sonnet 4, input: [text, image], reasoning: true, thinkingBudgetTokens: 16000 } ] }, deepseek: { baseUrl: https://api.deepseek.com/v1, apiKey: ${DEEPSEEK_API_KEY}, api: openai-compat, models: [ { id: deepseek-chat, name: DeepSeek V3, input: [text] }, { id: deepseek-reasoner, name: DeepSeek R1, input: [text], reasoning: true } ] } }, tools: { web: { search: { enabled: true } }, alsoAllow: [sessions_spawn, skillhub_install] }, browser: { enabled: true, defaultProfile: openclaw }, gateway: { port: 60802, mode: local, bind: loopback } }六、常见问题Q1配置修改后需要重启吗是的通过openclaw gateway restart重启网关使配置生效。Q2多个 Provider 同时可用时Agent 使用哪个模型按agents.defaults.model.primary指定的值决定也可以通过routing按场景分流。Q3API Key 不想写在配置里怎么办使用${环境变量名}语法引用OpenClaw 启动时自动从~/.qclaw/qclaw.env或系统环境变量读取。Q4本地模型Ollama/LM Studio接入慢或超时检查 localhost 是否可访问确认模型已加载LM Studio 左下角需显示 “Model loaded”Ollama 需提前运行ollama run model。