目录文章目录目录整体结构Models 配置Auth 配置Gateway 配置Channels 配置Agents 配置Tools 配置Bindings 路由绑定Messages 配置Commands 配置Hooks 配置Skills 配置Plugins 配置整体结构Models 配置Gateway 配置Channels 配置Agents 配置Tools 配置Bindings 路由绑定Messages 配置Commands 配置Hooks 配置Skills 配置Plugins 配置Models 配置models:{mode:merge,# 合并模式将此配置与现有配置合并而非完全覆盖。可选值 merge合并、replace替换providers:{# 模型提供商配置定义一个或多个模型提供者如 OpenAI、智谱、Anthropic 等zai:{baseUrl:https://open.bigmodel.cn/api/coding/paas/v4,# 智谱 API 的基础 URL所有模型请求都发往此地址api:openai-completions,# API 协议类型使用 OpenAI 兼容的 completions 接口格式OpenClaw 会自动转换请求格式models:[# 该提供者下可用的模型列表{id:glm-5-turbo,# 模型唯一标识调用时使用如 zai/glm-5name:GLM-5-turbo,# 模型显示名称用于 UI 展示和日志reasoning:true,# 推理能力标记true 表示该模型支持深度推理/思维链CoTOpenClaw 会启用相应功能input:[text# 支持的输入类型text 表示纯文本输入还可以是 [text, image] 支持多模态],cost:{# 模型费用配置用于计算使用成本input:0,# 输入 token 单价元/千 tokenoutput:0,# 输出 token 单价元/千 tokencacheRead:0,# 缓存读取费用如果支持 prompt cachingcacheWrite:0# 缓存写入费用},contextWindow:204800,# 上下文窗口大小tokens模型能处理的最大输入 token 数约 20 万 tokenmaxTokens:131072# 最大输出 token 数单次生成最多输出 13 万 token},]}}},Auth 配置auth:{# 定义了不同 AI 模型提供者如智谱、OpenAI、Anthropic 等的认证方式让 OpenClaw 能够调用这些 API。profiles:{# 认证配置档案列表zai:default:{# 档案名称provider:profileId 格式provider:zai,# 提供者智谱 AImode:api_key# 认证模式api_key - 使用静态 API Key 认证oauth - OAuth 授权流程env - 从环境变量读取。}}},Gateway 配置gateway:{port:18987,# 监听端口OpenClaw Gateway 服务监听的 TCP 端口号mode:local,# 运行模式local 表示仅本地访问还可选 public公网暴露bind:loopback,# 绑定地址loopback 即 127.0.0.1只监听本地回环地址不接受外部连接auth:{# 认证配置容器mode:token,# 认证模式使用静态 token 认证token:XXX# 认证令牌客户端连接时必须携带此 token48 位十六进制},tailscale:{# Tailscale VPN 配置用于远程安全访问mode:off,# 状态已禁用 Tailscale 集成resetOnExit:false# 退出时重置服务停止时是否清理 Tailscale 状态},nodes:{# 配对节点手机/平板等设备的控制权限denyCommands:[# 禁止执行的命令列表camera.snap,# 拍照camera.clip,# 录制视频片段screen.record,# 录屏calendar.add,# 添加日历事件contacts.add,# 添加联系人reminders.add# 添加提醒]}},Channels 配置channels:{feishu:{# 飞书渠道配置用于连接飞书/Lark 即时通讯平台enabled:true,# 启用状态飞书渠道已激活可以收发消息groupPolicy:open,# 群聊策略open 允许所有群聊消息不限制来源dmPolicy:pairing,# 私聊策略pairing 仅允许已配对用户的私聊消息需先绑定身份allowFrom:[# 白名单* 表示允许所有来源通配符可配置具体用户 ID 限制*],connectionMode:websocket,# 连接模式使用 WebSocket 长连接接收飞书事件推送accounts:{default:{appId:XXX,# 飞书应用的 App IDappSecret:XXX,# 飞书应用的 App Secret用于 API 认证domain:feishu# 域名标识feishu 中国版飞书非 Lark 国际版},}}},Agents 配置agents:{defaults:{model:{primary:zai/glm-5# 默认主模型所有智能体默认使用智谱 GLM-5},models:{zai/glm-4.7:{alias:GLM},zai/glm-5:{alias:GLM}},workspace:XXX,# 默认工作目录智能体操作文件的根目录compaction:{# 上下文压缩compactionmode:safeguard# 压缩模式当上下文接近窗口上限时自动压缩历史消息。off - 禁用压缩safeguard - 安全压缩保留关键信息aggressive - 激进压缩节省更多 token},heartbeat:{every:1h,# 心跳间隔每小时检查一次activeHours:{start:09:00,# 心跳活跃时段开始早上 9 点起end:23:00# 心跳活跃时段结束晚上 11 点止},target:last# 目标会话心跳报告发送到最近活跃的会话},maxConcurrent:4,# 主智能体最大并发数最多同时运行 4 个主会话subagents:{maxConcurrent:8# 子智能体最大并发数每个主智能体最多同时运行 8 个子任务},sandbox:{# 沙箱配置sandboxmode:off,# 沙箱模式当前已禁用直接在宿主机执行命令workspaceAccess:rw,# 工作区权限读写权限scope:agent,# 沙箱作用域agent - 每个智能体独立沙箱docker:{image:openclaw-sandbox-browser:bookworm-slim,# Docker 镜像名称workdir:/workspace,# 容器内工作目录readOnlyRoot:false,# 根文件系统可写network:bridge,# 网络模式隔离网络capDrop:[],# 不丢弃任何 Linux Kernel 能力pidsLimit:256,# 最大进程数限制memory:2g,# 内存限制 2GBcpus:2,# CPU 核心限制binds:[]# 无额外挂载卷}}},list:[# 智能体列表list{id:main,# 智能体 ID唯一标识符subagents:{allowAgents:[# 允许调用的子智能体只能调用 claudecode。主智能体是用户直接交互的默认智能体可以将编程任务委托给 claudecodeclaudecode]}},{id:claudecode,name:claudecode,workspace:XXX,# 独立工作目录与主智能体分离agentDir:XXX,# 智能体配置目录存放 prompts、skills 等model:zai/glm-5}]},Tools 配置tools:{# 控制智能体能调用哪些工具、能访问哪些范围sessions:{visibility:all# 控制当前智能体使用 sessions_list / sessions_history 工具时能看到哪些会话。# all - 可以看到系统中所有智能体的所有会话包括其他用户/智能体的# own - 只能看到当前智能体创建或参与的会话# none - 无法使用会话列表功能禁用 sessions_list 等工具},agentToAgent:{# Multi-Agent A2A 通信工具enabled:true,# 启用 A2Aallow:[# 限定生效仅 main 和 claudecode 可互通main,claudecode]}},Bindings 路由绑定bindings:[# 定义消息路由规则将来自不同渠道的消息绑定到对应的智能体。{type:route,# 绑定类型。route 路由绑定将消息路由到智能体; pairing 配对绑定将用户与智能体配对私聊场景agentId:main,# 目标智能体消息路由到 mainmatch:{channel:feishu,# 匹配渠道飞书渠道accountId:default# 匹配账号default 飞书应用}},{type:route,agentId:claudecode,match:{channel:feishu,accountId:claudecode}}],Messages 配置messages:{ackReactionScope:group-mentions# 确认反应范围仅在群聊中被提及时添加已收到表情反应# all - 所有消息都添加确认反应# group-mentions - 仅群聊中被 提及时添加反应# none - 禁用确认反应},Commands 配置commands:{# 斜杆命令配置native:auto,# 内置命令自动检测并启用系统内置命令如 /help、/statusnativeSkills:auto,# 内置技能命令自动启用技能相关命令如 /skill installrestart:true,# 重启命令允许用户通过命令重启 OpenClaw/restartownerDisplay:raw# 所有者显示模式raw - 显示原始用户信息不做脱敏处理masked - 脱敏显示隐藏部分信息},Hooks 配置hooks:{internal:{enabled:true,# 启用内部钩子系统entries:{# 具体钩子列表boot-md:{# 智能体启动时读取启动文件如 AGENTS.md、USER.mdenabled:true},command-logger:{# 执行命令时记录命令日志enabled:true},session-memory:{# 会话记忆管理enabled:true}}}},Skills 配置skills:{install:{nodeManager:npm# 包管理器使用 npm 或 pnpm 安装技能包}},Plugins 配置plugins:{entries:{# 插件列表feishu:{# 飞书插件enabled:true# 已启用}},installs:{# 已安装列表feishu:{source:npm,# 安装来源npm 仓库spec:m1heng-clawd/feishu,# npm 包名installPath:/Users/fanguiju/.openclaw/extensions/feishu,# 本地安装路径version:0.1.16,# 安装版本resolvedName:m1heng-clawd/feishu,# 解析后的包名resolvedVersion:0.1.16,# 解析后的版本resolvedSpec:m1heng-clawd/feishu0.1.16,# 完整规格字符串integrity:sha512-BRbAdogf0NrjAX8HTPHcgMQ4zsx0SEFfWgoPcFYOTeq4muvGRkAXfPR14zS0ZtTGImcijatlZvgexWB7unj/pw,# 完整性校验码SHA512shasum:47780b9ee0d1b9a8585612e6072fbd787402e03d,# SHA1 校验码resolvedAt:2026-03-11T16:15:44.443Z,# npm 解析时间installedAt:2026-03-11T16:15:52.629Z# 本地安装时间}}}