跳到主要内容
Lium
博客
openclawagentself-hostedguide

从 0 搭建 OpenClaw：先装好，再学会用

这篇文章先带你一步一步装好 OpenClaw、接上 GPT 格式模型和飞书；第二章再讲 workspace、memory、skills、浏览器和日常用法，适合第一次接触的小白。

第一章：直接安装

1. 先选机器

直接这样选：

  • 想长期在线：选 VPS
  • 只想先试一下：选本地电脑

2. 先装基础环境

如果你是 Ubuntu VPS，先执行：

sudo apt update
sudo apt install -y git curl build-essential

然后检查：

node -v
npm -v

如果没有 Node，就先安装：

  • Node.js：<https://nodejs.org>
  • nvm：<https://github.com/nvm-sh/nvm>

3. 安装 OpenClaw

mkdir -p ~/openclaw
cd ~/openclaw
npm install -g openclaw@latest
openclaw --help

能看到帮助信息，就说明装好了。

4. 直接跑官方向导

第一次安装，直接执行：

openclaw onboard --install-daemon

这一步里面，直接按下面选：

  • Gateway：按默认走
  • 模型：先选 OpenAI API Key 这条线，最省事
  • 渠道：后面再接飞书也行
  • daemon：安装

5. 接模型

如果你用 OpenAI 官方，直接按向导填。

如果你已经有环境变量，也可以直接这样：

openclaw onboard --openai-api-key "$OPENAI_API_KEY"

你只先记住这 3 个概念：

  • API key
  • base URL
  • model

第一套环境先接通一套 GPT / OpenAI-compatible 模型就够了。

6. 检查 OpenClaw 有没有跑起来

向导跑完后，直接检查：

openclaw status
openclaw gateway status
openclaw models status

这三条没明显报错，就继续下一步。

7. 接飞书

先打开飞书开放平台：

  • <https://open.feishu.cn/app>

然后创建企业自建应用，接着做这几步：

  • 开启机器人能力
  • 拿到 App ID
  • 拿到 App Secret
  • 配权限
  • 配事件订阅
  • 发布应用

回到服务器后，执行：

openclaw channels add

然后按提示：

  • 选择 Feishu
  • 填 App ID
  • 填 App Secret

8. 最后验证

最后检查这几项：

  • openclaw --help 能跑
  • openclaw status 正常
  • openclaw gateway status 正常
  • openclaw models status 正常
  • 飞书能收到消息
  • OpenClaw 能回复消息

这些都通过，就说明第一章已经完成。

9. 如果你只想走最短路径

那就按这个顺序直接做：

  • 装 Node、npm、Git
  • 安装 openclaw
  • 跑 openclaw onboard --install-daemon
  • 先接一套 GPT / OpenAI-compatible 模型
  • 执行 openclaw channels add
  • 选择 Feishu
  • 填 App ID / App Secret
  • 发一条消息测试

第二章：再来理解 OpenClaw 的详细用法

第一章的目标，是让你先跑起来。

第二章才讲，跑起来之后你怎么长期用顺手。

10. workspace 是什么

你可以把 workspace 理解成：

agent 真正工作的地方。

这里会放：

  • 规则
  • 风格
  • 用户信息
  • 长期记忆
  • 每天的记录
  • 本地环境说明

11. workspace 里的几个核心文件

11.1 AGENTS.md

规则文件。

比如：

  • 启动时先读什么
  • 哪些事情要先问
  • 哪些事情不要做

11.2 SOUL.md

风格文件。

比如：

  • 说话要不要直接
  • 是不是少废话
  • 用什么语气

11.3 USER.md

用户信息文件。

比如：

  • 怎么称呼你
  • 你的偏好
  • 你的时区

11.4 MEMORY.md

长期记忆。

放长期重要信息，比如：

  • 固定偏好
  • 长期决策
  • 项目背景

11.5 memory/YYYY-MM-DD.md

每天的记录。

放：

  • 今天做了什么
  • 今天改了什么
  • 某个问题推进到哪一步

11.6 TOOLS.md

本地环境说明。

放：

  • 服务器地址
  • SSH 别名
  • 常用目录
  • 设备名字

12. 为什么 memory 很重要

如果你不写 memory，agent 下次很容易像重新认识你。

最简单的规则就是：

  • 今天发生的事，写进 memory/YYYY-MM-DD.md
  • 长期重要的事，整理进 MEMORY.md

13. Skills 是干什么的

你可以把 skill 理解成某类任务的专用说明书。

它会告诉 agent：

  • 什么时候该触发
  • 该怎么做
  • 用什么工具
  • 哪些坑别踩

14. 部署怎么选

直接这样选：

  • 你要 24 小时在线：用 VPS
  • 你只是先试：先用本地电脑

如果你用 VPS，最简单的做法就是在安装时直接执行：

openclaw onboard --install-daemon

这样会直接把 OpenClaw 装成后台服务。

装完后只检查这两条：

openclaw status
openclaw gateway status

能正常返回，就说明部署基本完成。

15. 浏览器能力什么时候再加

浏览器能力放到最后再接。

顺序就这样：

  • 先装 OpenClaw
  • 先接模型
  • 先接飞书
  • 最后再加浏览器

16. 安全边界一定要提前定

一般可以默认做的：

  • 读文件
  • 搜项目
  • 跑不破坏的检查命令
  • 整理文档

一般必须先问的：

  • 删除数据
  • 改线上配置
  • 发消息给别人
  • 发邮件或公开发布
  • 重启服务、改安全设置

17. 日常最常见的用法

后面你通常会这样用它：

  • 改代码
  • 整理文档
  • 回消息
  • 查任务和日历
  • 记录上下文
  • 持续跟进一个工作区里的项目

18. 最常见的坑

18.1 安装好了，但命令不能用

通常是：

  • Node 版本不对
  • npm 全局路径有问题
  • shell 没刷新

18.2 模型配了，但不稳定

通常是：

  • key 错了
  • base URL 错了
  • model 错了
  • 上游不稳

18.3 飞书接了，但消息没进来

通常是：

  • 回调没通
  • 权限没开够
  • 事件订阅没开
  • 配置没保存好

18.4 写了记忆，但效果不明显

通常是：

  • 只写了 daily note
  • 没整理进长期记忆
  • 信息太散

19. 需要时可以直接点的链接

  • OpenClaw 文档：<https://docs.openclaw.ai>
  • OpenClaw 源码：<https://github.com/openclaw/openclaw>
  • OpenClaw 社区：<https://discord.com/invite/clawd>
  • ClawHub：<https://clawhub.com>
  • Node.js：<https://nodejs.org>
  • nvm：<https://github.com/nvm-sh/nvm>
  • 飞书开放平台：<https://open.feishu.cn/app>

20. 最后帮你压缩成一句话

如果你是第一次接触 OpenClaw，就按这个顺序做：

  • 装 Node、npm、Git
  • 安装 OpenClaw
  • 跑 openclaw onboard --install-daemon
  • 按 GPT 格式接模型
  • 用 openclaw channels add 接飞书
  • 用 openclaw status、openclaw gateway status、openclaw models status 检查
  • 真发一条飞书消息测试

这样最省事，也最不容易乱。