mobile wallpaper 1mobile wallpaper 2mobile wallpaper 3mobile wallpaper 4mobile wallpaper 5mobile wallpaper 6
3430 字
9 分钟
小龙虾openclaw怎么使用
2026-03-02

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#

  1. 访问DeepSeek开放平台:https://platform.deepseek.com/api_keys
  2. 注册账号并登录
  3. 进入“API Keys”页面,点击“创建API Key”
  4. 复制保存生成的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 创建飞书应用#

  1. 访问飞书开发者平台:https://open.feishu.cn/app?lang=zh-CN
  2. 登录后,点击 “创建企业自建应用”
  3. 填写应用信息:
    • 应用名称:如“我的AI助手”
    • 应用描述:随便写
    • 选择图标(可选)
  4. 点击 “创建”

4.2 添加机器人能力#

  1. 进入刚创建的应用管理页面
  2. 左侧导航栏找到 “添加应用能力”
  3. 选择 “机器人”,点击 “添加”

4.3 获取应用凭证#

  1. 左侧导航栏点击 “凭据与基础信息”
  2. 复制 App IDApp Secret,保存到记事本(后面配置要用)

4.4 配置权限和事件#

4.4.1 配置事件回调#

  1. 左侧导航栏点击 “事件与回调”
  2. 订阅方式选择 “长连接”,点击 “保存”
  3. 点击 “添加事件”,勾选 “接收消息”,点击确定

4.4.2 导入权限#

  1. 左侧导航栏点击 “权限管理”
  2. 点击 “批量导入权限”
  3. 粘贴以下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. 左侧导航栏点击 “版本管理与发布”
  2. 点击 “新建版本”
  3. 填写版本号(如1.0.0)和描述
  4. 点击 “保存”“发布”

⚠️ 注意:发布后需等待企业管理员审核(如果是个人账号,自己就是管理员,直接确认即可)。

5. 第三步:部署OpenClaw(二选一)#

方案A:阿里云一键部署(新手推荐)⭐#

这是最简单的方式,全程图形化操作,无需命令行基础。

A1. 购买服务器#

  1. 访问阿里云轻量应用服务器控制台
  2. 点击 “创建实例”
  3. 配置参数:
    • 镜像:选择 “应用镜像”“OpenClaw (Moltbot)”(或“Clawdbot”)
    • 实例规格:2核2GB及以上(内存必须2GB+)
    • 地域:推荐中国香港(免备案,联网搜索功能正常)
    • 时长:按需选择,建议先选1个月测试
  4. 确认订单,完成支付

A2. 配置防火墙端口#

  1. 进入服务器详情页
  2. 找到 “防火墙” 设置
  3. 放行端口:18789(OpenClaw WebUI端口)
  4. 如需SSH远程连接,同时放行22端口

A3. 配置API Key和访问Token#

  1. 在服务器详情页点击 “应用详情”
  2. 找到 “配置百炼API-Key” 区域(如果使用其他模型,后续单独配置)
  3. 点击 “执行命令”,输入DeepSeek API Key(稍后第6步配置)
  4. 找到 “配置OpenClaw” 区域,点击 “执行命令” 生成管理员Token
  5. 复制保存生成的Token
  6. 点击 “打开网站页面” 访问OpenClaw WebUI(地址:http://公网IP:18789

部署完成:至此,OpenClaw已在云端运行,你可以通过WebUI进行对话测试。

方案B:本地电脑部署#

适合喜欢折腾、数据完全自控的用户。

B1. 安装Node.js 22+#

MacOS

brew install node@22
echo 'export PATH="/usr/local/opt/node@22/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Windows 11(管理员PowerShell):

Terminal window
winget install OpenJS.NodeJS.LTS --version 22.2.0 -y

Linux (Ubuntu/Debian)

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

验证安装:

node -v # 应显示 v22.x.x

B2. 一键安装OpenClaw#

MacOS/Linux

curl -fsSL https://openclaw.ai/install.sh | bash

Windows 11(管理员PowerShell):

Terminal window
Set-ExecutionPolicy Bypass -Scope Process -Force
iwr -useb https://openclaw.ai/install.ps1 | iex

B3. 初始化配置#

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-chat

6.2 验证模型配置#

# 查看当前模型配置
openclaw config get models
# 测试对话(通过终端)
openclaw tui

在TUI界面输入“你好”,如收到回复则配置成功。

6.3 配置备用模型(可选)#

为了提升稳定性,可以添加备用模型:

# 添加阿里云千问作为备用(需要先配置)
openclaw models fallbacks add bailian/qwen3-max
# 或添加其他DeepSeek模型
openclaw models fallbacks add deepseek/deepseek-reasoner

7. 第五步:接入飞书机器人#

7.1 安装飞书插件#

openclaw plugins install @m1heng-clawd/feishu

7.2 添加飞书Channel#

openclaw channels add

交互式配置:

  1. 选择 Yes(确认添加)
  2. 选择 飞书(从列表中选择)
  3. 输入 App ID(第4步保存的)
  4. 输入 App Secret(第4步保存的)
  5. 选择 国内飞书
  6. 是否在群内响应:选择 No(新手先选不响应群消息)

7.3 启动网关#

openclaw gateway --port 18789 --verbose

看到类似输出表示网关启动成功:

Gateway listening on http://127.0.0.1:18789

💡 提示:保持终端窗口运行,或在后台启动:

openclaw gateway start

7.4 验证飞书接入#

  1. 打开飞书App
  2. 进入 工作台,找到你创建的应用(如“我的AI助手”)
  3. 发送消息测试

如果收到回复,恭喜!你的OpenClaw已经可以通过飞书对话了。

8. 第六步:验证与测试#

8.1 基础对话测试#

在飞书机器人对话框发送:

你好,请介绍一下自己

预期回复:包含OpenClaw身份信息和能力说明。

8.2 功能测试#

帮我计算 12345 * 67890 等于多少
今天北京天气怎么样

8.3 查看运行状态#

# 查看整体状态
openclaw status --all
# 查看网关日志
openclaw logs gateway
# 查看模型调用情况
openclaw logs --metrics

9. 进阶玩法一:多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 onboard
openclaw --profile main gateway --port 18789
# 创建救援机器人实例(隔离配置)
openclaw --profile rescue onboard
openclaw --profile rescue gateway --port 19001

10.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 19001

10.5 验证多实例状态#

# 查看主机器人状态
openclaw --profile main status
# 查看救援机器人状态
openclaw --profile rescue status
# 查看救援机器人的浏览器控制状态
openclaw --profile rescue browser status

11. 常用命令速查#

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: 飞书机器人没有响应?#

检查清单

  1. 网关是否启动?执行 openclaw gateway status
  2. 飞书应用是否已发布?检查版本管理与发布状态
  3. 权限是否导入完整?检查权限管理中的权限列表
  4. 长连接是否配置正确?事件与回调中检查“长连接”状态

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在执行任务时会有大量的内部修正和上下文循环。

省钱技巧

  1. 使用DeepSeek等低价模型作为主力
  2. 配置备用模型链,简单任务用低价模型
  3. 在阿里云百炼购买Coding Plan包月套餐(7.9元/月起)
  4. 设置每日消费上限(在大模型控制台配置)

Q4: 联网搜索功能受限?#

如果服务器在中国内地(除香港),联网搜索功能可能受限。

解决方案

  • 选择中国香港地域的服务器
  • 或使用海外服务器(如美国弗吉尼亚)

Q5: 如何让Agent记住上下文?#

在初始化时选择启用 Memory Hook:

# 确认Memory已启用
openclaw config get hooks.memory.enabled
# 如未启用,手动开启
openclaw config set hooks.memory.enabled true

Q6: 多实例运行时报端口冲突?#

确保每个实例使用不同的端口,且端口间距至少20(因为派生端口会自动占用基础端口+2、+4等):

# 主实例:端口18789
openclaw gateway --port 18789
# 救援实例:端口19001(相差112 > 20)
openclaw --profile rescue gateway --port 19001

13. 写在最后#

恭喜你完成了OpenClaw从零到一的完整学习!现在你可以:

  • ✅ 通过飞书随时随地与AI助手对话
  • ✅ 使用国产DeepSeek模型,成本可控
  • ✅ 配置多Agent分工,处理复杂任务
  • ✅ 运行多实例,保障服务稳定性

下一步可以探索的方向#

  • 安装社区Skills(如浏览器自动化、邮件管理)
  • 配置RAG知识库,让AI学习你的私有文档
  • 接入更多平台(如企业微信、Discord、Telegram)
  • 开发自己的自定义Skill

资源链接#


遇到问题?欢迎在社区搜索或提问,“养虾人”们都很热心!🦞

分享

如果这篇文章对你有帮助,欢迎分享给更多人!

小龙虾openclaw怎么使用
https://30790842.xyz/posts/小龙虾openclaw怎么使用/
作者
岚崒
发布于
2026-03-02
许可协议
CC BY-NC-SA 4.0

目录