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

{  "agents": {    "defaults": {      "model": {        "primary": "bailian/qwen-plus"   // 替换为你自己的模型      }    }  },  "models": {    "providers": {      "bailian": {        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",        "apiKey": "{TELEGRAM_BOT_TOKEN}",      "allowFrom": ["@yourusername"]    }  }}

{  "channels": {    "discord": {      "enabled": true,      "botToken": "{SLACK_BOT_TOKEN}",      "signingSecret": "{OPENCLAW_GATEWAY_TOKEN}"  }}

{  "gateway": {    "controlUi": {      "allowedOrigins": [        "http://localhost:18789",        "http://127.0.0.1:18789",        "https://yourdomain.com"      ]    }  }}

{  "session": {    "ttl": "24h",            // 会话过期时间    "maxHistory": 50         // 保留最近消息数  },  "memory": {    "vectorStore": "lancedb", // lancedb, sqlite, 或 none    "embeddingModel": "local" // 或指定模型  }}

{  "logging": {    "level": "info",         // debug, info, warn, error    "file": "~/.openclaw/logs/gateway.log",    "maxSize": "50m"  }}

{  // ==================== Agent 配置 ====================  "agents": {    "defaults": {      "workspace": "~/.openclaw/workspace",      "model": {        "primary": "bailian/qwen-plus",        "fallbacks": ["openai/gpt-4o-mini"]      },      "temperature": 0.2,      "heartbeat": {        "every": "30m",        "target": "last"      },      "sandbox": {        "mode": "non-main"      },      // 可选：限制可用模型列表      "models": {        "bailian/qwen-plus": { "alias": "通义千问" },        "openai/gpt-4o-mini": { "alias": "GPT-4o Mini" }      }    }  },  // ==================== 模型配置 ====================  "models": {    "mode": "merge",    "providers": {      "bailian": {        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",        "apiKey": "{OPENAI_API_KEY}",        "api": "openai-completions",        "models": [          { "id": "gpt-4o-mini", "name": "GPT-4o Mini", "contextWindow": 128000, "maxTokens": 16384 }        ]      }    }  },  // ==================== 渠道配置（按需启用） ====================  "channels": {    "telegram": {      "enabled": false,      "botToken": "{DISCORD_BOT_TOKEN}"    }  },  // ==================== 工具与安全 ====================  "tools": {    "allow": ["read", "write", "edit", "web_search", "message"],    "deny": ["exec", "browser"]  },  "browser": {    "enabled": false,    "headless": true  },  // ==================== Gateway 网络 ====================  "gateway": {    "bind": "localhost",    "port": 18789,    "token": "${OPENCLAW_GATEWAY_TOKEN}",    "controlUi": {      "allowedOrigins": ["http://localhost:18789", "http://127.0.0.1:18789"]    }  },  // ==================== 会话与记忆 ====================  "session": {    "ttl": "24h",    "maxHistory": 50  },  "memory": {    "vectorStore": "lancedb"  },  // ==================== 日志 ====================  "logging": {    "level": "info",    "file": "~/.openclaw/logs/gateway.log"  }}

# 我是谁我是一个专注、高效的 AI 助理，擅长处理技术问题和自动化任务。# 我的沟通风格- 回答简洁直接，不废话- 复杂问题逐步拆解，关键结论用 **加粗**- 技术术语保留英文（如 API、Agent、LLM）# 我的核心价值观- **安全第一**：任何可能造成数据丢失的操作，必须请求用户确认- **诚实为先**：不知道就说不知道，绝不编造信息# 我的底线- 绝不删除 `.env`、`*.key`、`*.pem` 等配置文件- 绝不执行 `rm -rf` 等危险命令

# Agent: 主智能体## 我的职责负责代码开发辅助、文件管理、自动化任务调度。## 我的工作流程每次会话开始，自动执行：1. 读取 SOUL.md —— 确认身份和底线2. 读取 USER.md —— 确认用户偏好3. 读取 memory/YYYY-MM-DD.md —— 加载近日上下文## 我的执行规范- 修改代码前必须先查看文件完整内容- 删除任何文件前必须请求确认- 遇到环境错误优先使用 `openclaw doctor` 诊断## 我的输出规范- 分点清晰，关键信息加粗- 代码块标注语言类型

# 关于我## 基础信息- 称呼：你的名字- 时区：Asia/Shanghai- 职业：开发者## 技术偏好- 编程语言：TypeScript > JavaScript- 代码风格：2空格缩进，使用 ESLint## 沟通偏好- 回答简洁，代码优先于文字说明- 复杂问题先给结论，再展开细节## 我的忌讳- 别生成冗余注释- 别用过度客套的称呼

# 重要事实- 用户的项目使用 React 18 + TypeScript + Vite- 用户喜欢用 pnpm 而不是 npm# 用户偏好演进- 2026-04-10：用户希望 PR 描述更结构化

# 首次启动指南欢迎！这是你的 AI 助理。请确保：1. 我已配置好大模型 API Key2. 如需使用微信/Telegram，请完成渠道配置3. 首次使用请说“你好”开始对话

# 心跳任务清单## 每 30 分钟- 检查系统负载- 检查是否有新通知## 每小时- 检查待处理任务## 每天凌晨- 生成日报摘要

# 模型 API Keysexport DASHSCOPE_API_KEY="sk-xxxx"          # 阿里云百炼export OPENAI_API_KEY="sk-xxxx"             # OpenAIexport ANTHROPIC_API_KEY="sk-xxxx"          # Anthropic Claudeexport MOONSHOT_API_KEY="sk-xxxx"           # Kimiexport DEEPSEEK_API_KEY="sk-xxxx"           # DeepSeek# 本地模型export OLLAMA_API_KEY="ollama-local"        # Ollama 自动发现export OLLAMA_HOST="http://127.0.0.1:11434" # Ollama 地址（可选）export SGLANG_API_KEY="sglang-local"        # SGLang 自动发现# Gateway 安全export OPENCLAW_GATEWAY_TOKEN="your-token"  # 网关访问令牌# 渠道 Tokensexport TELEGRAM_BOT_TOKEN="xxx:xxx"export DISCORD_BOT_TOKEN="xxx"export SLACK_BOT_TOKEN="xoxb-xxx"

# 检查所有配置和环境openclaw doctor# 自动修复常见问题（如端口冲突、权限、配置格式）openclaw doctor --repair# 检查 Gateway 是否运行openclaw gateway status# 查看实时日志openclaw gateway logs# 测试模型连通性（发送一条测试消息）openclaw message send --to me "Hello, this is a test."