跳到主要内容
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（Node 版本管理工具，可自行搜索官方仓库）

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. 接飞书

先打开飞书开放平台：

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

  • 开启机器人能力
  • 拿到 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. 需要时可以直接点的链接

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

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

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

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