ClawDBot 新手配置文档

一、ClawDBot 是什么？

ClawDBot 是一个本地运行的 AI Agent / Chat 控制器，特点是：
本地运行（macOS / Linux）
支持多模型、多提供商
支持自定义 API BaseUrl（中转站）
自带 Web 控制台（Dashboard）

一句话理解：

它不是模型，它是“模型调度 + 聊天 + Agent 框架”
官方网站：
https://clawd.bot
命令行中输入一下内容，进行安装

选择yes

选择快速模式

选择跳过，我们是第三方，中转api，所以我们要跳过

这里我们也选择跳过

skills不着急安装

安装完成会给你一个链接，token需要记住

第一次访问是拒绝的

二、

二、核心配置文件在哪？

ClawDBot 的所有核心配置都在：

查看：

编辑（推荐）：

三、配置文件结构总览（先有个全局概念）

新手重点只看三个：

models

agents.defaults.model.primary

gateway

四、配置自定义 API 链接（最关键）

1️⃣ models 放在哪里？
⚠️ 必须放在 JSON 最外层，不能放 agents 里面

✅ 正确：
"models": { ... }

❌ 错误：

"agents": {
"defaults": {
"models": { ... }
}
}

2️⃣ 一个最小可用的自定义模型示例

下面是一个完全可用的示例（可直接改）：

{
  "messages": {
    "ackReactionScope": "group-mentions"
},
  "models":{
    "providers":{
      "openai":{
        "baseUrl":"https://api.apiqik.online/v1",
        "apiKey":"sk-",
        "api":"anthropic-messages",
        "models":[]
      }
    }
  },
  "agents": {
    "defaults": {
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      },
      "compaction": {
        "mode": "safeguard"
      },
      "workspace": "/Users/clawd",
      "model": {
        "primary": "openai/gpt-5.1"
      },
      "models": {
        "openai/gpt-5.1": {}
      }
    }
  },
  "gateway": {
    "mode": "local",
    "auth": {
      "mode": "token",
      "token": "0c44e23f970a0f90b825a59d5481d8a1d724406466c35a89"
    },
    "remote": {
      "token": "0c44e23f970a0f90b825a59d5481d8a1d724406466c35a89"
    },
    "port": 18789,
    "bind": "loopback",
    "tailscale": {
      "mode": "off",
      "resetOnExit": false
    }
  },
  "wizard": {
    "lastRunAt": "2026-01-28T06:31:31.110Z",
    "lastRunVersion": "2026.1.24-3",
    "lastRunCommand": "onboard",
    "lastRunMode": "local"
  },
  "meta": {
    "lastTouchedVersion": "2026.1.24-3",
    "lastTouchedAt": "2026-01-28T06:31:31.140Z"
  }
}

apiKey需要看令牌分组（Token Group）使用教程里面有配置的教程，点击进入

字段解释：

字段	说明
providers.openai	你的中转站 / API 地址
baseUrl	自定义名字（随便取）
baseUrl	你的中转站 / API 地址
apiKey	API Key
api	anthropic-messages

五、让 Agent 用你刚配的模型

关键规则

primary = 提供商名 / 模型ID

示例

"agents": {
    "defaults": {
        "model": {
            "primary": "myapi/gpt-5.1"
        }
    }
}

如果写错：

provider 不存在

model id 不匹配
👉 会直接启动失败

在地址栏中输入对话，如果模型能正常回复：

🎉 恭喜你，已经全部配置成功！

ClawDBot 新手配置文档

一、ClawDBot 是什么？#

二、核心配置文件在哪？#

三、配置文件结构总览（先有个全局概念）#

四、配置自定义 API 链接（最关键）#

五、让 Agent 用你刚配的模型#

一、ClawDBot 是什么？

二、核心配置文件在哪？

三、配置文件结构总览（先有个全局概念）

四、配置自定义 API 链接（最关键）

五、让 Agent 用你刚配的模型