OpenClaw 新手完全攻略:DeepSeek + 飞书 + 多Agent实战
这是一份真正“喂饭级”的OpenClaw教程。从零开始,手把手教你用国产DeepSeek模型搭建个人AI助手,接入飞书实现移动端对话,还能进阶玩转多Agent协同与多实例部署。
1. 什么是OpenClaw?
OpenClaw(曾用名:Clawdbot、Moltbot)是一款开源的、本地优先的AI智能体框架。简单来说,它是一个“能干活的AI”——不只是聊天,还能帮你执行任务、调用工具、自动化工作流。
截至2026年3月,OpenClaw已成为GitHub上星标数第一的软件项目,拥有超过27.8万星标和1.3万多个社区技能。
为什么选择DeepSeek + 飞书?
| 组合 | 优势 |
|---|---|
| DeepSeek模型 | 国产大模型,价格极低(输入$0.14/百万tokens),中文能力强,API国内访问稳定 |
| 飞书接入 | 国内使用流畅,机器人配置简单,支持个人和群聊场景 |
| OpenClaw框架 | 开源免费,本地数据可控,支持多Agent协同,Skills生态丰富 |
2. 准备工作:五分钟搞定前置条件
在开始部署前,请确认以下事项:
2.1 必备清单
| 项目 | 说明 | 费用 |
|---|---|---|
| 一台电脑/服务器 | 推荐2核2GB以上配置 | 本地电脑免费;云服务器约9.9元/月起 |
| 飞书账号 | 个人免费账号即可 | 免费 |
| DeepSeek API Key | 用于调用大模型 | 新用户送500万tokens,日常使用极低 |
| Node.js 22+ | OpenClaw运行环境(本地部署需安装) | 免费 |
2.2 如果你选择云端部署(推荐新手)
推荐阿里云轻量应用服务器,OpenClaw应用镜像一键部署,无需手动配置环境:
- 配置:2核2GB内存 + 40GB系统盘
- 费用:约9.9元/月起
- 地域:建议选择中国香港(免备案,联网搜索功能正常)
💡 省钱提示:阿里云百炼Coding Plan提供按次计费的包月套餐,每天两场抢购活动,价格低至7.9元/月。
3. 第一步:获取DeepSeek API Key
DeepSeek是深度求索公司推出的国产大模型,性价比极高,中文能力优秀。
3.1 注册并获取API Key
- 访问DeepSeek开放平台:https://platform.deepseek.com/api_keys
- 注册账号并登录
- 进入“API Keys”页面,点击“创建API Key”
- 复制保存生成的API Key(格式类似:
sk-xxxxxxxxxxxxxxxx)
3.2 验证API可用性(可选)
curl -X POST https://api.deepseek.com/v1/chat/completions \ -H "Authorization: Bearer 你的API-Key" \ -H "Content-Type: application/json" \ -d '{ "model": "deepseek-chat", "messages": [{"role": "user", "content": "你好"}] }'如返回包含choices的JSON响应,说明API可用。
4. 第二步:创建飞书机器人应用
飞书机器人是OpenClaw的“嘴巴”和“耳朵”——用户通过飞书发消息,机器人转发给OpenClaw,OpenClaw处理后返回结果。
4.1 创建飞书应用
- 访问飞书开发者平台:https://open.feishu.cn/app?lang=zh-CN
- 登录后,点击 “创建企业自建应用”
- 填写应用信息:
- 应用名称:如“我的AI助手”
- 应用描述:随便写
- 选择图标(可选)
- 点击 “创建”
4.2 添加机器人能力
- 进入刚创建的应用管理页面
- 左侧导航栏找到 “添加应用能力”
- 选择 “机器人”,点击 “添加”
4.3 获取应用凭证
- 左侧导航栏点击 “凭据与基础信息”
- 复制 App ID 和 App Secret,保存到记事本(后面配置要用)
4.4 配置权限和事件
4.4.1 配置事件回调
- 左侧导航栏点击 “事件与回调”
- 订阅方式选择 “长连接”,点击 “保存”
- 点击 “添加事件”,勾选 “接收消息”,点击确定
4.4.2 导入权限
- 左侧导航栏点击 “权限管理”
- 点击 “批量导入权限”
- 粘贴以下JSON并导入:
{ "scopes": { "tenant": [ "contact:user.base:readonly", "im:chat", "im:chat:read", "im:chat:update", "im:message", "im:message.group_at_msg:readonly", "im:message.p2p_msg:readonly", "im:message:send_as_bot", "im:resource" ] }}4.4.3 发布应用
- 左侧导航栏点击 “版本管理与发布”
- 点击 “新建版本”
- 填写版本号(如
1.0.0)和描述 - 点击 “保存” → “发布”
⚠️ 注意:发布后需等待企业管理员审核(如果是个人账号,自己就是管理员,直接确认即可)。
5. 第三步:部署OpenClaw(二选一)
方案A:阿里云一键部署(新手推荐)⭐
这是最简单的方式,全程图形化操作,无需命令行基础。
A1. 购买服务器
- 访问阿里云轻量应用服务器控制台
- 点击 “创建实例”
- 配置参数:
- 镜像:选择 “应用镜像” → “OpenClaw (Moltbot)”(或“Clawdbot”)
- 实例规格:2核2GB及以上(内存必须2GB+)
- 地域:推荐中国香港(免备案,联网搜索功能正常)
- 时长:按需选择,建议先选1个月测试
- 确认订单,完成支付
A2. 配置防火墙端口
- 进入服务器详情页
- 找到 “防火墙” 设置
- 放行端口:18789(OpenClaw WebUI端口)
- 如需SSH远程连接,同时放行22端口
A3. 配置API Key和访问Token
- 在服务器详情页点击 “应用详情”
- 找到 “配置百炼API-Key” 区域(如果使用其他模型,后续单独配置)
- 点击 “执行命令”,输入DeepSeek API Key(稍后第6步配置)
- 找到 “配置OpenClaw” 区域,点击 “执行命令” 生成管理员Token
- 复制保存生成的Token
- 点击 “打开网站页面” 访问OpenClaw WebUI(地址:
http://公网IP:18789)
✅ 部署完成:至此,OpenClaw已在云端运行,你可以通过WebUI进行对话测试。
方案B:本地电脑部署
适合喜欢折腾、数据完全自控的用户。
B1. 安装Node.js 22+
MacOS:
brew install node@22echo 'export PATH="/usr/local/opt/node@22/bin:$PATH"' >> ~/.zshrcsource ~/.zshrcWindows 11(管理员PowerShell):
winget install OpenJS.NodeJS.LTS --version 22.2.0 -yLinux (Ubuntu/Debian):
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -sudo apt install -y nodejs验证安装:
node -v # 应显示 v22.x.xB2. 一键安装OpenClaw
MacOS/Linux:
curl -fsSL https://openclaw.ai/install.sh | bashWindows 11(管理员PowerShell):
Set-ExecutionPolicy Bypass -Scope Process -Forceiwr -useb https://openclaw.ai/install.ps1 | iexB3. 初始化配置
openclaw onboard按提示操作:
- 接受风险提示:输入
Yes - 配置模式:选择
QuickStart(快速入门) - 模型配置:暂时 跳过(后续单独配置DeepSeek)
- 聊天软件:暂时 跳过(后续单独配置飞书)
- 技能包:选择
No(新手先不用装) - Hooks:选择
Memory(启用记忆功能)
6. 第四步:配置DeepSeek模型
无论选择云端部署还是本地部署,配置模型的步骤相同。
6.1 通过命令行配置DeepSeek
# 1. 添加DeepSeek提供商配置openclaw config set 'models.providers.deepseek' --json '{ "baseUrl": "https://api.deepseek.com/v1", "apiKey": "你的DeepSeek-API-Key", "api": "openai-completions", "models": [ { "id": "deepseek-chat", "name": "DeepSeek Chat" }, { "id": "deepseek-reasoner", "name": "DeepSeek Reasoner" } ]}'
# 2. 设置合并模式openclaw config set models.mode merge
# 3. 设置默认模型openclaw models set deepseek/deepseek-chat6.2 验证模型配置
# 查看当前模型配置openclaw config get models
# 测试对话(通过终端)openclaw tui在TUI界面输入“你好”,如收到回复则配置成功。
6.3 配置备用模型(可选)
为了提升稳定性,可以添加备用模型:
# 添加阿里云千问作为备用(需要先配置)openclaw models fallbacks add bailian/qwen3-max
# 或添加其他DeepSeek模型openclaw models fallbacks add deepseek/deepseek-reasoner7. 第五步:接入飞书机器人
7.1 安装飞书插件
openclaw plugins install @m1heng-clawd/feishu7.2 添加飞书Channel
openclaw channels add交互式配置:
- 选择
Yes(确认添加) - 选择
飞书(从列表中选择) - 输入 App ID(第4步保存的)
- 输入 App Secret(第4步保存的)
- 选择
国内飞书 - 是否在群内响应:选择
No(新手先选不响应群消息)
7.3 启动网关
openclaw gateway --port 18789 --verbose看到类似输出表示网关启动成功:
Gateway listening on http://127.0.0.1:18789💡 提示:保持终端窗口运行,或在后台启动:
openclaw gateway start
7.4 验证飞书接入
- 打开飞书App
- 进入 工作台,找到你创建的应用(如“我的AI助手”)
- 发送消息测试
如果收到回复,恭喜!你的OpenClaw已经可以通过飞书对话了。
8. 第六步:验证与测试
8.1 基础对话测试
在飞书机器人对话框发送:
你好,请介绍一下自己预期回复:包含OpenClaw身份信息和能力说明。
8.2 功能测试
帮我计算 12345 * 67890 等于多少今天北京天气怎么样8.3 查看运行状态
# 查看整体状态openclaw status --all
# 查看网关日志openclaw logs gateway
# 查看模型调用情况openclaw logs --metrics9. 进阶玩法一:多Agent协同
当你的OpenClaw需要处理多种类型的任务时,可以配置多个Agent分工协作。
9.1 理解两种Agent模式
| 模式 | 特点 | 适用场景 |
|---|---|---|
| 持久Agent | 独立存在,有专属配置和记忆,永久运行 | 长期分工任务(如资讯收集、内容写作) |
| 子Agent | 临时派生,任务完成后自动销毁 | 一次性任务(如数据处理、代码调试) |
9.2 创建持久Agent(以“研究员”为例)
编辑配置文件 ~/.openclaw/openclaw.json,添加:
{ "agents": { "researcher": { "model": "deepseek/deepseek-chat", "workspace": "/home/user/openclaw-workspaces/researcher", "prompt": "你是一个专业的研究员,擅长搜集和整理信息。回答要准确、有条理。", "skills": ["web-search", "data-extract"] }, "writer": { "model": "deepseek/deepseek-chat", "workspace": "/home/user/openclaw-workspaces/writer", "prompt": "你是一个专业的作家,擅长撰写文章和报告。文笔流畅,结构清晰。", "skills": ["doc-generator"] } }}9.3 配置路由规则
让不同意图的消息自动分发给对应的Agent:
{ "routing": { "rules": [ { "intent": "research|搜索|查资料", "agent": "researcher" }, { "intent": "write|写|生成报告", "agent": "writer" } ] }}9.4 Agent间通信(四大工具)
OpenClaw提供四种工具让Agent之间协同工作:
| 工具 | 用途 | 示例 |
|---|---|---|
sessions_send | 向指定Agent发消息 | 研究员将资料发给作家 |
sessions_spawn | 创建临时子Agent | 主Agent拆分复杂任务 |
file_share | 跨Agent共享文件 | 传输CSV、PDF文件 |
context_inherit | 继承上下文 | 子Agent基于历史继续工作 |
9.5 实战示例:研究员→作家协同
场景:用户说“帮我研究一下人工智能发展趋势,然后写一份简报”
# 研究员Agent搜集资料(自动路由)# 完成后通过sessions_send将资料发送给作家
# 作家Agent收到资料后生成简报无需手动干预,多Agent自动完成分工。
10. 进阶玩法二:多实例部署(救援机器人)
当你需要更强的隔离或冗余时(比如主机器人宕机时的备用方案),可以在同一台机器上运行多个OpenClaw实例。
10.1 为什么需要多实例?
- 隔离测试:新配置先在救援机器人验证,不影响主服务
- 故障恢复:主机器人异常时,救援机器人可快速接管
- 任务分流:不同类型任务用不同实例处理
10.2 使用Profile隔离配置
OpenClaw通过 --profile 参数实现配置隔离:
# 创建主机器人实例openclaw --profile main onboardopenclaw --profile main gateway --port 18789
# 创建救援机器人实例(隔离配置)openclaw --profile rescue onboardopenclaw --profile rescue gateway --port 1900110.3 隔离检查清单
多实例运行必须确保以下资源隔离:
| 资源 | 环境变量/配置 | 说明 |
|---|---|---|
| 配置文件 | OPENCLAW_CONFIG_PATH | 每个实例独立 |
| 状态目录 | OPENCLAW_STATE_DIR | 会话、凭证隔离 |
| 工作区 | agents.defaults.workspace | 文件操作隔离 |
| 网关端口 | gateway.port | 端口不能冲突 |
10.4 安装救援机器人服务
# 主机器人(默认端口18789)openclaw gateway install
# 救援机器人(端口19001,建议基础端口至少间隔20)openclaw --profile rescue gateway install --port 1900110.5 验证多实例状态
# 查看主机器人状态openclaw --profile main status
# 查看救援机器人状态openclaw --profile rescue status
# 查看救援机器人的浏览器控制状态openclaw --profile rescue browser status11. 常用命令速查
11.1 安装与更新
| 命令 | 说明 |
|---|---|
curl -fsSL https://openclaw.ai/install.sh | bash | 安装最新版 |
openclaw --version | 查看版本 |
npm update -g openclaw | 更新到最新版 |
11.2 配置管理
| 命令 | 说明 |
|---|---|
openclaw config get | 查看全部配置 |
openclaw config set <key> <value> | 设置配置项 |
openclaw models set <provider>/<model> | 设置默认模型 |
openclaw models list | 查看可用模型 |
11.3 网关管理
| 命令 | 说明 |
|---|---|
openclaw gateway start | 启动网关(后台) |
openclaw gateway stop | 停止网关 |
openclaw gateway restart | 重启网关 |
openclaw gateway status | 查看网关状态 |
openclaw gateway --port 18789 --verbose | 前台运行,显示详细日志 |
11.4 Channel与Skill管理
| 命令 | 说明 |
|---|---|
openclaw channels list | 查看已接入的Channel |
openclaw channels add | 添加新Channel |
openclaw plugins install <plugin-name> | 安装插件 |
openclaw skill list | 查看已安装技能 |
11.5 诊断与日志
| 命令 | 说明 |
|---|---|
openclaw doctor | 环境诊断 |
openclaw status --all | 查看全部状态 |
openclaw logs gateway | 查看网关日志 |
openclaw logs --metrics | 查看Token消耗统计 |
12. 常见问题与避坑指南
Q1: 飞书机器人没有响应?
检查清单:
- 网关是否启动?执行
openclaw gateway status - 飞书应用是否已发布?检查版本管理与发布状态
- 权限是否导入完整?检查权限管理中的权限列表
- 长连接是否配置正确?事件与回调中检查“长连接”状态
Q2: 收到 HTTP 403 错误?
可能原因:
- API Key无效或已过期
- 模型服务未开通(DeepSeek需确认账户余额)
- 网络问题导致无法访问API
解决方法:
# 检查API Key配置openclaw config get models.providers.deepseek
# 重新配置openclaw config set models.providers.deepseek.apiKey "新的API-Key"Q3: Token消耗太快怎么办?
OpenClaw是“Token消耗大户”,因为Agent在执行任务时会有大量的内部修正和上下文循环。
省钱技巧:
- 使用DeepSeek等低价模型作为主力
- 配置备用模型链,简单任务用低价模型
- 在阿里云百炼购买Coding Plan包月套餐(7.9元/月起)
- 设置每日消费上限(在大模型控制台配置)
Q4: 联网搜索功能受限?
如果服务器在中国内地(除香港),联网搜索功能可能受限。
解决方案:
- 选择中国香港地域的服务器
- 或使用海外服务器(如美国弗吉尼亚)
Q5: 如何让Agent记住上下文?
在初始化时选择启用 Memory Hook:
# 确认Memory已启用openclaw config get hooks.memory.enabled
# 如未启用,手动开启openclaw config set hooks.memory.enabled trueQ6: 多实例运行时报端口冲突?
确保每个实例使用不同的端口,且端口间距至少20(因为派生端口会自动占用基础端口+2、+4等):
# 主实例:端口18789openclaw gateway --port 18789
# 救援实例:端口19001(相差112 > 20)openclaw --profile rescue gateway --port 1900113. 写在最后
恭喜你完成了OpenClaw从零到一的完整学习!现在你可以:
- ✅ 通过飞书随时随地与AI助手对话
- ✅ 使用国产DeepSeek模型,成本可控
- ✅ 配置多Agent分工,处理复杂任务
- ✅ 运行多实例,保障服务稳定性
下一步可以探索的方向
- 安装社区Skills(如浏览器自动化、邮件管理)
- 配置RAG知识库,让AI学习你的私有文档
- 接入更多平台(如企业微信、Discord、Telegram)
- 开发自己的自定义Skill
资源链接
- 官方文档:https://docs.openclaw.ai
- GitHub仓库:https://github.com/openclaw/openclaw
- ClawHub技能市场:https://clawhub.com
- 阿里云百炼Coding Plan:https://bailian.console.aliyun.com
遇到问题?欢迎在社区搜索或提问,“养虾人”们都很热心!🦞
如果这篇文章对你有帮助,欢迎分享给更多人!









