Openclaw 附录C 配置模板与自定义参考

附录C 配置模板与自定义参考本附录目标提供 openclaw.json 的常用配置片段供你在引导向导完成后按需自定义。所有模板均基于官方文档https://docs.openclaw.ai/gateway/configuration-examples验证适用于v2026.3.7版本。⚠️新手请注意你不需要手动编辑配置文件即可上手使用OpenClaw。直接运行引导向导它会交互式引导你完成全部配置并自动生成配置文件。本附录的模板适用于向导完成后的进一步自定义。配置文件路径~/.openclaw/openclaw.jsonJSON5格式支持注释和尾逗号 目录C.1 新手上手推荐方式C.2 多模型配置C.3 多平台集成配置C.4 Skills配置C.5 定时任务CronC.6 多Agent配置C.7 安全配置C.8 完整示例超级个体配置C.9 快速部署脚本C.1 新手上手推荐方式1. 最快上手直接运行引导向导强烈推荐⚠️新手不要手动编辑配置文件。OpenClaw采用严格的配置校验一个字段名拼错或结构不对Gateway就会拒绝启动。引导向导会自动生成正确的配置文件。# 第1步运行引导向导会引导你选择模型、输入API Key、配置通道等 openclaw onboard # 第2步安装并启动守护进程 openclaw daemon install openclaw daemon start # 第3步打开控制面板开始使用 openclaw dashboard向导会引导你完成以下全部配置模型选择与API Key输入支持Anthropic/OpenAI/DeepSeek/Kimi等通道配置WhatsApp/Telegram等Gateway认证Token生成工具权限设置Skills推荐安装向导完成后配置文件自动保存在~/.openclaw/openclaw.json。如需进一步自定义可使用以下方式修改# 方式1交互式配置向导推荐 openclaw configure # 方式2命令行单项修改 openclaw config set agents.defaults.heartbeat.every 30m openclaw config set session.reset.atHour 4 # 方式3打开配置文件直接编辑 openclaw config file # 显示配置文件路径用编辑器打开即可 # 方式4通过控制面板Web UI修改 openclaw dashboard # 打开后在 Config 标签页可视化编辑2. 向导完成后的常用自定义以下是向导完成后你可能想要额外调整的常见配置项。使用openclaw config set命令逐项修改即可无需手动编辑JSON文件# 设置中文身份 openclaw config set identity.name 小龙虾 openclaw config set identity.theme 专业高效的AI助手 openclaw config set identity.emoji # 开启心跳每30分钟主动检查一次 openclaw config set agents.defaults.heartbeat.every 30m openclaw config set agents.defaults.heartbeat.target last # 设置会话每日自动重置凌晨4点闲置2小时后 openclaw config set session.dmScope per-channel-peer openclaw config set session.reset.mode daily openclaw config set session.reset.atHour 4 openclaw config set session.reset.idleMinutes 120 # 确保工具权限为完整模式否则只能聊天不能干活 openclaw config set agents.defaults.tools.profile full # 修改后重启生效 openclaw daemon restartC.2 多模型配置1. 国产模型组合省钱方案⚠️ 模型认证通过openclaw models auth add命令交互式配置API Key 不直接写在配置文件中。以下配置设置模型选择和备用策略。{ agents: { defaults: { model: { // 主模型DeepSeek最便宜 primary: deepseek/deepseek-chat, // 备用模型Kimi长文档 → GLM兜底 fallbacks: [ moonshot/moonshot-v1-128k, zhipu/glm-4-flash, ], }, models: { deepseek/deepseek-chat: { alias: ds }, moonshot/moonshot-v1-128k: { alias: kimi }, zhipu/glm-4-flash: { alias: glm }, }, }, }, }配置API Key命令行执行# 添加DeepSeek认证 openclaw models auth add # 选择 deepseek → 输入 API Key # 添加Kimi认证 openclaw models auth add # 选择 moonshot → 输入 API Key # 添加智谱GLM认证 openclaw models auth add # 选择 zhipu → 输入 API Key在对话中切换模型/model ds # 切换到DeepSeek /model kimi # 切换到Kimi /model glm # 切换到GLM成本估算日常对话DeepSeek约0.001元/1K tokens长文档Kimi 128K约0.012元/1K tokens月均成本5-30元2. 国际模型配置{ agents: { defaults: { model: { primary: anthropic/claude-sonnet-4-5, fallbacks: [ openai/gpt-5.2, anthropic/claude-opus-4-6, ], }, imageModel: { primary: anthropic/claude-sonnet-4-5, }, models: { anthropic/claude-opus-4-6: { alias: opus }, anthropic/claude-sonnet-4-5: { alias: sonnet }, openai/gpt-5.2: { alias: gpt }, }, }, }, }3. 中转API配置中转API使用OpenAI兼容格式通过环境变量设置Key和BaseURL。{ env: { vars: { OPENAI_API_KEY: your-relay-api-key, OPENAI_BASE_URL: https://apipro.maynor1024.live/v1, }, }, agents: { defaults: { model: { primary: openai/gpt-4o-mini, fallbacks: [openai/gpt-4o], }, }, }, }优势✅ 一个API密钥访问多个模型✅ 国内访问速度快✅ 成本更低4. 本地模型完全免费{ agents: { defaults: { model: { primary: ollama/qwen2.5:32b, fallbacks: [ollama/llama3.1:8b], }, }, }, }前提需先安装Ollama并拉取模型curl -fsSL https://ollama.ai/install.sh | sh ollama pull qwen2.5:32bC.3 多平台集成配置1. 飞书Bot{ channels: { feishu: { enabled: true, appId: cli_your_app_id, appSecret: your_app_secret, dmPolicy: pairing, }, }, }飞书接入需安装插件openclaw plugins install m1heng-clawd/feishu详见本书第12章。2. 企业微信Bot{ channels: { wework: { enabled: true, corpId: ww_your_corp_id, agentSecret: your_agent_secret, dmPolicy: pairing, }, }, }企业微信接入需安装插件openclaw plugins install m1heng-clawd/wework详见本书第13章。3. 钉钉Bot{ channels: { dingtalk: { enabled: true, appKey: your_app_key, appSecret: your_app_secret, dmPolicy: pairing, }, }, }详见本书第13章。4. Telegram Bot{ channels: { telegram: { enabled: true, botToken: 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz, dmPolicy: pairing, allowFrom: [your_telegram_user_id], groups: { *: { requireMention: true } }, }, }, }5. 多平台同时接入{ channels: { telegram: { enabled: true, botToken: your_telegram_token, dmPolicy: pairing, groups: { *: { requireMention: true } }, }, whatsapp: { dmPolicy: pairing, allowFrom: [86138xxxxxxxx], groups: { *: { requireMention: true } }, }, discord: { enabled: true, token: your_discord_token, dm: { enabled: true }, }, }, }C.4 Skills配置⚠️ Skills通过clawhub install slug安装不在配置文件中列出安装列表。配置文件中只对已安装的Skills进行个性化配置如API Key、启停等。{ skills: { entries: { nano-banana-pro: { enabled: true, env: { GEMINI_API_KEY: your-gemini-key, }, }, brave-search: { enabled: true, env: { BRAVE_API_KEY: your-brave-key, }, }, tavily-search: { enabled: true, env: { TAVILY_API_KEY: your-tavily-key, }, }, }, }, }安装Skills命令行执行clawhub install brave-search nano-banana-pro summarize \ find-skills self-improving proactive-agent skill-vetter # 查看已安装Skills openclaw skills listC.5 定时任务Cron⚠️ 定时任务通过openclaw cron add命令创建不在配置文件中定义任务列表。配置文件中只设置Cron的全局参数。配置文件中的Cron全局设置{ cron: { enabled: true, maxConcurrentRuns: 2, sessionRetention: 24h, }, }创建定时任务命令行执行# 每天早上9点推送AI行业日报 openclaw cron add \ --name daily-ai-report \ --cron 0 9 * * * \ --tz Asia/Shanghai \ --session isolated \ --message 生成今天的AI行业日报 \ --deliver --channel feishu # 每周五18点生成周报 openclaw cron add \ --name weekly-summary \ --cron 0 18 * * 5 \ --tz Asia/Shanghai \ --session isolated \ --message 总结本周工作生成周报 \ --deliver --channel feishu # 查看/删除定时任务 openclaw cron list openclaw cron remove job-idCron表达式速查0 9 * * *— 每天9:000 18 * * 5— 每周五18:000 */2 * * *— 每2小时*/30 * * * *— 每30分钟0 9 * * 1-5— 工作日每天9:00C.6 多Agent配置{ agents: { defaults: { workspace: ~/.openclaw/workspace, model: { primary: anthropic/claude-sonnet-4-5, }, }, list: [ { id: main, default: true, workspace: ~/.openclaw/workspace-main, }, { id: content, workspace: ~/.openclaw/workspace-content, model: { primary: anthropic/claude-opus-4-6, }, }, { id: code, workspace: ~/.openclaw/workspace-code, model: { primary: deepseek/deepseek-coder, }, }, ], }, bindings: [ { agentId: content, match: { channel: telegram } }, { agentId: code, match: { channel: discord } }, ], }C.7 安全配置Gateway认证v2026.3.7必须配置{ gateway: { port: 18789, auth: { mode: token, token: your-secret-token-here, }, }, }生成安全Tokenopenssl rand -hex 32⚠️ 从v2026.3.7起Gateway认证为强制要求。沙箱配置Docker隔离{ agents: { defaults: { sandbox: { mode: non-main, scope: agent, }, }, }, }工具权限控制{ agents: { defaults: { tools: { profile: full, // full | coding | messaging }, }, }, }C.8 完整示例超级个体配置// ~/.openclaw/openclaw.json { identity: { name: 小龙虾, theme: 专业高效的AI超级个体助手, emoji: , }, gateway: { port: 18789, auth: { mode: token, token: 替换为你的随机Token }, }, agents: { defaults: { workspace: ~/.openclaw/workspace, userTimezone: Asia/Shanghai, model: { primary: deepseek/deepseek-chat, fallbacks: [moonshot/moonshot-v1-128k, zhipu/glm-4-flash], }, models: { deepseek/deepseek-chat: { alias: ds }, moonshot/moonshot-v1-128k: { alias: kimi }, zhipu/glm-4-flash: { alias: glm }, }, heartbeat: { every: 30m, target: last }, tools: { profile: full }, }, }, channels: { feishu: { enabled: true, appId: cli_your_app_id, appSecret: your_app_secret, dmPolicy: pairing, }, }, skills: { entries: { brave-search: { enabled: true, env: { BRAVE_API_KEY: your-brave-key }, }, }, }, session: { dmScope: per-channel-peer, reset: { mode: daily, atHour: 4, idleMinutes: 120 }, }, cron: { enabled: true, maxConcurrentRuns: 2 }, }配置完成后执行openclaw models auth add clawhub install skill-vetter find-skills self-improving proactive-agent \ brave-search summarize nano-banana-pro openclaw cron add --name daily-report --cron 0 9 * * * \ --tz Asia/Shanghai --session isolated \ --message 生成今日AI行业日报 --deliver --channel feishu openclaw daemon start openclaw dashboardC.9 快速部署脚本一键配置脚本Mac/Linux#!/bin/bash set -e echo OpenClaw 快速配置开始... mkdir -p ~/.openclaw/workspace TOKEN$(openssl rand -hex 32) cat ~/.openclaw/openclaw.json EOF { gateway: { port: 18789, auth: { mode: token, token: $TOKEN } }, identity: { name: 小龙虾, theme: 专业高效的AI助手, emoji: }, agents: { defaults: { workspace: ~/.openclaw/workspace, userTimezone: Asia/Shanghai, tools: { profile: full }, }, }, session: { dmScope: per-channel-peer, reset: { mode: daily, atHour: 4 } }, cron: { enabled: true }, } EOF echo ✅ 配置文件已生成Token: $TOKEN openclaw onboard clawhub install skill-vetter find-skills self-improving proactive-agent openclaw daemon install openclaw daemon start echo ✅ 完成运行 openclaw dashboard 打开控制面板 相关资源官方配置文档https://docs.openclaw.ai/gateway/configuration官方配置示例https://docs.openclaw.ai/gateway/configuration-examples官方配置字段参考https://docs.openclaw.ai/gateway/configuration-reference本书第2-4章安装部署与配置详解附录A命令速查表提示本模板基于v2026.3.7版本验证。OpenClaw配置采用严格校验未知字段会导致Gateway拒绝启动。如遇启动失败运行openclaw doctor查看具体问题。