小龙虾-养虾人的终极配置指南—详解OpenClaw.json

小龙虾-养虾人的终极配置指南—详解OpenClaw.json

⚡⚡⚡ 新年新文⚡⚡⚡



安装使用OpenClaw 过程中,如何配置 openclaw.json是用好小龙虾的关键 ,本文大部分内容来自官方文档,现整理如下,希望能帮到养虾人。

OpenClaw 官方文档:https://docs.openclaw.ai
openclaw 龙虾 GitHub:https://github.com/openclaw/openclaw
配置示例:https://docs.openclaw.ai/gateway/configuration-examples

配置文件:
配置格式:JSON5(支持注释和尾随逗号)
严格验证:未知字段会导致 Gateway 拒绝启动

主要配置模块:

  • channels – 渠道配置
  • agents – Agent 配置
  • models – 模型配置
  • gateway – Gateway 服务器配置
  • tools – 工具配置
  • session – 会话配置
  • cron – 定时任务
  • bindings – 路由绑定
字段 类型 默认值 说明 enabled boolean true 是否启用该渠道 dmPolicy string pairing DM 消息策略 allowFrom array [] 允许的用户列表 groupPolicy string allowlist 群聊策略 historyLimit number 50 历史消息限制 configWrites boolean true 允许渠道端配置修改

2.1,DM Policy 选项

  • pairing(默认):未知用户获得一次性配对码,需管理员批准
  • allowlist:仅允许 allowFrom 列表中的用户
  • open:允许所有 DM(需设置 allowFrom: [“*”])
  • disabled:忽略所有 DM

2.2,Group Policy 选项

  • allowlist(默认):仅允许配置中的群组
  • open:允许所有群组(提及门控仍适用)
  • disabled:阻止所有群聊消息

WhatsApp 配置示例


关键字段:dmPolicy、allowFrom、textChunkLimit、mediaMaxMb、groups

Telegram 配置示例


关键字段:botToken、groups、customCommands、streaming

Discord 配置示例


关键字段:token、guilds、threadBindings

Slack 配置示例


关键字段:botToken、appToken、slashCommand


关键字段:list(Agent 列表)、defaults.model(默认模型)、defaults.workspace(默认工作区)


关键字段:mode(合并模式)、providers(模型提供商配置)


热重载模式说明

模式 行为 hybrid(默认) 安全变更热应用,关键变更自动重启 hot 仅热应用安全变更,需重启时记录警告 restart 任何变更都重启 off 禁用热重载,手动重启生效

关键字段:schedule(Cron 表达式)、payload.kind(事件类型)、payload.text(执行内容)

Cron 表达式示例:

  • 0 10 * * * – 每天 10:00 执行
  • 0 */4 * * * – 每 4 小时执行
  • 30 7 * * * – 每天 7:30 执行

关键字段:agentId(目标 Agent)、match.channel(匹配渠道)、match.accountId(匹配账户)


环境变量来源优先级(从高到低):

  1. 系统环境变量
  2. ~/.openclaw/.env(全局)
  3. ./.env(工作区)
  4. 配置文件中 env 字段
任务 配置字段 示例 添加 WhatsApp channels.whatsapp 见上方示例 配置多 Agent agents.list[] 添加多个 Agent 对象 设置默认模型 agents.defaults.model { primary: “anthropic/…” } 启用沙盒 sandbox.enabled true 配置定时任务 cron[] 添加 cron 对象 修改 Gateway 端口 gateway.port 18789 启用热重载 gateway.reload.mode “hybrid” 路由渠道到 Agent bindings[] 添加 binding 对象

验证命令


常见问题

问题 可能原因 解决方案 Gateway 拒绝启动 配置中有未知字段 运行 openclaw doctor 检查 渠道无法连接 Token 错误或过期 检查 channels.*.botToken 消息无响应 DM/Group 策略限制 检查 dmPolicy 和 groupPolicy 模型调用失败 API Key 无效 检查 models.providers.*.apiKey

感谢阅读,下期更精彩 👋👋👋

神经网络动画结尾
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请联系我们举报,一经查实,本站将立刻删除。

发布者:全栈程序员-站长,转载请注明出处:https://javaforall.net/257396.html原文链接:https://javaforall.net

(0)
上一篇 2026年3月13日 上午10:20
下一篇 2026年3月13日 上午10:20


相关推荐

关注全栈程序员社区公众号