你是不是也遇到过这种情况:每天上班第一件事就是打开十几个网页,手动复制数据、整理表格、写日报、发消息……一上午就这么过去了。我前段时间也是,直到发现了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并放行端口
在服务器控制台的“应用详情”页面:
点击“端口放通”,放行18789端口(OpenClaw的Web控制台端口)
点击“配置百炼API-Key”,粘贴你刚才复制的API Key
点击“执行命令”写入配置
点击“生成访问Token”,获取Dashboard的访问地址
完成后浏览器打开那个地址(类似http://你的公网IP:18789),就能看到OpenClaw的Web界面了。
如果不想用一键部署,也可以手动安装(SSH连上服务器执行):
更新系统
sudo yum update -y
sudo yum install -y curl git
安装Node.js 22
curl -fsSL https://nodejs.org/dist/v22.0.0/node-v22.0.0-linux-x64.tar.xz | sudo tar -xJ -C /usr/local
sudo ln -s /usr/local/node-v22.0.0-linux-x64/bin/node /usr/bin/node
sudo ln -s /usr/local/node-v22.0.0-linux-x64/bin/npm /usr/bin/npm
配置npm镜像(国内加速)
npm config set registry https://registry.npmmirror.com
安装OpenClaw
npm install -g openclaw
初始化配置
openclaw onboard
设置公网访问
openclaw config set gateway.host 0.0.0.0
openclaw 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
安装OpenClaw
npm 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.js
brew install node
配置镜像
npm config set registry https://registry.npmmirror.com
装OpenClaw
npm install -g openclaw
初始化
openclaw onboard
启动
openclaw gateway start
Linux部署(Ubuntu/Debian)
sudo apt update
sudo apt install -y curl git nodejs npm
升级Node到稳定版
sudo npm install -g n
sudo n stable
npm config set registry https://registry.npmmirror.com
npm install -g openclaw
openclaw onboard
openclaw 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响应聊天消息。
八、常见问题排查
- 连接超时或服务访问不了
检查防火墙/安全组有没有放开18789端口
如果用云服务器,确认公网IP没错
本地部署的话试试curl http://127.0.0.1:18789/health看有没有响应 - 签名验证失败(对接飞书/钉钉的时候)
检查系统时间是不是和NTP同步了(时间差太大会导致验证失败)
确认加密密钥里没有特殊字符,有的话URL编码一下 - 钉钉机器人没反应
确认Gateway在运行:openclaw gateway status
检查钉钉应用的权限有没有开:Card.Streaming.Write和Card.Instance.Write必须打开
确认机器人是Stream模式不是Webhook模式 - 安装插件报错
OpenClaw从旧版本升级过来可能会有配置残留,先检查~/.openclaw/openclaw.json里有没有channels.dingtalk之类的旧配置节点,有就删掉,然后重新装插件。
九、写在最后
到这里,你应该已经成功把OpenClaw跑起来了。刚开始可能会遇到一些坑,但走通一次之后就会发现这东西是真的省时间。
我建议先从一个简单的场景开始,比如定时抓取RSS生成摘要,跑顺了再加复杂的功能。还有一点,定期备份~/.openclaw目录下的配置文件,万一搞坏了能快速恢复。
如果你在部署过程中遇到我没提到的问题,可以去OpenClaw官方文档或者GitHub Issues翻翻,社区现在很活跃,很多问题都有人遇到过并解决了。
快去试试吧,祝你也能拥有一个7x24小时干活的AI数字员工!