OpenClaw配置全流程

发布时间：2026-03-18 11:07:24 作者：Yeats_Liao

本文给大家介绍OpenClaw配置全流程，本文给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友参考下吧

1. 配置文件位置

Windows: C:\Users\<您的用户名>\.openclaw\openclaw.json
macOS/Linux: ~/.openclaw/openclaw.json

如何找到配置文件:

Windows:

# 方法一: 直接打开文件夹
explorer C:\Users\$env:USERNAME\.openclaw
# 方法二: 查看配置文件内容
type C:\Users\$env:USERNAME\.openclaw\openclaw.json

macOS/Linux:

# 方法一: 打开文件夹
open ~/.openclaw  # macOS
nautilus ~/.openclaw  # Linux (GNOME)
# 方法二: 查看配置文件内容
cat ~/.openclaw/openclaw.json

2. 配置大模型 API Key

方法一: 直接编辑配置文件 (推荐)

步骤 1: 打开配置文件

Windows:

# 使用记事本打开
notepad C:\Users\$env:USERNAME\.openclaw\openclaw.json
# 或使用 VS Code 打开
code C:\Users\$env:USERNAME\.openclaw\openclaw.json

macOS/Linux:

# 使用默认编辑器打开
open -e ~/.openclaw/openclaw.json  # macOS (TextEdit)
# 或使用 VS Code 打开
code ~/.openclaw/openclaw.json

步骤 2: 根据您的模型提供商修改配置

华为云 (MaaS) 配置

获取 API Key

访问: https://developer.huaweicloud.com/space/developerspace/tokens.html
登录华为云账号
创建或复制您的 API Key

配置文件内容

{
  "auth": {
    "profiles": {
      "huawei:default": {
        "provider": "huawei",
        "mode": "api_key"
      }
    }
  },
  "models": {
    "providers": {
      "huawei": {
        "baseUrl": "https://api.modelarts-maas.com/openai/v1",
        "apiKey": "在这里粘贴您的华为云API Key",
        "api": "openai-completions",
        "models": [
          {
            "id": "deepseek-v3.2",
            "name": "deepseek-v3.2"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "huawei/deepseek-v3.2"
      },
      "models": {
        "huawei/deepseek-v3.2": {}
      },
      "workspace": "~/.openclaw/workspace",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },
  "messages": {
    "ackReactionScope": "group-mentions"
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto",
    "restart": true,
    "ownerDisplay": "raw"
  },
  "session": {
    "dmScope": "per-channel-peer"
  },
  "channels": {},
  "gateway": {
    "mode": "local"
  },
  "plugins": {}
}

关键配置项说明

models.providers.huawei.apiKey: 您的华为云 API Key
models.providers.huawei.models[0].id: 模型 ID (如 deepseek-v3.2, glm-5 等)
agents.defaults.model.primary: 默认使用的模型,格式为 huawei/<模型ID>

Doubao (火山引擎) 配置

获取 API Key 和 Endpoint ID

访问火山引擎控制台
进入"方舟大模型平台"
创建推理接入点,获取 Endpoint ID
获取 API Key

配置文件内容

{
  "auth": {
    "profiles": {
      "doubao:default": {
        "provider": "doubao",
        "mode": "api_key"
      }
    }
  },
  "models": {
    "providers": {
      "doubao": {
        "baseUrl": "https://ark.cn-beijing.volces.com/api/v3",
        "apiKey": "在这里粘贴您的Doubao API Key",
        "api": "openai-completions",
        "models": [
          {
            "id": "在这里粘贴您的Endpoint ID",
            "name": "Doubao-1.8"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "doubao/在这里粘贴您的Endpoint ID"
      },
      "models": {
        "doubao/在这里粘贴您的Endpoint ID": {}
      },
      "workspace": "~/.openclaw/workspace",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },
  "messages": {
    "ackReactionScope": "group-mentions"
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto",
    "restart": true,
    "ownerDisplay": "raw"
  },
  "session": {
    "dmScope": "per-channel-peer"
  },
  "channels": {},
  "gateway": {
    "mode": "local"
  },
  "plugins": {}
}

关键配置项说明

models.providers.doubao.apiKey: 您的 Doubao API Key
models.providers.doubao.models[0].id: 您的 Endpoint ID (如 ep-20240604052306-abcde)
agents.defaults.model.primary: 格式为 doubao/<Endpoint ID>

Anthropic 配置

获取 API Key

访问: https://console.anthropic.com/
登录或注册账号
在 API Keys 页面创建新的 API Key

配置文件内容

{
  "auth": {
    "profiles": {
      "anthropic:default": {
        "provider": "anthropic",
        "mode": "api_key"
      }
    }
  },
  "models": {
    "providers": {
      "anthropic": {
        "baseUrl": "https://api.anthropic.com",
        "apiKey": "在这里粘贴您的Anthropic API Key",
        "api": "anthropic-chat",
        "models": [
          {
            "id": "claude-3-5-sonnet-20240620",
            "name": "claude-3-5-sonnet-20240620"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-3-5-sonnet-20240620"
      },
      "models": {
        "anthropic/claude-3-5-sonnet-20240620": {}
      },
      "workspace": "~/.openclaw/workspace",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },
  "messages": {
    "ackReactionScope": "group-mentions"
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto",
    "restart": true,
    "ownerDisplay": "raw"
  },
  "session": {
    "dmScope": "per-channel-peer"
  },
  "channels": {},
  "gateway": {
    "mode": "local"
  },
  "plugins": {}
}

关键配置项说明

models.providers.anthropic.apiKey: 您的 Anthropic API Key
models.providers.anthropic.api: 必须是 anthropic-chat
models.providers.anthropic.models[0].id: 模型名称 (如 claude-3-5-sonnet-20240620)
agents.defaults.model.primary: 格式为 anthropic/<模型名称>

保存配置文件

编辑完成后,保存文件:

记事本: Ctrl + S
VS Code: Ctrl + S 或 Cmd + S (macOS)

方法二：使用命令行配置

优点: 不需要手动编辑 JSON 文件,减少格式错误。

步骤 1: 设置 gateway 模式

openclaw config set gateway.mode local

步骤 2: 配置华为云 (示例)

# 设置 baseUrl
openclaw config set models.providers.huawei.baseUrl https://api.modelarts-maas.com/openai/v1
# 设置 API Key
openclaw config set models.providers.huawei.apiKey "您的API Key"
# 设置 API 类型
openclaw config set models.providers.huawei.api "openai-completions"
# 设置模型列表 (JSON 格式)
openclaw config set models.providers.huawei.models --json '[{"id":"deepseek-v3.2","name":"deepseek-v3.2"}]'
# 设置默认模型
openclaw config set agents.defaults.model.primary "huawei/deepseek-v3.2"

步骤 3: 验证配置

# 查看完整配置
openclaw config get
# 查看特定配置项
openclaw config get models.providers.huawei.apiKey

到此这篇关于OpenClaw（二）：配置教程的文章就介绍到这了,更多相关OpenClaw配置教程内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多支持脚本之家！

Tag：OpenClaw配置教程 OpenClaw配置

OpenClaw本地配置QQ Bot的使用流程
本文档详细介绍了在Mac本地环境配置OpenClaw与QQ机器人对接的完整流程,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随
2026-03-18
OpenClaw环境变量配置的完整指南
文章讲述了作者在配置环境变量时遇到的问题,以及如何通过在shell配置文件和systemd服务配置中双重设置环境变量来解决这个问题,作者还分享了常见的错误及解决方法,并提出了
2026-03-17
OpenClaw多Agent配置实战指南:从零搭建你的AI团队
通过 OpenClaw 配置多 Agent，你可以将“一个人”拆解为一支分工明确的 AI 团队,本指南将带你从架构选择到实战配置，完成多 Agent 的部署,感兴趣的小伙伴可以跟随小编一起
2026-03-16
openclaw的tools配置详细
本文详细介绍了配置项"tools"的各个部分,包括profile、allow、deny和exec,以及approval配置，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的
2026-03-13
Mac安装和配置OpenClaw的超详细保姆级教程(附 skills安装)
OpenClaw是一个开源的AI助手框架,支持多模型接入和技能扩展,适用于多渠道聊天,文章详细介绍了Mac上安装和配置OpenClaw的步骤,包括安装OpenClaw CLI、验证安装、完成onboard
2026-03-12
OpenClaw 从零配置指南并接入飞书 + 常用命令 + 原理全解析
本文介绍了如何从零配置OpenClaw并接入飞书,包括安装、配置、权限设置、模型切换、技能管理等步骤,以及常用命令和配置文件说明，感兴趣的朋友跟随小编一起看看吧
2026-03-12
OpenClaw主配置文件参数使用大全
OpenClaw 使用 JSON/JSON5 格式的配置文件来管理系统所有组件的设置，支持灵活的配置覆盖、环境变量注入、多配置文件合并、热重载等功能,本文就来详细的介绍一下OpenClaw主
2026-03-10
OpenClaw使用DeepSeek官方API_KEY配置超详细教程
近期 OpenClaw突然火了,但是网上居然没有在openclaw配置deepseek官方apikey的相关教程，所以下面这篇文章主要介绍了OpenClaw使用DeepSeek官方API_KEY配置的相关资料,文中将
2026-03-09
OpenClaw 安装与配置实战指南(含常用命令 + 故障排查)
OpenClaw安装与配置实战,涵盖了从安装到故障排查的详细流程,重点包括通道配置、模型接入和网关排障,提供了常用命令速查和故障排查步骤,帮助用户顺利上手和解决常见问题，本
2026-03-06