目录文件配置

OpenClaw 配置指南

本指南按 真实使用顺序讲解 OpenClaw 的配置流程，并对每个参数做详细解释，适合第一次接触 OpenClaw 的开发者。

推荐配置顺序：

1 安装 OpenClaw
2 配置 Providers（模型服务商）
3 选择 Models（模型）
4 配置 Tools / Skills（AI能力）
5 配置 MCP Servers（外部系统）
6 创建 Agent（AI助手）
7 配置 Channels（接入方式）
8 Chat 测试
9 Monitoring 监控

---

1 Providers（模型服务商）

什么是 Provider

provider是指api\token的提供商，也就是要通过哪个平台或服务来调用大模型 API。

简单理解：

Provider = 提供 AI 模型 API 的平台

例如：

Provider	说明
OpenAI	提供 GPT 模型
DashScope	阿里云提供 Qwen 模型
DeepSeek	提供 deepseek-chat
Anthropic	提供 Claude 模型

当 OpenClaw 需要调用 AI 时，其实是通过 Provider 的 API 调用模型。

流程：

OpenClaw
   │
   ▼
Provider
   │
   ▼
LLM Model

---

Provider 参数说明

name

name: dashscope

说明：

Provider 的名称，用于在系统中区分不同的 Provider。

作用：

• 在 Agent 中选择 Provider
• 系统内部识别 Provider

示例：

openai
dashscope
deepseek

---

providerType

provideType是指 LLM 服务提供商或兼容接口类型。

providerType: DashScope

说明：

providerType 指 LLM 服务提供商的类型或 API 规范类型。

作用：

不同 Provider 的 API 格式不同，OpenClaw 需要知道如何调用。

例如：

providerType	含义
OpenAI	使用 OpenAI 官方 API 格式
OpenAI Compatible	使用 OpenAI 兼容接口
DashScope	阿里云通义千问 API
Anthropic	Claude API
DeepSeek	DeepSeek API

为什么需要这个参数：

因为不同 Provider 的 API 调用方式不同，例如：

OpenAI API
DeepSeek API
Gemini API

系统需要根据 providerType 使用对应的请求格式。

---

apiKey

apiKey: sk-xxxx

说明：

API Key 是访问 AI 服务的 认证凭证。

作用：

验证身份
统计使用量
计费

获取方式：

不同 Provider 获取方式不同，例如：

Provider	获取地址
OpenAI	https://platform.openai.com
DashScope	阿里云控制台
DeepSeek	deepseek.com

注意：

API Key 必须保密
不要提交到 Git

---

baseURL

baseURL: https://dashscope.aliyuncs.com

说明：

baseURL 指 Provider API 的访问地址。

作用：

OpenClaw 会把请求发送到这个地址。

例如：

https://api.openai.com
https://dashscope.aliyuncs.com
https://api.deepseek.com

什么时候需要修改：

使用代理
使用 API 网关
使用私有部署模型

---

timeout

timeout: 30

说明：

API 请求超时时间（秒）。

作用：

如果模型响应太慢，超过这个时间请求会被终止。

推荐：

30 秒

---

2 Models（模型）

什么是 Model

Model 指 实际执行 AI 推理的模型。我们创建完provider之后，再创建agent的时候就要选择使用哪个model

例如：

GPT-4
Qwen
DeepSeek
Claude

Provider 提供平台
Model 是具体 AI 模型。

关系：

Provider → Model

例如：

DashScope
   └── qwen-plus
   └── qwen-max

---

常见模型

Provider	模型
OpenAI	gpt-4o
DashScope	qwen-plus
DeepSeek	deepseek-chat
Anthropic	claude-3-sonnet

---

3 Tools（AI工具）

什么是 Tool

Tool 是 AI 可以调用的外部功能。通常是：HTTP API、脚本、程序、数据库查询

例如：

搜索网页
执行代码
查询数据库
调用 API

AI 本身只能生成文本，但通过 Tools 可以：

获取实时数据
执行程序
访问系统

---

Built-in Tools

系统自带工具。

位置：

Management → Built-in Tools

常见工具：

Tool	作用
web-search	搜索互联网
calculator	计算
browser	浏览网页
code-runner	执行代码
file-reader	读取文件

---

4 Custom Tools

什么是 Custom Tool

Custom Tool 是 用户自定义 API 工具。

例如：

订单查询
天气查询
库存查询

AI 调用流程：

AI
 │
 ▼
Tool
 │
 ▼
API

---

Custom Tool 参数

name

工具名称。

例如：

weather-api
order-query

---

description

工具描述。

作用：

AI 会根据描述判断什么时候使用该工具。

示例：

query current weather by city

---

endpoint

API 地址。

例如：

https://api.weather.com/current

---

method

HTTP 请求方式：

GET
POST

---

input_schema

输入参数结构。

示例：

{
  "city": "string"
}

作用：

告诉 AI 需要哪些参数。

---

5 Skills（能力）

什么是 Skill

Skill 是 对 Tool 的封装。Skill 是 AI 本身的一种能力。Skill 通常会组合一个或多个 Tool。它告诉AI具备哪些能力。

作用：

Tool = 原始 API
Skill = AI 能理解的能力

例如：

Skill: search
Tool: web-search

---

6 MCP Servers

什么是 MCP

MCP = Model Context Protocol

作用：

让 AI 可以连接外部系统。

例如：

GitHub
数据库
Notion
文件系统

AI 可以直接操作这些系统。

---

7 Agent（AI助手）

什么是 Agent

Agent 是 完整 AI 助手配置。

结构：

Agent
 ├ Model
 ├ Prompt
 ├ Tools
 ├ Skills
 └ Memory

---

Agent 参数

name

Agent 名称。

例如：

assistant
coding-agent
customer-support

---

description

Agent 的说明。

例如：

AI assistant for answering questions

---

provider

使用哪个 Provider。

例如：

dashscope
openai

---

model

使用哪个 AI 模型。

例如：

qwen-plus
gpt-4o
deepseek-chat

---

temperature

控制 AI 输出随机程度。

范围：

0 ~ 1

解释：

值	效果
0	非常稳定
0.5	平衡
1	创造性强

推荐：

0.2 ~ 0.7

---

max_tokens

最大生成 token 数量。

作用：

限制 AI 输出长度。

例如：

4000

---

system_prompt

AI 的系统提示词。

作用：

定义 AI 的角色。

示例：

You are a helpful assistant.

---

tools

Agent 可以调用哪些工具。

例如：

web-search
calculator

---

memory

是否启用记忆。

作用：

AI 记住历史对话。

---

创建agent

编辑agent

8 Channels（接入方式）

Channel 指 用户如何访问 AI。

例如：

Web
API
Slack
Discord
Telegram

---

Channel 参数

channel_type

渠道类型。

例如：

web
api
slack

---

agent

指定使用哪个 Agent。

---

9 Chat 测试

位置：

Core → Chat

测试：

hello

如果返回回答说明系统配置成功。

---

10 Monitoring

Monitoring 用于系统监控。

包括：

Traces
Usage
Logs

---

Traces

查看 AI 执行流程：

Prompt
Tool Call
Model Response

---

Usage

统计：

token
request
cost

---

Logs

系统日志。

用于排查错误。

---

推荐最小配置

Provider
  └ dashscope

Tool
  └ web-search

Agent
  └ assistant

Channel
  └ web

系统流程：

User
  │
  ▼
Channel
  │
  ▼
Agent
  │
  ▼
Model
  │
  ▼
Response

---