你是不是也遇到过这种情况:每天上班第一件事就是打开十几个网页,手动复制数据、整理表格、写日报、发消息……一上午就这么过去了。我前段时间也是,直到发现了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 -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 startLinux部署(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跑起来了。刚开始可能会遇到一些坑,但走通一次之后就会发现这东西是真的省时间。
我建议先从一个简单的场景开始,比如定时抓取RSS生成摘要,跑顺了再加复杂的功能。还有一点,定期备份~/.openclaw目录下的配置文件,万一搞坏了能快速恢复。
如果你在部署过程中遇到我没提到的问题,可以去OpenClaw官方文档或者GitHub Issues翻翻,社区现在很活跃,很多问题都有人遇到过并解决了。
快去试试吧,祝你也能拥有一个7x24小时干活的AI数字员工!