完成安装之后,你需要做两件事才能真正开始使用 OpenClaw:配置模型(告诉 OpenClaw 用哪个 AI)和配置 Channel(告诉 OpenClaw 从哪里接收你的消息)。这篇先把这两块的概念和配置入口讲清楚。

一、模型配置

模型是什么

OpenClaw 本身不内置 AI 模型,它是一个框架,负责把你发的消息转发给你指定的模型,再把回复送回来。所以第一步是告诉它用哪家的哪个模型。

内置 Provider

OpenClaw 内置支持以下 Provider,直接填 API Key 就能用,无需额外配置:

Provider示例模型 ID
Anthropicanthropic/claude-sonnet-4-6
OpenAIopenai/gpt-4o
Google Geminigoogle/gemini-2.0-flash
xAIxai/grok-2
Groqgroq/llama-3.3-70b-versatile
Mistralmistral/mistral-large-latest
OpenRouteropenrouter/auto

如何配置

推荐方式:用 onboard 向导

bash
1openclaw onboard

向导会引导你选择 Provider 并填入 API Key,自动写入配置文件。

手动编辑配置文件

配置文件在 ~/.openclaw/openclaw.json。设置默认模型的字段是:

json
1{
2  "agents": {
3    "defaults": {
4      "model": {
5        "primary": "anthropic/claude-sonnet-4-6"
6      }
7    }
8  }
9}

模型 ID 格式统一为 provider/model-id,OpenClaw 以第一个 / 切分来识别 Provider。

本地模型

不想用付费 API?可以接本地模型:

Ollama(最简单)

bash
1# 先拉模型
2ollama pull llama3.3
3
4# openclaw.json 里配置
json
1{
2  "agents": {
3    "defaults": {
4      "model": {
5        "primary": "ollama/llama3.3"
6      }
7    }
8  }
9}

LM Studio

LM Studio 启动本地服务器后,地址默认是 http://localhost:1234,配置为 OpenAI 兼容端点即可:

json
 1{
 2  "models": {
 3    "providers": {
 4      "lmstudio": {
 5        "api": "openai-completions",
 6        "baseUrl": "http://localhost:1234"
 7      }
 8    }
 9  }
10}

免费模型推荐

方案说明
Ollama / LM Studio完全免费,只耗本地算力
OpenRouter 免费模型模型 ID 带 :free 后缀,如 openrouter/google/gemini-2.0-flash-exp:free
Groq有慷慨的免费额度,速度很快
Google Gemini有免费 API 额度

配置备用模型

主模型不可用时自动切换:

json
 1{
 2  "agents": {
 3    "defaults": {
 4      "model": {
 5        "primary": "ollama/llama3.3",
 6        "fallbacks": ["groq/llama-3.3-70b-versatile", "openrouter/auto"]
 7      }
 8    }
 9  }
10}

二、Channels 是什么

Channel 是 OpenClaw 的消息接入层。你可以把它理解成"插座":每个 IM 应用是一种插座规格,Channel 适配器负责把不同规格统一转成 OpenClaw 能处理的格式。

核心特性:

  • 同一个 OpenClaw 实例可以同时挂多个 Channel,在 Telegram 发的消息和在飞书发的消息都会被同一个 Agent 处理
  • Channel 负责处理各平台的认证、消息格式转换、富媒体渲染
  • 所有 Channel 配置都写在 ~/.openclaw/openclaw.jsonchannels 字段下

配置结构示例(同时启用多个 Channel):

json
 1{
 2  "channels": {
 3    "telegram": {
 4      "enabled": true,
 5      "botToken": "你的 token"
 6    },
 7    "feishu": {
 8      "enabled": true,
 9      "accounts": {
10        "main": {
11          "appId": "cli_xxx",
12          "appSecret": "你的 secret"
13        }
14      }
15    }
16  }
17}

三、本系列覆盖的 Channel

接下来三篇会逐一讲解:

Channel难度主要前置条件
第3篇Telegram简单,15分钟内完成Telegram 账号
第4篇飞书中等,需创建企业应用飞书账号(个人即可)
第5篇微信 ClawBot简单(官方插件方案)微信 iOS ≥ 8.0.70

OpenClaw 支持 50+ 个 Channel,除上述三个外,其他常见的还有:

  • Discord(设置简单,推荐新手)
  • Slack / Microsoft Teams / Google Chat(企业场景)
  • WhatsApp / Signal / iMessage
  • Matrix / Nostr(去中心化)
下一篇开始实战:Telegram Channel 配置!