乐于分享
好东西不私藏

OpenClaw 搭建完全指南:从零开始拥有你的私人 AI Agent

OpenClaw 搭建完全指南:从零开始拥有你的私人 AI Agent

OpenClaw 搭建完全指南:从零开始拥有你的私人 AI Agent(本地 + 云服务器方案)

如果你用过 ChatGPT,你大概率只用了它最基础的能力:聊天。

但如果我告诉你,有一个开源工具,能让 AI 不只是聊天,还能帮你执行命令、读写文件、定时推送消息、自动写文章、操作浏览器,而且你可以通过飞书随时随地和它对话——你会不会想试试?

这个工具叫 OpenClaw。

今天这篇文章,手把手教你从零搭建一套属于自己的 AI Agent 系统。不需要高深的编程基础,跟着步骤走就行。

OpenClaw 能做什么

先说几个我自己在用的真实场景:

每天早上 9 点,AI 自动采集加密货币行情数据,生成一份包含价格分析、趋势热点、操作建议的完整日报,推送到我的飞书。

我在飞书里说一句"帮我写一篇关于 XX 的公众号文章",AI 自动搜索素材、写 3000 字深度分析、生成封面图、排版、创建公众号草稿。我只需要在后台点"发布"。

遇到技术问题,我直接在手机上问 AI,它能在我的电脑上执行命令、读日志、改配置,然后告诉我结果。

这些都不是概念演示,是我每天实际在用的功能。

而实现这一切的基础,就是 OpenClaw。

你需要准备什么

方案一:本地部署(推荐新手先试)

一台 Mac 或 Linux 电脑(Windows 也可以,但本文以 Mac 为主)

Node.js 18 以上版本

一个飞书账号

方案二:云服务器部署

一台海外 VPS(推荐 Hetzner、DigitalOcean)

最低配置:1 核 CPU、1GB 内存、10GB 硬盘

系统:Ubuntu 22.04 或 24.04

两种方案各有优劣:本地部署零成本、响应快,但电脑关机就停了;云服务器 24 小时在线,但每月需要几十块的服务器费用。

我的做法是:在自己的 Mac 上跑,反正笔记本基本不关机。

方案一:本地部署(Mac)

第一步:安装 Node.js

打开终端,安装 nvm(Node 版本管理器):

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

重新打开终端,安装 Node.js 22:

nvm install 22

nvm use 22

验证安装:

node -v

看到 v22.x.x 就对了。

第二步:安装 OpenClaw

npm install -g openclaw

如果遇到权限报错,先配置 npm 全局目录:

mkdir ~/.npm-global

npm config set prefix '~/.npm-global'

echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc

source ~/.zshrc

npm install -g openclaw

第三步:初始化

openclaw init

这会在你的用户目录下创建 ~/.openclaw/ 文件夹,里面包含所有配置文件和工作空间。

第四步:启动 Gateway

openclaw gateway start

Gateway 是 OpenClaw 的核心引擎,负责接收消息、调度 AI、管理会话。

验证是否正常运行:

openclaw status

看到 Gateway: running 就成功了。

第五步:设置开机自启

openclaw gateway install

这样每次开机 Gateway 会自动启动,不用手动运行。

方案二:云服务器部署

第一步:购买 VPS

推荐几个海外 VPS 服务商:

Hetzner:性价比最高,约 4 美元/月起,欧洲和美国机房

DigitalOcean:文档最全,6 美元/月起,全球机房

Vultr:机房多,6 美元/月起

选 Ubuntu 22.04 系统,最低 1 核 1G 配置就能跑。

第二步:连接服务器

ssh root@你的服务器IP

第三步:安装 Docker

apt update && apt upgrade -y

curl -fsSL https://get.docker.com | sh

docker --version

第四步:用 Docker 部署 OpenClaw

docker pull ghcr.io/openclaw/openclaw:latest

mkdir -p ~/openclaw

docker run -d \

--name openclaw \

--restart always \

-v ~/openclaw:/root/.openclaw \

-p 18789:18789 \

ghcr.io/openclaw/openclaw:latest

第五步:验证

docker logs openclaw

看到 Gateway started 就成功了。

云服务器的优势是 24 小时在线,定时任务(比如每天早上推日报)不会因为你关电脑而中断。

连接飞书机器人

不管你用本地还是云服务器方案,接下来都需要创建一个飞书机器人作为你和 AI 对话的入口。

第一步:创建飞书应用

打开飞书开放平台(https://open.feishu.cn),登录后进入开发者后台。

点击"创建企业自建应用"。

填写应用名称和描述(随意取)。

在"机器人"页面开启机器人能力。

在"权限管理"中添加以下权限:接收消息、发送消息、读取群信息。

在"事件订阅"中配置消息接收地址(OpenClaw Gateway 地址)。

在"凭证与基础信息"页面获取 App ID 和 App Secret。

第二步:配置 OpenClaw

编辑配置文件 ~/.openclaw/openclaw.json(云服务器上是 ~/openclaw/openclaw.json),在 channels 部分添加:

{

"channels": {

"feishu": {

"enabled": true,

"accounts": {

"default": {

"appId": "你的App ID",

"appSecret": "你的App Secret",

"agent": "main"

}

}

}

}

}

第三步:重启 Gateway

本地:openclaw gateway restart

云服务器:docker restart openclaw

第四步:测试

在飞书里搜索你的机器人名称,发一条消息。如果 AI 回复了,说明对接成功。

配对完成后,你就可以在飞书里和你的 AI Agent 对话了。

配置 AI 模型

OpenClaw 本身不包含 AI 模型,它需要连接一个模型服务。常见的方式:

方式一:直接用 Anthropic / OpenAI 官方 API

注册 Anthropic(https://console.anthropic.com)或 OpenAI(https://platform.openai.com)账号,获取 API Key,按量付费。

在 openclaw.json 中配置:

{

"models": {

"providers": {

"anthropic": {

"apiKey": "你的API Key",

"models": [

{ "id": "claude-sonnet-4", "contextWindow": 200000 }

]

}

}

}

}

方式二:使用兼容 API 的第三方服务

市面上有一些提供 AI 模型 API 的服务商,价格比官方更低。具体选择取决于你的需求和预算。在 openclaw.json 中配置 baseUrl 指向对应服务即可。

设置默认模型:

openclaw models set anthropic/claude-sonnet-4

让 AI 做更多事:技能包

OpenClaw 有一个技能包(Skill)系统。每个 Skill 是一组指令和脚本,让 AI 学会一项新能力。

比如:

搜索技能:让 AI 能联网搜索实时信息

公众号技能:让 AI 能自动写文章、创建公众号草稿

加密货币技能:让 AI 能分析行情、生成日报

技能包放在 ~/.openclaw/workspace/skills/ 目录下。你可以在 https://clawhub.com 找到社区分享的技能包,也可以自己写。

安装一个搜索技能的例子:

  1. 注册 EXA(https://exa.ai),获取 API Key
  2. 安装 Python 库:pip3 install exa-py
  3. 在 ~/.openclaw/.env 中添加:EXA_API_KEY=你的Key
  4. 在 skills/ 目录下创建对应的 Skill 文件

配好后,你在飞书里问"最近有什么 AI 新闻",AI 就会先搜索再回答,而不是凭记忆瞎编。

定时任务:让 AI 主动找你

这是 OpenClaw 最实用的功能之一。

在工作目录下创建 HEARTBEAT.md 文件,写上你希望 AI 定期执行的任务。OpenClaw 会按设定的间隔自动检查并执行。

一个简单的例子:

每天早上 9 点,搜索今日 AI 领域的重要新闻,整理成摘要推送给我。

设置心跳间隔(在 openclaw.json 中):

{

"agents": {

"defaults": {

"heartbeat": { "every": "30m" }

}

}

}

每 30 分钟检查一次,如果到了执行时间且今天还没执行,就自动运行。

写在最后

搭建过程中你大概率会遇到各种小问题:npm 权限报错、Bot 不回复、Gateway 启动失败。这些都是正常的。

几个排障原则:

先检查 Gateway 是否在运行:openclaw status

再检查配置文件有没有写错:JSON 格式很严格,少一个逗号就报错

再检查网络是否通畅:飞书机器人需要能连上飞书的服务器

遇到搞不定的问题,可以去 OpenClaw 的社区提问:https://discord.com/invite/clawd

我自己从零搭到完全可用,大概花了一个周末。但现在每天省下来的时间,远远超过当初投入的那几个小时。

一套属于自己的 AI Agent 系统,值得。