完成安装之后,你需要做两件事才能真正开始使用 OpenClaw:配置模型(告诉 OpenClaw 用哪个 AI)和配置 Channel(告诉 OpenClaw 从哪里接收你的消息)。这篇先把这两块的概念和配置入口讲清楚。
一、模型配置
模型是什么
OpenClaw 本身不内置 AI 模型,它是一个框架,负责把你发的消息转发给你指定的模型,再把回复送回来。所以第一步是告诉它用哪家的哪个模型。
内置 Provider
OpenClaw 内置支持以下 Provider,直接填 API Key 就能用,无需额外配置:
| Provider | 示例模型 ID |
|---|---|
| Anthropic | anthropic/claude-sonnet-4-6 |
| OpenAI | openai/gpt-4o |
| Google Gemini | google/gemini-2.0-flash |
| xAI | xai/grok-2 |
| Groq | groq/llama-3.3-70b-versatile |
| Mistral | mistral/mistral-large-latest |
| OpenRouter | openrouter/auto |
如何配置
推荐方式:用 onboard 向导
bash
bash
1openclaw onboard向导会引导你选择 Provider 并填入 API Key,自动写入配置文件。
手动编辑配置文件
配置文件在 ~/.openclaw/openclaw.json。设置默认模型的字段是:
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
bash
1# 先拉模型
2ollama pull llama3.3
3
4# openclaw.json 里配置
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
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
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.json的channels字段下
配置结构示例(同时启用多个 Channel):
json
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 配置!