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

科技前沿 • 2026-04-01 13:30 • 阅读 2

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

⚡⚡⚡ 新年新文⚡⚡⚡

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

主要配置模块：

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（匹配账户）

环境变量来源优先级（从高到低）：

系统环境变量
~/.openclaw/.env（全局）
./.env（工作区）
配置文件中 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

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

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

2.1，DM Policy 选项

2.2，Group Policy 选项

相关推荐