第 4 章 · 免费

⚙️ 基础配置

配置文件位置

OpenClaw 的配置文件是 ~/.openclaw/openclaw.json，使用 JSON5 格式（支持注释和尾逗号）。

# 查看配置文件
cat ~/.openclaw/openclaw.json

# 用编辑器打开
nano ~/.openclaw/openclaw.json
# 或
code ~/.openclaw/openclaw.json

首次运行向导（openclaw onboard）

安装后运行向导，它会引导你完成基本配置：

openclaw onboard --install-daemon

向导会帮你：

  1. ✅ 设置 Gateway 认证 Token
  2. ✅ 选择并配置 AI 模型
  3. ✅ （可选）配置消息渠道
  4. ✅ 安装系统守护进程（开机自启）
💡 提示： 如果向导出错，可以用 openclaw doctor --fix 修复。

最小可用配置

如果你只想尽快用起来，这是最小配置：

// ~/.openclaw/openclaw.json
{
  // 模型配置（选一个你有 API Key 的）
  agents: {
    defaults: {
      model: {
        primary: "anthropic/claude-sonnet-4-5",
      },
      workspace: "~/.openclaw/workspace",
    },
  },
}

然后设置环境变量：

# 在 ~/.openclaw/.env 中写入
ANTHROPIC_API_KEY=sk-ant-api03-xxxxx

启动 Gateway：

openclaw gateway status    # 如果守护进程已安装，应该已在运行
# 或手动前台运行
openclaw gateway --port 18789

打开浏览器访问 http://127.0.0.1:18789 即可开始聊天 🎉

配置文件详解

完整示例（带注释）

{
  // ===== Gateway 网关配置 =====
  gateway: {
    mode: "local",           // local=本机运行, remote=连接远程Gateway
    port: 18789,             // 端口号
    bind: "loopback",        // loopback=仅本机, lan=局域网可访问
    auth: {
      token: "your-secret-token",  // 认证 Token（向导自动生成）
    },
  },

  // ===== Agent 代理配置 =====
  agents: {
    defaults: {
      workspace: "~/.openclaw/workspace",  // 工作空间目录
      model: {
        primary: "anthropic/claude-sonnet-4-5",  // 主模型
        fallbacks: ["deepseek/deepseek-chat"],   // 备用模型
      },
      thinkingDefault: "low",     // 思考模式: off/low/high
      timeoutSeconds: 600,        // 超时时间（秒）
      heartbeat: {
        every: "30m",             // 心跳间隔
        target: "last",           // 心跳消息发送目标
      },
    },
  },

  // ===== 渠道配置 =====
  channels: {
    telegram: {
      enabled: true,
      botToken: "123456:ABC...",
      dmPolicy: "pairing",       // 配对模式（安全）
    },
  },

  // ===== 环境变量 =====
  env: {
    ANTHROPIC_API_KEY: "sk-ant-xxx",
    // 或者写在 ~/.openclaw/.env 文件里更安全
  },
}

环境变量设置方式

推荐使用 .env 文件存放 API Key（不会被误提交到 Git）：

# ~/.openclaw/.env
ANTHROPIC_API_KEY=sk-ant-api03-xxxxx
OPENAI_API_KEY=sk-xxxxx
DEEPSEEK_API_KEY=sk-xxxxx
BRAVE_API_KEY=BSAxxxxx
TELEGRAM_BOT_TOKEN=123456:ABC-DEF

也可以在配置文件中引用环境变量：

{
  gateway: {
    auth: {
      token: "${OPENCLAW_GATEWAY_TOKEN}",
    },
  },
}

模型配置

Anthropic Claude（推荐 🌟）

# 设置环境变量
echo "ANTHROPIC_API_KEY=sk-ant-api03-xxxxx" >> ~/.openclaw/.env

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-sonnet-4-5" },
      models: {
        "anthropic/claude-sonnet-4-5": { alias: "sonnet" },
        "anthropic/claude-opus-4-6": { alias: "opus" },
      },
    },
  },
}

OpenAI GPT

{
  agents: {
    defaults: {
      model: { primary: "openai/gpt-5.2" },
      models: {
        "openai/gpt-5.2": { alias: "gpt" },
        "openai/gpt-5-mini": { alias: "gpt-mini" },
      },
    },
  },
}

DeepSeek（国内推荐 🇨🇳）

{
  agents: {
    defaults: {
      model: { primary: "deepseek/deepseek-chat" },
    },
  },
  models: {
    mode: "merge",
    providers: {
      deepseek: {
        baseUrl: "https://api.deepseek.com/v1",
        apiKey: "${DEEPSEEK_API_KEY}",
        api: "openai-completions",
        models: [{
          id: "deepseek-chat",
          name: "DeepSeek Chat",
          reasoning: false,
          input: ["text"],
          contextWindow: 128000,
          maxTokens: 8192,
        }],
      },
    },
  },
}

通义千问（阿里云百炼）

{
  agents: {
    defaults: {
      model: { primary: "qwen/qwen3-max" },
    },
  },
  models: {
    mode: "merge",
    providers: {
      qwen: {
        baseUrl: "https://dashscope.aliyuncs.com/compatible-mode/v1",
        apiKey: "${DASHSCOPE_API_KEY}",
        api: "openai-completions",
        models: [{
          id: "qwen3-max",
          name: "通义千问3 Max",
          reasoning: false,
          input: ["text"],
          contextWindow: 128000,
          maxTokens: 8192,
        }],
      },
    },
  },
}

⚠️ 百炼模型注意：reasoning 参数必须设为 false。

配置修改方式

方式一：直接编辑文件

nano ~/.openclaw/openclaw.json
# 修改后重启
openclaw gateway restart

方式二：命令行

# 设置单个配置
openclaw config set agents.defaults.model.primary "anthropic/claude-opus-4-6"

# 查看配置
openclaw config get

方式三：Web 控制台

打开 http://127.0.0.1:18789，在设置界面修改。

方式四：让 Agent 帮你改

直接在聊天中说："帮我把默认模型切换到 Claude Opus"，Agent 会自动修改配置并重启 Gateway。

验证配置

# 运行诊断检查
openclaw doctor

# 查看当前模型
openclaw status

# 测试发送消息
openclaw dashboard   # 在浏览器中聊天测试

下一步 → 消息渠道配置

上一章下一章：消息渠道配置

加入 Claw101 社区

解锁第 7-13 章、持续更新资源和实战交流，扫码即可加入社区。

Claw101 社区二维码

长按识别二维码，支付后自动弹出群二维码