OpenClaw 配置速查手册｜最小配置、常用配置片段与完整模板

本系列第十三篇：一键复制，即贴即用——从此告别配置文件的手动折腾，让配置 OpenClaw 像填表格一样简单欢迎来到 OpenClaw 系列教程。经过前面十二篇的洗礼，你已经完成了从安装、模型接入到灵魂配置的全过程。但你可能会发现，每次配置一个新环境，或者想要微调某个功能时，总得翻半天文档。这就是本篇存在的意义。我将把 OpenClaw 配置中最常用、最核心的部分提炼成可直接复制粘贴的代码片段——从最小化配置到完整模板，从 CLI 命令到环境变量，从 workspace 核心文件到常见错误修复。你不需要再逐行解读文档，只需要找到你要改的功能，复制片段，粘贴到你的配置文件中，调整几个关键参数即可。本文分为八个部分，你可以按需跳转，也可以当作案头手册随时查阅。一、最小化配置（可运行版）如果你只想让 OpenClaw 快速跑起来，不需要花哨功能，下面这个配置就是你的起点。它只包含最基本的模型配置和一个 Agent。文件位置：~/.openclaw/openclaw.jsonjson{ "agents": { "defaults": { "model": { "primary": "bailian/qwen-plus" // 替换为你自己的模型 } } }, "models": { "providers": { "bailian": { "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1", "apiKey": "${DASHSCOPE_API_KEY}", "api": "openai-completions", "models": [ { "id": "qwen-plus", "name": "通义千问 Plus" } ] } } } }配套环境变量（在~/.zshrc或~/.bashrc中设置）：bashexport DASHSCOPE_API_KEY="sk-你的API密钥"然后执行：bashsource ~/.zshrc # 或 source ~/.bashrc openclaw gateway restart搞定。你的 OpenClaw 现在可以对话了。二、核心配置片段（按功能分类）以下片段可直接插入到你的openclaw.json的对应位置。所有片段假设你已经有一个基础的models.providers配置。2.1 模型配置片段单模型 + 降级（推荐生产环境）：json{ "agents": { "defaults": { "model": { "primary": "bailian/qwen-plus", "fallbacks": ["openai/gpt-4o-mini", "ollama/llama3.3"] } } } }多模型白名单（限制 Agent 可用的模型列表）：json{ "agents": { "defaults": { "models": { "bailian/qwen-plus": { "alias": "通义千问" }, "openai/gpt-4o": { "alias": "GPT-4o" }, "ollama/llama3.3": { "alias": "本地Llama" } } } } }Ollama 自动发现（零配置）：bashexport OLLAMA_API_KEY="ollama-local" # 无需修改 openclaw.jsonLM Studio 完整配置：json{ "models": { "mode": "merge", "providers": { "lmstudio": { "baseUrl": "http://127.0.0.1:1234/v1", "apiKey": "lmstudio", "api": "openai-responses", "models": [ { "id": "openai/gpt-oss-20b", "name": "GPT-OSS 20B", "contextWindow": 32000, "maxTokens": 8192 } ] } } }, "agents": { "defaults": { "model": { "primary": "lmstudio/openai/gpt-oss-20b" }, "models": { "lmstudio/openai/gpt-oss-20b": { "alias": "GPT-OSS" } } } } }2.2 Agent 行为配置片段调整温度（控制输出随机性）：json{ "agents": { "defaults": { "temperature": 0.2 // 0.0~1.0，0.2 最严谨 } } }配置心跳（定时后台任务）：json{ "agents": { "defaults