乐于分享
好东西不私藏

手把手:OpenClaw 基础配置设置的详细步骤

手把手:OpenClaw 基础配置设置的详细步骤

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

上期我们把OpenClaw装好了,但它现在还是安装向导给你搭建的那一套:DeepSeekKey和默认的用户名,除了你能跟它聊聊天,好像也没啥特别的。

所以,你肯定也想过——能不能换个更强的模型?能不能在聊天工具上让团队一起用?

那这期就把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”

三个关键:providersAI模型)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-chat

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 CodeNotepad++打开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

    重启Gateway

    多加一个模型

    加个新provider

    重启Gateway

    下期预告:

    配置搞定,龙虾能跑能跳了,但飞书机器人还没反应对不对?

    3期:内网穿透 + 飞书联动——把你的OpenClaw接上飞书,手机也能随时使唤它。