手把手:OpenClaw 基础配置设置的详细步骤
OpenClaw 基础配置怎么设置:改模型、换Key、调权限,让你的“龙虾“真正变得听话

上期我们把OpenClaw装好了,但它现在还是安装向导给你搭建的那一套:DeepSeek的Key和默认的用户名,除了你能跟它聊聊天,好像也没啥特别的。
所以,你肯定也想过——能不能换个更强的模型?能不能在聊天工具上让团队一起用?
那这期就把OpenClaw的配置设置步骤讲清楚,让你的龙虾从“能跑“变成“真好用“。
核心配置文件在哪
所有配置都在一个文件里:
C:\Users\你的用户名\.openclaw\config.yaml
打开界面是这样的:
|
# OpenClaw v2026.6.x 配置文件 providers: deepseek: apiKey: “sk-xxxxxxxxxxxxxxxxxxxxxxxxx” model: “deepseek-chat” session: token: “你设置的用户名” feishu: appId: “cli_xxxxxxxxxxxxx” appSecret: “xxxxxxxxxxxxxxxxxxxxxxxxxxxx” |
三个关键:providers(AI模型)、session(用户/安全)、channels(通信渠道)
改模型:把 DeepSeek 换成别的模型
或者你觉得一个模型不够用?那就多添加几个。
最简单的方法:换掉model名字
|
providers: qwen: apiKey: “sk-你的通义千问Key” model: “qwen-plus” |
怎么设置同时挂好几个模型:
|
providers: deepseek: apiKey: “sk-deepseek-key” model: “deepseek-chat” openai: apiKey: “sk-openai-key” model: “gpt-4o” qwen: apiKey: “sk-qwen-key” model: “qwen-max” |
把你想用的模型配置好后,Web聊天界面里会有个下拉框,想用哪个模型就选哪个。
常用模型对照参考:
|
厂商 |
配置名 |
推荐模型 |
去哪拿Key |
|
DeepSeek |
deepseek |
|
deepseek.com |
|
通义千问 |
qwen |
qwen-plus / qwen-max |
阿里云百炼 |
|
OpenAI |
openai |
gpt-4o / gpt-4o-mini |
platform.openai.com |
|
智谱清言 |
glm |
glm-4-plus |
zhipuai.cn |
|
零一万物 |
yi |
yi-lightning |
yi-api.01.ai |
小技巧:主力模型+便宜备用模型搭配着用。复杂的任务让主力上,日常聊天走便宜的,可以省不少钱。
换API Key:
直接把Key写在config.yaml里当然快。但电脑要借人用,或者备份文件传到云上,Key就相当于白给别人用了。
推荐:用环境变量
|
providers: deepseek: apiKey: “${DEEPSEEK_API_KEY}” model: “deepseek-chat” |
然后去系统环境变量里设一个(控制面板→系统→高级系统设置→环境变量→新建):
-
变量名:DEEPSEEK_API_KEY
-
变量值:你的Key
想换Key的时候,改环境变量,重启Gateway就行,配置文件本身不需要变动。
怕麻烦就直接改yaml。找到对应的provider,替换掉apiKey那行的值,保存后重启Gateway。
配置飞书:
飞书是OpenClaw最常用的入口。配置段是这样的:
|
feishu: appId: “cli_xxxxxxxxxxxxx” appSecret: “xxxxxxxxxxxxxxxxxxx” |
appId和appSecret去哪获取:
1. 打开飞书开发者后台:https://open.feishu.cn/app
2. 找到上期创建的应用(”龙虾”)
3. 左侧→凭证与基础信息 → App ID和App Secret,复制过来
然后去左侧”权限管理”看看,至少这几个权限要开通:
-
获取用户信息(AI得知道谁在跟它说话)
-
发消息(不然AI回复不了你)
-
读写云文档、日历、多维表格(按需开通)
不想一个个找:权限管理里直接搜”全部”,全勾上——反正自建应用只有你自己用,没风险。
改完配置怎么让它生效
改完config.yaml后,重启Gateway就行:
openclaw gateway restart
或者关掉原来的窗口,重开:
openclaw gateway –port 18789
然后打开仪表盘:
openclaw dashboard
聊天框里问一句“你现在用的是哪个模型?“——回答的是新配置的模型,就成了。
改完出现问题解决办法
-
配置改了没反应?
大概率是yaml格式不对——缩进错了。用VS Code或Notepad++打开config.yaml,颜色高亮标出来的语法错误一眼就能看到。
-
报“401 Unauthorized”?
Key不对或过期了。去对应平台的开发者后台重新生成一个换上。
-
飞书机器人没反应?
第一,飞书开发者后台→事件与回调→回调地址配了没?第二,权限管理里该开的权限开了没?如果OpenClaw跑在本地电脑上,还需要内网穿透——下期专门讲这个。
速查表:
|
想干嘛 |
改哪 |
改完怎么做 |
|
换模型 |
providers.模型名.model |
重启Gateway |
|
换Key |
providers.模型名.apiKey |
重启Gateway |
|
加用户 |
session.tokens |
重启Gateway |
|
手机/别人访问 |
gateway.host改成0.0.0.0 |
重启Gateway |
|
配置飞书 |
feishu.appId/appSecret |
|
|
多加一个模型 |
加个新provider段 |
|
下期预告:
配置搞定,龙虾能跑能跳了,但飞书机器人还没反应对不对?
第3期:“内网穿透 + 飞书联动“——把你的OpenClaw接上飞书,手机也能随时使唤它。
夜雨聆风