OpenClaw 配置文件参数说明文档

1. 身份认证配置 (auth-profiles.json)

该文件专门用于存放敏感的 API 密钥，实现“钥匙”与“模型规格”的分离。

• profiles: 定义不同供应商的认证信息集。

  • type: 认证类型，通常为 "api_key"。

  • provider: 对应的供应商名称（如 volcengine 或 moonshot）。

  • key: 实际的 API 密钥字符串。

• usageStats: 记录各渠道的最后使用时间及错误统计，用于系统监控。

2. 模型定义配置 (models.json / openclaw.json)

此部分定义了系统可以调用的“大脑”及其各项技术参数。

供应商层级 (providers)

• baseUrl: API 接口的服务器地址（如火山引擎的 Ark 接入点）。

• api: 通信协议格式。设置为 "openai-completions" 表示使用兼容 OpenAI 的标准接口。

具体模型层级 (models)

• id: 关键字段。火山引擎必须填写以 ep- 开头的推理终端 ID，Kimi 则使用模型名（如 kimi-k2.5）。

• name: 在 UI 界面显示的友好名称。

• reasoning: 布尔值。若设为 true，系统会解析并展示模型的“思维链”（如 DeepSeek R1），普通模型应设为 false。

• input: 支持的媒体类型。目前仅支持 ["text", "image"]，不支持 "video"，填入不支持的类型会导致启动失败。

• contextWindow: 上下文窗口大小（Token 数）。决定了模型一次能“记住”多长的对话记录（如 256000）。

• maxTokens: 限制模型单次回复的最大长度，防止消耗过多额度。

• cost: 计费配置。

  • input / output: 每 1,000 Tokens 的费用（元）。

  • cacheRead: 命中上下文缓存时的优惠单价。

3. 智能体与网关设置 (openclaw.json)

智能体默认值 (agents.defaults)

• model.primary: 系统默认使用的主力模型 ID（格式为 供应商/ID）。

• models (别名映射):

  • alias: 为长 ID 模型起的外号。用户在聊天框输入 /model [alias] 即可快速切换。

• compaction.mode: 上下文压缩模式。"safeguard" 表示在接近窗口上限时自动触发保护性修剪。

飞书集成 (channels.feishu)

• appId / appSecret: 飞书开放平台应用的凭据，用于机器人身份识别。

• botName: 飞书机器人的显示名称（如 chaowei bot）。

网关安全 (gateway)

• token: 关键字段。Web 控制台连接后台所需的授权密码。

• 报错处理: 若界面提示 unauthorized，需将此 Token 粘贴至 UI 的设置面板中。

4. 常见操作指令

• openclaw gateway run: 启动服务。

• openclaw doctor --fix: 自动检测并修复配置文件中的语法或逻辑错误。

建议方案：在修改配置后，请务必删除 input 字段中的 "video"，并确保火山引擎的 id 已替换为 ep- ID，否则系统将无法正常启动或调用。