前端开发教程(保姆级教程:手把手教你部署OpenClaw,让AI帮你自动处理工作)

前端开发教程(保姆级教程:手把手教你部署OpenClaw,让AI帮你自动处理工作)
保姆级教程:手把手教你部署OpenClaw,让AI帮你自动处理工作

你是不是也遇到过这种情况:每天上班第一件事就是打开十几个网页,手动复制数据、整理表格、写日报、发消息……一上午就这么过去了。我前段时间也是,直到发现了OpenClaw这个开源AI智能体框架,才算是真正解放了双手。

OpenClaw(之前叫Clawdbot)和普通聊天AI不一样,它是真的能“干活”——读写文件、控制浏览器、执行脚本、对接API,把一堆分散的操作串成一条自动流水线。而且数据全存在你自己的电脑或服务器上,不用担心隐私问题。

下面是我折腾了几天踩过坑之后整理出来的完整教程,跟着做就行,所有代码都可以直接复制。

一、先搞清楚:OpenClaw到底能帮你干什么?

在动手之前,先看看它能做啥,免得白忙活一场。

我目前用OpenClaw跑起来的有这几个场景:

  • 每日资讯简报:早上8点自动抓取指定网站的文章,让AI总结成摘要,生成Markdown文件保存在本地
  • 桌面文件整理:监控下载文件夹,新文件自动按类型归档到对应目录(图片、文档、压缩包各归各位)
  • 钉钉群自动回复:群里有人问常见问题,AI自动从知识库找答案回复,不用人工盯着
  • 代码规范检查:每天晚上8点扫描项目文件夹,生成检查报告推送到邮箱

总之,凡是那种“每天重复做、步骤固定、不咋需要动脑子”的事儿,都能交给它。

二、准备工作:你需要的东西

硬件要求

部署方式

最低配置

推荐配置

系统要求

阿里云服务器

2核2GB内存

2核4GB内存

Alibaba Cloud Linux 3 / Ubuntu

Windows本地

4GB内存

8GB内存

Windows 11 64位

Mac本地

4GB内存

8GB内存

macOS 12及以上

Linux本地

4GB内存

8GB内存

Ubuntu 22.04+

软件依赖

  • Node.js 22或更高版本(核心运行环境,必须装)
  • npm包管理器(装Node的时候会自带)
  • Git(有些技能需要从GitHub拉代码)

需要准备的凭证(根据你的需求选)

  • 大模型API Key:推荐用阿里云百炼Coding Plan,新用户有免费额度,按次计费很便宜
  • 钉钉/飞书开发者账号:如果想接钉钉或飞书,需要去开放平台创建应用

小提示:如果是第一次玩,建议先用本地部署试试水,熟悉了再上云服务器。

三、部署方案一:阿里云极速部署(推荐长期运行)

如果你想让AI助手7x24小时在线,不受电脑开关机影响,云服务器是最稳的。阿里云有个一键部署方案,对新手很友好。

第1步:购买服务器

打开阿里云的OpenClaw一键部署页面,点击【一键购买并部署】。配置建议:

  • 镜像:选择OpenClaw(Moltbot)镜像
  • 实例:内存至少2GB
  • 地域:选美国弗吉尼亚(国内地域的联网搜索功能受限)

第2步:获取百炼API Key

去阿里云百炼控制台,找到密钥管理,创建一个API Key。复制保存好,后面要用

第3步:配置API Key并放行端口

在服务器控制台的“应用详情”页面:

  1. 点击“端口放通”,放行18789端口(OpenClaw的Web控制台端口)
  2. 点击“配置百炼API-Key”,粘贴你刚才复制的API Key
  3. 点击“执行命令”写入配置
  4. 点击“生成访问Token”,获取Dashboard的访问地址

完成后浏览器打开那个地址(类似http://你的公网IP:18789),就能看到OpenClaw的Web界面了。

如果不想用一键部署,也可以手动安装(SSH连上服务器执行):

# 更新系统sudo yum update -ysudo yum install -y curl git# 安装Node.js 22curl -fsSL https://nodejs.org/dist/v22.0.0/node-v22.0.0-linux-x64.tar.xz | sudo tar -xJ -C /usr/localsudo ln -s /usr/local/node-v22.0.0-linux-x64/bin/node /usr/bin/nodesudo ln -s /usr/local/node-v22.0.0-linux-x64/bin/npm /usr/bin/npm# 配置npm镜像(国内加速)npm config set registry https://registry.npmmirror.com# 安装OpenClawnpm install -g openclaw# 初始化配置openclaw onboard# 设置公网访问openclaw config set gateway.host 0.0.0.0openclaw config set gateway.port 18789# 启动服务openclaw gateway start

启动成功后访问http://你的公网IP:18789即可。

踩坑提醒:如果装完访问不了,检查服务器安全组有没有放开18789端口。我一开始就栽在这上面,折腾了半小时才发现端口没放行。

四、部署方案二:本地部署(Windows/Mac/Linux)

Windows 11部署

用管理员身份打开PowerShell,一行一行执行:

# 允许运行脚本Set-ExecutionPolicy RemoteSigned -Scope CurrentUser# 安装Node.js(用winget,微软官方包管理器)winget install OpenJS.NodeJS --version 22.0.0# 配置镜像npm config set registry https://registry.npmmirror.com# 安装OpenClawnpm install -g openclaw# 初始化(按提示操作就行)openclaw onboard# 启动网关服务openclaw gateway start

启动后浏览器打开http://127.0.0.1:18789就能看到控制台了。

注意:有些Windows系统可能需要先装WSL2才能跑得顺畅。如果遇到报错,在PowerShell里执行wsl --install重启电脑就行。

macOS部署

# 装Homebrew(如果没有的话)/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"# 装Node.jsbrew install node# 配置镜像npm config set registry https://registry.npmmirror.com# 装OpenClawnpm install -g openclaw# 初始化openclaw onboard# 启动openclaw gateway start

Linux部署(Ubuntu/Debian)

sudo apt updatesudo apt install -y curl git nodejs npm# 升级Node到稳定版sudo npm install -g nsudo n stablenpm config set registry https://registry.npmmirror.comnpm install -g openclawopenclaw onboardopenclaw gateway start

五、配置大模型API(这一步必须有)

OpenClaw要干活,背后得有个大模型撑着。我用的是阿里云百炼,免费额度够用。

修改配置文件

配置文件位置:

  • Mac/Linux:~/.openclaw/config.json
  • Windows:C:\Users\你的用户名\.openclaw\config.json

打开文件,找到model部分(如果没有就手动加),改成这样:

{  "model": {    "type": "aliyun-bailian",    "api_key": "你的API Key",    "secret": "你的AccessKeySecret",    "model_name": "qwen-7b-chat",    "max_tokens": 2048,    "temperature": 0.7,    "timeout": 60  }}

保存后重启服务:

openclaw gateway restart

如果想用其他模型

OpenClaw支持很多模型提供商,七牛云、OpenAI、Claude都能接。配置格式类似,主要是改type和api_key。

六、安装技能(Skills),让OpenClaw能力翻倍

Skills是OpenClaw的扩展插件,装完之后才能联网搜索、控制浏览器、操作文件之类的。

安装技能管理工具

npm install -g clawhub

常用技能一键安装

# 联网搜索clawhub install tavily-search# 浏览器自动化操作clawhub install agent-browser# 内容摘要clawhub install summarize# Notion知识库同步clawhub install notion# 定时提醒clawhub install proactive-agent

装完之后重启网关让技能生效:

openclaw gateway restart

查看已安装的技能:

openclaw skill list

小提示:装技能的时候如果报网络错误,检查一下npm镜像是不是配好了。

七、实战:配置一个自动化工作流

说再多不如来一个能直接用的例子。下面这个工作流每天早上8点自动抓取资讯、让AI总结、生成简报文件。

创建一个工作流配置文件

新建一个文件叫news_workflow.json,把下面的内容复制进去:

{  "workflowName": "每日行业资讯简报","trigger": {    "type": "cron",    "config": "0 8 * * *"  },"steps": [    {      "name": "抓取资讯内容",      "skill": "web_fetch",      "params": {        "url": "https://news.example.com/ai",        "selector": "article"      },      "retry": 2    },    {      "name": "内容摘要生成",      "skill": "summarize",      "params": {        "content": "${steps.抓取资讯内容.output}",        "length": 200      },      "retry": 1    },    {      "name": "生成简报文件",      "skill": "write",      "params": {        "path": "./daily_report.md",        "content": "# 今日行业资讯\n\n${steps.内容摘要生成.output}"      },      "retry": 1    }  ],"exception": {    "action": "log",    "notify": "console"  }}

加载并启动工作流

# 加载配置openclaw workflow load ./news_workflow.json# 启动工作流openclaw workflow start "每日行业资讯简报"# 查看运行状态openclaw workflow status

这个例子是每天定时跑,你也可以改成type: watch监控文件夹变化,或者type: message响应聊天消息。

八、常见问题排查

1. 连接超时或服务访问不了

  • 检查防火墙/安全组有没有放开18789端口
  • 如果用云服务器,确认公网IP没错
  • 本地部署的话试试curl http://127.0.0.1:18789/health看有没有响应

2. 签名验证失败(对接飞书/钉钉的时候)

  • 检查系统时间是不是和NTP同步了(时间差太大会导致验证失败)
  • 确认加密密钥里没有特殊字符,有的话URL编码一下

3. 钉钉机器人没反应

  • 确认Gateway在运行:openclaw gateway status
  • 检查钉钉应用的权限有没有开:Card.Streaming.Write和Card.Instance.Write必须打开
  • 确认机器人是Stream模式不是Webhook模式

4. 安装插件报错

OpenClaw从旧版本升级过来可能会有配置残留,先检查~/.openclaw/openclaw.json里有没有channels.dingtalk之类的旧配置节点,有就删掉,然后重新装插件。

前端开发教程(保姆级教程:手把手教你部署OpenClaw,让AI帮你自动处理工作)

九、写在最后

到这里,你应该已经成功把OpenClaw跑起来了。刚开始可能会遇到一些坑,但走通一次之后就会发现这东西是真的省时间。

我建议先从一个简单的场景开始,比如定时抓取RSS生成摘要,跑顺了再加复杂的功能。还有一点,定期备份~/.openclaw目录下的配置文件,万一搞坏了能快速恢复。

如果你在部署过程中遇到我没提到的问题,可以去OpenClaw官方文档或者GitHub Issues翻翻,社区现在很活跃,很多问题都有人遇到过并解决了。

快去试试吧,祝你也能拥有一个7x24小时干活的AI数字员工!

文章版权声明:除非注明,否则均为边学边练网络文章,版权归原作者所有