夜雨聆风
openclaw 基础篇(模型和Agent 配置指南)
模型配置
OpenClaw 兼容内置 Provider 和自定义 Provider，可按成本与效果组合使用。
常见内置 Provider
anthropic（Claude）openai（GPT）openrouterminimaxzaimoonshotollama
多模型与别名
{agents: {defaults: {models: {"anthropic/claude-opus-4-6": { alias: "opus" },"anthropic/claude-sonnet-4-5": { alias: "sonnet" },"openai/gpt-5.2": { alias: "gpt" },"deepseek/deepseek-chat": { alias: "ds" },},model: {primary: "anthropic/claude-sonnet-4-5",fallbacks: ["minimax/MiniMax-M2.1"],},},},}
{agents: {defaults: {models: {"anthropic/claude-opus-4-6": { alias: "opus" },"anthropic/claude-sonnet-4-5": { alias: "sonnet" },"openai/gpt-5.2": { alias: "gpt" },"deepseek/deepseek-chat": { alias: "ds" },},model: {primary: "anthropic/claude-sonnet-4-5",fallbacks: ["minimax/MiniMax-M2.1"],},},},}
聊天中快速切换：
/model opus/model gpt/model ds
自定义 Provider（重点）
{models: {mode: "merge",providers: {"my-provider": {baseUrl: "https://api.example.com/v1",apiKey: "${MY_API_KEY}",api: "openai-responses",models: [{id: "model-name",name: "显示名称",reasoning: false,input: ["text"],contextWindow: 128000,maxTokens: 8192,}],},},},}
Codex 系列必须使用 openai-responses，不要误用 openai-completions。
Token 与成本查看
openclaw statusopenclaw dashboard
若需成本可视化，建议在消息前缀显示模型名：
{messages: {responsePrefix: "[{model}]",},}
Agent 配置
penClaw Agent 行为由工作空间配置文件驱动。
工作空间关键文件
默认目录：~/.openclaw/workspace/
AGENTS.md：行为规范
SOUL.md：人格与表达风格
USER.md：用户背景与偏好
TOOLS.md：本地工具笔记
MEMORY.md：长期记忆（仅主会话加载）
常用会话命令
/new/reset/model <alias>/thinking off|low|high/status
多 Agent 示例
{agents: {list: [{id: "personal",default: true,workspace: "~/.openclaw/workspace-personal",model: "anthropic/claude-opus-4-6",identity: { name: "小简", emoji: "🤖" },},{id: "work",workspace: "~/.openclaw/workspace-work",model: "anthropic/claude-sonnet-4-5",identity: { name: "公众号助手", emoji: "💼" },},],},}