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

在 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 找到社区分享的技能包，也可以自己写。

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

注册 EXA（https://exa.ai），获取 API Key
安装 Python 库：pip3 install exa-py
在 ~/.openclaw/.env 中添加：EXA_API_KEY=你的Key
在 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 系统，值得。