附录B 配置文件完整示例

这份附录只给你三套“可直接照抄”的骨架配置，避免放太多容易过期的字段。

B.1 先记住配置位置

配置文件：~/.openclaw/openclaw.json
改完配置后：重启 Gateway / OpenClaw 才会生效

先记三个词（按人话理解）：

agentDir：这个 Agent 的“状态目录”（认证、会话索引等）
bindings：消息分流规则（哪类消息交给哪个 Agent）
dmScope：私聊分会话规则（是否按人/按渠道拆开）

B.2 模板1：单人最小可运行（先跑通）

{
  gateway: {
    mode: "local",
    port: 18789,
    bind: "loopback",
    auth: { mode: "token" }
  },
  agents: {
    list: [
      {
        id: "main",
        default: true,
        workspace: "~/.openclaw/workspace",
        agentDir: "~/.openclaw/agents/main/agent"
      }
    ]
  },
  tools: {
    profile: "minimal"
  },
  session: {
    dmScope: "main"
  }
}

适用场景：第一次安装、先验证“能稳定对话”。

B.3 模板2：个人开发常用（可写代码，但有护栏）

{
  agents: {
    list: [
      {
        id: "main",
        default: true,
        workspace: "~/.openclaw/workspace",
        agentDir: "~/.openclaw/agents/main/agent"
      }
    ]
  },
  tools: {
    profile: "coding",
    deny: ["group:runtime"]
  },
  session: {
    dmScope: "main"
  },
  channels: {
    feishu: {
      appId: "cli_xxx",
      appSecret: "xxx",
      domain: "feishu.cn",
      privateChat: "pairing",
      groupChat: "enabled",
      requireMention: true
    }
  }
}

说明：先把 group:runtime 禁掉，等你确认安全策略后再按需放开。

B.4 模板3：双 Agent 分流（工作 / 个人）

{
  agents: {
    list: [
      {
        id: "home",
        default: true,
        workspace: "~/.openclaw/workspace-home",
        agentDir: "~/.openclaw/agents/home/agent",
        tools: { profile: "messaging" }
      },
      {
        id: "work",
        workspace: "~/.openclaw/workspace-work",
        agentDir: "~/.openclaw/agents/work/agent",
        tools: { profile: "coding", deny: ["group:runtime"] }
      }
    ]
  },
  bindings: [
    { agentId: "home", match: { channel: "feishu", accountId: "personal" } },
    { agentId: "work", match: { channel: "feishu", accountId: "company" } }
  ],
  session: {
    dmScope: "per-account-channel-peer"
  }
}

适用场景：同一渠道多账号，且需要严格上下文隔离。

B.5 修改配置的稳妥流程（小白必看）

先备份当前配置：

cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup

再改配置并保存。
重启 Gateway：openclaw gateway restart
立刻验证：

openclaw status
openclaw gateway status

B.6 回滚配置（出问题就用）

cp ~/.openclaw/openclaw.json.backup ~/.openclaw/openclaw.json
openclaw gateway restart