OpenClaw(原Clawdbot/Moltbot):开年最火开源桌面Agent 完整部署指南(零门槛 + 飞书/钉钉集成 + 自动化实战)
一、前置准备(零门槛,普通电脑可跑,命令直接复制)
1.1 硬件要求(无最低配置限制,适配所有办公电脑)
- CPU:≥2核(Intel i3/i5、AMD Ryzen 3/5及以上)
- 内存:≥4G(推荐8G,避免多任务卡顿)
- 存储:SSD剩余≥10G(仅存储镜像/配置,无大文件)
- 网络:可正常联网(国内网络即可,已适配国内镜像源)
1.2 软件要求(固定版本,避免兼容问题)
- 操作系统:Windows10+/macOS12+/Linux(Ubuntu22.04最佳,Windows推荐WSL2)
- 核心工具:Docker≥24.0 + Docker Compose≥2.20、Git≥2.40(均提供一键安装命令)
- 可选凭证:大模型API-Key(阿里云百炼/Kimi K2.5,用于增强自然语言能力,本地部署可省略)
- 浏览器:Chrome/Edge最新版(用于访问控制台)
1.3 国内镜像源配置(必做,解决下载失败问题)
# 配置Docker国内镜像源(Windows/macOS/Linux通用,复制到终端执行) mkdir -p /etc/docker cat > /etc/docker/daemon.json << EOF { "registry-mirrors": ["https://docker.mirrors.ustc.edu.cn", "https://hub-mirror.c.163.com"] } EOF systemctl daemon-reload && systemctl restart docker # 配置Git国内镜像(拉取源码加速) git config --global url."https://ghproxy.com/https://github.com/".insteadOf "https://github.com/"二、核心部署方案(两种任选,零门槛一键启动,命令可直接复制)
方案1:Docker一键部署(首选,本地私有化,数据可控,跨系统通用)
步骤1:一键安装Docker+Git(未安装的执行,已安装跳过)
# Windows/macOS/Linux通用一键安装脚本(内置国内源) curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun # 安装Git sudo apt install git -y # Ubuntu/Linux # Windows直接下载:https://git-scm.com/download/win(默认安装即可)步骤2:拉取源码+构建镜像(国内源加速,3分钟完成)
# 1. 克隆OpenClaw中文开源版源码(适配国内环境,无需修改) git clone https://ghproxy.com/https://github.com/OpenClawChinese/OpenClaw.git cd OpenClaw # 2. 构建Docker镜像(命名为openclaw:latest,自动适配系统) docker build -t openclaw:latest . # 3. 创建数据持久化卷(关键,防止配置/任务数据丢失) docker volume create openclaw-data步骤3:初始化配置+启动服务(核心命令,直接复制)
# 1. 初始化默认配置(自动生成参数,无需手动修改) docker run --rm -v openclaw-data:/root/.openclaw openclaw:latest openclaw setup # 2. 配置远程/局域网访问(设置Token防未授权登录,替换自定义密码) docker run --rm -v openclaw-data:/root/.openclaw openclaw:latest openclaw config set gateway.bind lan docker run --rm -v openclaw-data:/root/.openclaw openclaw:latest openclaw config set gateway.auth.token OpenClaw@2026 # 3. 创建docker-compose.yml并启动(后台运行,重启自动恢复) cat > docker-compose.yml << EOF version: '3.8' services: openclaw: image: openclaw:latest container_name: openclaw-local ports: - "18789:18789" # 核心访问端口,固定不变 volumes: - openclaw-data:/root/.openclaw restart: unless-stopped command: openclaw gateway run --allow-unconfigured volumes: openclaw-data: name: openclaw-data EOF # 启动服务(后台运行) docker compose up -d步骤4:验证部署成功(10秒完成)
- 浏览器打开地址:
http://localhost:18789 - 输入步骤3设置的Token(如OpenClaw@2026),点击「连接」
- 进入控制台即部署成功,本地/局域网访问地址:
http://本机IP:18789
方案2:阿里云一键部署(备选,7×24小时稳定运行,无需本地维护)
步骤1:购买OpenClaw专属轻量服务器(免配置,一键部署)
- 打开阿里云专属部署页:https://www.aliyun.com/activity/ecs/clawdbot
- 选择默认配置(2核2G+40G SSD,满足基础使用),地域选「中国香港/美国弗吉尼亚」(免ICP备案)
- 完成支付,等待1-3分钟,实例状态变为「运行中」
步骤2:配置大模型API-Key(阿里云百炼,可选)
- 打开阿里云百炼平台:https://www.aliyun.com/product/bailian,创建并复制API-Key(Access Key ID+Secret)
- 进入阿里云服务器控制台→应用详情→执行命令,粘贴API-Key完成配置
步骤3:验证访问
- 控制台复制服务器公网IP,浏览器打开:
http://公网IP:18789 - 复制控制台生成的Token,输入后即可访问
三、飞书集成(无缝对接,手机/电脑可指挥,命令直接复制)
步骤1:飞书开放平台创建企业自建应用
- 打开飞书开发者后台:https://open.feishu.cn/,登录企业账号→「企业自建应用」→「创建应用」
- 填写应用名称(如OpenClaw-Agent),选择「机器人」类型,提交创建
- 进入应用→「设置」→「凭证与基础信息」,复制AppID、AppSecret 保存
- 进入「事件与回调」,开启「回调」,配置:
- 请求地址:
http://你的IP:18789/feishu(本机/服务器IP) - Token/EncodingAESKey:点击「随机生成」,复制保存(后续配置用)
- 请求地址:
步骤2:容器内配置飞书插件(核心命令,直接复制)
# 进入OpenClaw容器 docker exec -it openclaw-local bash # 启用飞书插件 openclaw plugin enable feishu # 配置飞书参数(替换为自己的AppID/AppSecret/Token/AESKey) openclaw config set feishu.token 你的飞书回调Token openclaw config set feishu.aes_key 你的飞书EncodingAESKey openclaw config set feishu.app_id 你的飞书AppID openclaw config set feishu.app_secret 你的飞书AppSecret # 重启服务生效 openclaw gateway restart # 退出容器 exit步骤3:发布应用+测试交互
- 飞书开发者后台→「版本管理与发布」→「创建版本」→「发布到企业」
- 飞书端搜索应用名称,添加到群聊/个人对话
- 发送消息「你好」,OpenClaw自动回复即集成成功,支持「@机器人+指令」触发自动化
四、钉钉集成(24小时智能机器人,一键对接,无代码)
步骤1:钉钉开放平台创建企业内部应用
- 打开钉钉开放平台:https://open.dingtalk.com/,登录→「应用开发」→「钉钉应用」→「创建应用」
- 选择「企业内部应用」→「机器人」,填写名称后提交
- 进入应用→「凭证与基础信息」,复制Client ID、Client Secret 保存
- 进入「卡片平台」→「新建模板」,选择「消息卡片」,直接保存发布,复制模板ID 保存
步骤2:配置阿里云AppFlow连接流(对接OpenClaw+钉钉)
- 打开阿里云AppFlow:https://appflow.aliyun.com/,选择模板「钉钉群聊-流式调用百炼应用」→「立即使用」
- 账户授权:
- OpenClaw凭证:添加Token(部署时设置的OpenClaw Token)
- 钉钉凭证:添加Client ID/Client Secret(步骤1复制)
- 填写模板ID(步骤1复制),生成WebhookUrl,复制保存
步骤3:配置钉钉机器人+测试
- 钉钉开放平台→应用→「添加应用能力」→「机器人」→「添加」
- 消息接收模式选「HTTP模式」,接收地址填写生成的WebhookUrl
- 发布应用,添加到钉钉群聊,@机器人发送「你好」,自动回复即集成成功
五、自动化实战(3个高频办公场景,指令直接复制,零代码实现)
实战1:本地文件自动整理(按类型/时间分类,解放双手)
触发方式
飞书/钉钉发送指令:整理D盘/桌面的文件,按文档/图片/视频分类,按修改时间命名
核心效果
- 自动扫描指定目录,支持PDF/Word/Excel/图片/视频等所有格式
- 分类创建文件夹,文件重命名为「时间-原名称」,生成整理目录
- 适用于办公资料/下载文件整理,耗时从几小时缩短至几十秒
实战2:飞书/钉钉消息自动回复(关键词触发,24小时值守)
配置命令(容器内执行)
docker exec -it openclaw-local bash # 添加关键词回复规则(替换为自己的关键词/回复内容) openclaw config set auto_reply.key1 "加班|请假" openclaw config set auto_reply.value1 "加班申请请发送至XX邮箱,请假流程参考飞书审批" # 开启自动回复 openclaw config set auto_reply.enable true openclaw gateway restart触发方式
飞书/钉钉发送包含「加班/请假」的消息,机器人自动回复预设内容,支持多关键词/多回复配置。
实战3:定时生成工作报表(自动统计/推送,无需手动操作)
触发指令
飞书/钉钉发送:每天下午6点统计今日飞书群聊消息数量,按部门生成报表,推送到XX群
核心效果
- 按预设时间自动执行,支持按人/部门/关键词统计消息/文件/任务
- 生成Excel/图片报表,自动推送至指定群聊/个人
- 适用于团队工作统计/运营数据汇总,完全替代手动操作
六、常见问题排查(高频报错)
1. 报错:端口18789被占用(Windows/Linux通用)
# Ubuntu/Linux查找并杀死占用进程 sudo lsof -i:18789 | grep -v PID | awk '{print $2}' | xargs sudo kill -9 # Windows(管理员PowerShell) netstat -ano | findstr 18789 taskkill /f /pid 对应PID(替换为查询到的PID) # 重启OpenClaw docker compose restart2. 报错:Docker镜像拉取/构建失败
- 解决方案:重新执行「一、1.3」国内镜像源配置,关闭防火墙/代理,重新构建:
docker build -t openclaw:latest .
3. 飞书/钉钉集成无响应
- 检查IP/端口是否正确,服务器需放行18789端口(阿里云控制台→安全组→一键放通)
- 检查插件是否启用:
docker exec -it openclaw-local openclaw plugin list(确认feishu/dingtalk为enabled) - 重启服务:
docker compose restart
4. 大模型响应慢/无结果
- 解决方案:更换大模型API-Key(Kimi K2.5:https://ark.volces.com/),容器内配置:
openclaw config set model.api_key 你的新API-Key
七、进阶优化(可选,提升体验,干货补充)
1. 后台运行+开机自启(避免终端关闭停止服务)
# Docker默认已后台运行,设置开机自启Docker sudo systemctl enable docker sudo systemctl enable docker-compose@openclaw(需将docker-compose.yml移至/etc/docker/compose/)2. 数据持久化备份(防止配置/任务数据丢失)
# 备份OpenClaw数据卷到本地 docker run --rm -v openclaw-data:/source -v /本地备份路径:/target alpine cp -r /source/* /target/3. 多模型切换(本地/云端模型自由切换)
# 容器内配置自定义模型(如Kimi/通义千问/文心一言) docker exec -it openclaw-local bash openclaw config set model.base_url 模型API地址(如Kimi:https://ark.cn-beijing.volces.com/api/coding) openclaw config set model.api_key 模型API-Key openclaw gateway restart4. 权限管控(限制访问/操作范围,保障数据安全)
# 仅允许指定IP访问(替换为你的IP,多个IP用逗号分隔) docker exec -it openclaw-local bash openclaw config set gateway.allow_ips 192.168.1.100,139.xxx.xxx.xxx openclaw gateway restart八、核心补充
- OpenClaw核心能力:自然语言解析+任务自动化+多工具集成,支持本地文件/网络/IM工具全管控;
- 支持的插件:飞书/钉钉/企业微信/邮箱/日历,后续将新增微信/QQ/抖音集成,无需更新部署,直接启用插件;
- 本地部署数据完全私有化,无上传风险,适合企业/个人隐私敏感场景;
- 阿里云部署支持弹性扩容,4核8G配置可支撑10人以下团队协作,按需升级即可。