OpenClaw怎么入门?我花3天研究的完整教程
大家好,我是阿庆。
最近在折腾OpenClaw(小龙虾),前后花了3天时间,总算把多Agent配置搞定了。今天把踩过的坑和完整流程整理出来,希望能帮新手少走弯路。
什么是OpenClaw?
OpenClaw是一个开源的AI助手框架,可以对接飞书、Discord、Telegram等多个平台。它最牛的地方在于支持多Agent配置,每个Agent有独立的workspace和记忆,互相隔离,互不干扰。
简单理解:你可以同时运行多个小助手,每个小助手负责不同的事情。比如一个帮你写博客,一个帮你处理客服,一个帮你管理日程。
选哪个云服务器?腾讯云还是阿里云?
这是我踩的第一个坑。
最开始我用的是阿里云服务器,因为之前还剩几个月时长。结果部署基础版OpenClaw还算顺利,但一到多Agent配置,就各种报错。
后来才发现,腾讯云对OpenClaw的支持更友好,社区里也有不少现成的教程,对新手更友好。
我的建议:如果你是新手,直接选腾讯云。控制面板更简洁,操作逻辑更直观。阿里云更适合有经验的老用户。
开始部署:第一步创建飞书应用
不管你用腾讯云还是阿里云,第一步都是创建飞书应用。
- 打开 飞书开放平台
- 创建新应用,拿到App ID和App Secret
- 这两个凭证后面配置会用到,建议先复制保存好
第二步:服务器配置
登录你的云服务器,先备份配置文件:
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup.$(date +%Y%m%d_%H%M%S)
这步很重要!后续如果配置出问题,可以直接恢复。
第三步:创建新Agent
使用命令添加新的Agent:
openclaw agents add --workspace /root/.openclaw/workspace-blog blog
注意:
- 腾讯云的路径是 /root/.openclaw/…
- 阿里云的路径是 /home/admin/root/.openclaw/…
创建成功后,可以用 openclaw agents list 查看。
第四步:绑定飞书应用
修改 openclaw.json 配置文件,这里有3个关键点:
1. 配置agents列表
"agents": { "list": [ { "id": "main" }, { "id": "blog", "name": "blog", "workspace": "/root/.openclaw/agents/blog", "agentDir": "/root/.openclaw/agents/blog/agent", "identity": { "name": "网站运营", "emoji": "🏃" } } ] }
2. 配置bindings路由
"bindings": [ { "agentId": "main", "match": { "channel": "feishu", "accountId": "default" } }, { "agentId": "blog", "match": { "channel": "feishu", "accountId": "blog" } } ]
3. 配置飞书账号
"channels": { "feishu": { "accounts": { "default": { "appId": "cli_原来的", "appSecret": "原来的secret", "enabled": true }, "blog": { "appId": "cli_新的", "appSecret": "新的secret", "enabled": true } } } }
修改完成后,重启Gateway:
openclaw gateway restart
等一分钟,让配置生效。
第五步:完善飞书应用权限
回到飞书开放平台,给应用添加权限:
- im:message – 消息相关权限
- docx:document – 文档读写
- wiki:wiki – 知识库权限
- drive:drive – 云盘权限
- bitable:app – 多维表格权限
然后配置好回调地址( Events Callback URL),验证通过后,创建版本发布。
第六步:激活机器人
在飞书搜索你的应用名称,点击进入对话框,发送你好。
系统会返回一个验证码,把这个验证码填入OpenClaw的验证窗口,就绑定成功了。
再次发送你好,如果正常回复,说明配置完成!
总结一下
整个流程下来,其实不算复杂:
- 创建飞书应用
- 服务器安装OpenClaw
- 创建新Agent
- 修改配置文件
- 绑定飞书应用
- 配置权限并发布
最重要的建议:先用一个Agent跑通全流程,再考虑多Agent扩展。不要像我一样一开始就想搞大新闻,结果踩坑踩了好几天。
如果部署过程中遇到问题,可以加我微信:aqing9113,一起交流。
祝部署顺利!