OpenClaw 初始化设置

本文档包含 OpenClaw 初始化设置相关内容的中文翻译

setup 命令

初始化 ~/.openclaw/openclaw.json 和代理工作区。

相关

• 入门：Getting started
• 向导：Onboarding

示例

openclaw setup
openclaw setup --workspace ~/.openclaw/workspace

通过 setup 运行向导：

openclaw setup --wizard

配置 (Configuration)

OpenClaw 从 ~/.openclaw/openclaw.json 读取可选的 JSON5 配置。

最小配置

{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
  channels: { whatsapp: { allowFrom: ["+15555550123"] } },
}

常用任务

设置渠道

{
  channels: {
    telegram: {
      enabled: true,
      botToken: "123:abc",
      dmPolicy: "pairing",   // pairing | allowlist | open | disabled
      allowFrom: ["tg:123"], // 仅用于 allowlist/open
    },
  },
}

选择和配置模型

{
  agents: {
    defaults: {
      model: {
        primary: "anthropic/claude-sonnet-4-5",
        fallbacks: ["openai/gpt-5.2"],
      },
    },
  },
}

控制谁可以给机器人发消息

DM 访问通过 dmPolicy 按渠道控制： - "pairing"（默认）：未知发送者获得一次性配对代码以批准 - "allowlist"：仅 allowFrom 中的发送者 - "open"：允许所有入站 DM（需要 allowFrom: ["*"]） - "disabled"：忽略所有 DM

本翻译基于 OpenClaw 官方文档