乐于分享
好东西不私藏

OpenClaw入门(一):看懂配置文件,用AI配置AI

OpenClaw入门(一):看懂配置文件,用AI配置AI
各位朋友,你们是不是有这样的疑惑,我安装完了openclaw,到底有什么用?
我是在树莓派开发板上安装了openclaw,自然而然的就想到了,用龙虾控制家里的智能设备,以前可能需要自己去github找语音配置之类的,现在只需要一句话,它就能自己配置好。回到刚才的话题,openclaow有什么应用,干什么活。有这个疑问是因为我们现在好多人,都已经会用AI了。会用豆包,会用元宝,也会用Claude。知道怎么提问,怎么让它写东西、改东西、分析东西。可一碰到 OpenClaw,就突然迷茫了。倒不是它有多难,而是它跟那种点开聊天框就能用的AI,完全不是一类东西。很多人第一次见 OpenClaw,都会觉得又熟悉又陌生。看着像AI,但又不只是个聊天框。感觉它的本事更大,可也更复杂。你知道它能做不少事,但就是不知道第一步该点哪儿。

OpenClaw 不是另一个聊天软件,更像一个你能自己安排、让它干活的小环境。这句话你先搞懂,后面用起来就顺多了。很多人一开始都以为,OpenClaw 就是个更高级的豆包而已。其实不是这样的。说得更明白点:豆包就是你随时问,它随时答,主打一个即时对话。但OpenClaw不一样,你可以给它定规矩、分专门的工作区,装各种小技能、连不同的使用渠道,让它记住你常用的信息,一直帮你跑着干活。简单说,豆包、元宝的核心就是:你问,它答。OpenClaw的核心是:你定好规矩和能力,它按你说的,一直持续工作。所以用OpenClaw,不是打开就聊。它真正的用法,就这几步:

1.先装好用的环境,再启动 OpenClaw。

2.建一个专属工作区,在里面定好规矩、存好记忆、装好用的技能。

3.最后通过聊天或者控制界面用它就行。

举个例子你就懂了:豆包就像现成的家用设备,插上电就能用。OpenClaw更像你自己布线的智能家居,虽然麻烦一点,但能完全按你的需求来,长期帮你干活。

这时候你就需要那个openclaw.json配置文件了。这东西,基本上所有用龙虾的人都躲不开,就算你现在不碰,早晚也得遇上。我先会分享配置文件里的内容,下次再举例如何用。有的大佬可能会说,把你的配置文件发一下,我们抄一下不就完了?其实这是个误区。我自己的配置里,很多设置都是按环境来的。比如多任务怎么分、插件怎么开、用什么方式连接,都跟你不一样。每个人用法不同,龙虾的设置也不一样。直接照搬根本用不了,搞不好还会直接报错,用起来更麻烦。

一、openclaw.json配置文件是什么

openclaw.json是openclaw龙虾的说明书,也可以理解成一个火锅店的运营手册,里面写着:

厨房在哪儿(工作区配置)

用什么食材做菜(使用什么AI模型)

接待哪些客人(用什么渠道,飞书,QQ,微信,TG)

服务员怎么跟人打交道(智能体配置)

出问题了该怎么解决(错误处理配置)

运营手册清楚了,火锅店才能正常营业。

它在你的电脑哪?

Windows系统路径:C:\Users\ 你的用户名\.openclaw\openclaw.json

Mac/Linux 路径:~/.openclaw/openclaw.json

你想自己找文件夹的话,手动翻就行,也可以直接用系统搜索。或者在命令行里直接打开文件:

Mac 终端:open ~/.openclaw/openclaw.json

Windows PowerShell:code ~/.openclaw/openclaw.json

Linux 终端:nano ~/.openclaw/openclaw.json

二、openclaw.json核心配置选项

openclaw.json 里的关键设置主要就这几块:工作区、接入方式、用哪个模型、对话记录、工具插件、消息推送,还有定时任务。

1.工作区

工作区配置,是所有配置里最关键的一项。在这里可以指定它的工作路径、用什么模型、多久刷新一次。主Agent跟子Agen的怎么分工,也全在这里设置。

工作区配置的关键字段明细表如下:

字段
说明
推荐值
workspace
工作区存放路径
~/.openclaw/workspace
model.primary
主要使用的模型
按你实际用的模型填写
model.fallbacks
备用模型列表
至少配一个

如果想配多个agent,直接在列表里多定义几个就行。每个都有自己独立的工作区。下面这段配置,你可以看一下:

{  "agents": {    "list": [      {        "id": "ceo",        "name": "创始人CEO",        "workspace": "~/.openclaw/workspace-ceo",        "identity": {          "name": "CEO",          "emoji": "👑"        }      },      {        "id": "product-lead",        "name": "产品负责人",        "workspace": "~/.openclaw/workspace-product-lead",        "identity": {          "name": "产品负责人",          "emoji": "🎯"        },        "squad": "product"      },      {        "id": "user-researcher",        "name": "用户研究员",        "workspace": "~/.openclaw/workspace-user-researcher",        "identity": {          "name": "用户研究员",          "emoji": "🔍"        },        "squad": "product"      },      {        "id": "fullstack-dev",        "name": "全栈工程师",        "workspace": "~/.openclaw/workspace-fullstack-dev",        "identity": {          "name": "全栈工程师",          "emoji": "💻"        },        "squad": "product"      }

看上面的配置就能发现,agents 列表里有两个帮手:一个 id 是 main,一个 id 是 coding,它们对应的工作区文件夹,是分开的、不一样的。

2.渠道配置

渠道设置就很好懂了,就是设置你的小龙虾能在哪儿跟人聊天。比如 QQ、飞书、钉钉、微信 Clawbot 这些。同时也设置谁能跟它说话,也就是私信权限。下面是可以参考的配置内容

重点需要说明的是dmPolicy字段,它的不同值,代表不一样的设置,以及安全性,具体对照如下表:

取值
说明
安全性
pairing
需要配对码
最高
allowlist
仅允许白名单用户
高
open
任何人都可使用
低
disabled
禁用私信功能
最高

3.模型配置

模型设置就是告诉小龙虾,用哪个 “脑子” 来思考、帮你干活。不同任务,也可以切换成不同的脑子。

字段
说明
mode
merge 表示合并配置,override 表示覆盖
providers
模型提供商列表
baseUrl
API 地址
apiKey
API 密钥(建议用环境变量)
api
API 类型(如 openai-completions、anthropic-messages 等)

4.工具配置

工具配置同样是比较简单的,这里的配置是控制你的小龙虾能不能使用工具,以及能使用什么工具。仅供参考的配置文件内容如下:

我们重点来看 profile 这个预设项。不少用 3.8 版本龙虾的朋友,这个字段默认没改成 full,也就没放开所有工具权限。

结果就会出现一个问题:你让它写篇文章存成 Word,它只动口回答,却不动手操作,甚至直接说用不了工具。

下面是 profile 字段各个值的含义说明:

预设
包含工具
适用场景
minimal
仅状态查询
监控型助手
coding
文件、命令、会话、记忆
编程助手
messaging
消息、会话管理
客服助手
full
全部工具
主助手

5.会话管理

会话管理,说白了就是控制聊天记录怎么隔离、怎么重置。现在龙虾默认的规则是:每天凌晨 4 点后,聊天记录会重置;或者超过 2 小时不说话,也会自动重置。重置之后,你再跟它聊天,它就忘了之前聊的内容,相当于重新开了个新聊天。所以重点来了:当天跟它聊的内容,必须存成每日记忆文件,或者记到长期记忆里。不然你会发现,今天聊的事儿,明天它就全忘了。你还得再重复说一遍背景,等于白忙活

这里还是重点看dmScope字段对应配置的值,如下表:

值
说明
适用场景
main
所有用户共用一个会话
个人使用
per-peer
每个用户独立会话
推荐使用
per-channel-peer
每个渠道 + 用户独立
多渠道使用
per-account-channel-peer
最细粒度隔离
多账号使用

6.Webhooks 配置

Webhooks 配置其实就是用来收外部消息的。比如龙虾处理完GitHub上的Issue,或者有邮件进来了,这些消息都能通过它推过来。

下面是可以参考的配置内容:

7.定时任务

定时任务就很好理解了。你设置过的定时任务,这里都会有对应的配置。比如每天早上自动发财经新闻、晚上帮你整理日报之类。

不过要注意:openclaw.json 里的定时配置不是唯一的。定时任务也可能单独存在 .openclaw\cron 目录下的 jobs.json 文件里

上面这些,就是 openclaw.json 里最常见的核心设置。除此之外,网关配置、还有你装上的各种技能和插件,相关设置也都会写在这个配置文件里。

三、openclaw.json的最佳修改方式:AI配置AI

平时我们难免要手动改 openclaw.json 这个配置文件。熟悉操作的老玩家,直接用编辑器打开改一改就行。

如果你是刚上手的新手,改法就很多了:可以直接打开文件改,也可以在龙虾的网页界面改,还能在命令行里用命令改。

但我建议使用AI编程的IDE软件来修改,让AI配置AIClaude Code 入门,新手零门槛教程,我这里使用VSCode+Claude Code插件来配置。

在软件界面里选择打开 openclaw.json,右边会出现对话框,直接跟 AI 说你的需求,让它帮你改就行,记住一定要提前备份openclaw.json文件,可以使用日期来备份。你可以让Claude备份,也可以自己手动备份。

这款 AI 编程 IDE 最大的好处是有图形界面,普通人用着很顺手。再加上自带 AI 能力,改个 json 文件特别轻松。你只要用大白话说清楚想改什么就行。比如要创建多agent工作区,就把要求输进去,再让它帮你改。等一会儿,AI 就自动帮你改完了。

案例:创建多agent工作区背景:部署 OpenClaw 最小配置(3个Agent)Prompt:我要部署 OpenClaw 最小配置(3个Agent)。请帮我:检查当前 agents.list 配置创建 3 个工作区目录:cos, cto, builder为每个工作区复制 SOUL.md、AGENTS.md 等基础文件更新 openclaw.json 中的 agents.list验证配置并重启网关服务器信息:系统:$(uname -a)Node 版本:$(node -v)当前路径:$(pwd)根据我的实际环境调整路径配置。

整个工作流程如下:

好了,就分享到这里,下一期我将以一个案例来创建你自己的助手。希望对大家有所帮助,有问题可以和我在评论区讨论~

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料