OpenClaw怎么入门?我花3天研究的完整教程

大家好,我是阿庆。

最近在折腾OpenClaw(小龙虾),前后花了3天时间,总算把多Agent配置搞定了。今天把踩过的坑和完整流程整理出来,希望能帮新手少走弯路。

什么是OpenClaw?

OpenClaw是一个开源的AI助手框架,可以对接飞书、Discord、Telegram等多个平台。它最牛的地方在于支持多Agent配置,每个Agent有独立的workspace和记忆,互相隔离,互不干扰。

简单理解:你可以同时运行多个小助手,每个小助手负责不同的事情。比如一个帮你写博客,一个帮你处理客服,一个帮你管理日程。

选哪个云服务器?腾讯云还是阿里云?

这是我踩的第一个坑。

最开始我用的是阿里云服务器,因为之前还剩几个月时长。结果部署基础版OpenClaw还算顺利,但一到多Agent配置,就各种报错。

后来才发现,腾讯云对OpenClaw的支持更友好,社区里也有不少现成的教程,对新手更友好。

我的建议:如果你是新手,直接选腾讯云。控制面板更简洁,操作逻辑更直观。阿里云更适合有经验的老用户。

开始部署:第一步创建飞书应用

不管你用腾讯云还是阿里云,第一步都是创建飞书应用。

  1. 打开 飞书开放平台
  2. 创建新应用,拿到App IDApp Secret
  3. 这两个凭证后面配置会用到,建议先复制保存好

第二步:服务器配置

登录你的云服务器,先备份配置文件:

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的验证窗口,就绑定成功了。

再次发送你好,如果正常回复,说明配置完成!

总结一下

整个流程下来,其实不算复杂:

  1. 创建飞书应用
  2. 服务器安装OpenClaw
  3. 创建新Agent
  4. 修改配置文件
  5. 绑定飞书应用
  6. 配置权限并发布

最重要的建议:先用一个Agent跑通全流程,再考虑多Agent扩展。不要像我一样一开始就想搞大新闻,结果踩坑踩了好几天。

如果部署过程中遇到问题,可以加我微信:aqing9113,一起交流。

祝部署顺利!

类似文章

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注