OpenClaw 完全上手指南
从安装到 24 小时自动化

OpenClaw 是 2026 年最火的开源 AI Agent 项目（GitHub 68,000+ stars），但大多数人装完就落灰了。这篇教程不讲理论，只管把你从「装好了然后呢」带到「它 24 小时在帮我干活」。全程实操，踩过的坑全部标出来。

OpenClaw 是什么？

一句话：OpenClaw = 装在你自己电脑上、通过聊天软件随时指挥干活的 AI Agent。

它和 ChatGPT 这类聊天机器人的核心区别：

1. 环境安装

系统要求

• 操作系统：macOS / Linux / Windows（需 WSL）
• Node.js：v18 或更高
• AI 模型 API Key：Claude / GPT / Gemini / 国产模型均可

三步安装

第一步：安装 Node.js（Mac 用户用 Homebrew）

brew install nodejs
node --version   # 确认 >= v18

第二步：安装 OpenClaw

方法一：官方脚本（推荐）curl -fsSL https://openclaw.ai/install.sh | bash

方法二：NPM 安装npm install -g openclaw

方法三：Docker 安装docker pull openclaw/openclaw:latest
docker run -d --name openclaw \
  -v ~/.openclaw:/root/.openclaw \
  openclaw/openclaw:latest

第三步：验证

openclaw --version
# 出现版本号 = 安装成功

2. 初始化配置

openclaw onboard --install-daemon

进入安装向导后，按顺序操作：

1. 选择 QuickStart 模式
2. 选择模型：推荐 Claude Sonnet / GPT / Gemini
3. 选择通讯频道：Telegram（最快上手）
4. Skills：选 no，后面手动精选安装
5. API Key：全部选 no，后续单独配
6. Hooks：选 Skip for now
7. UI 页面：选 Open the Web UI

3. 接入 Telegram Bot

Telegram 是最快的上手通道 — 5 分钟就能跟你的 Agent 对话。

创建 Bot

1. Telegram 搜索 @BotFather
2. 发送 /start → /newbot
3. 输入 Bot 显示名称（如：我的AI助理）
4. 输入 Bot 用户名（必须以 _bot 结尾）
5. 保存返回的 Token（格式：7691627338:AAHo9ix...）

配置到 OpenClaw

openclaw config set channels.telegram.botToken "YOUR_BOT_TOKEN"
openclaw config set channels.telegram.enabled true

配置代理（国内用户必做）

先确认 VPN 代理端口（如 Clash Verge 默认 7897）：

# 将代理写入 shell 配置
echo -e '\nexport http_proxy=http://127.0.0.1:7897' >> ~/.zshrc
echo -e 'export https_proxy=http://127.0.0.1:7897' >> ~/.zshrc
echo -e 'export all_proxy=socks5://127.0.0.1:7897' >> ~/.zshrc
source ~/.zshrc

# 重启网关
openclaw gateway restart

4. 身份录入：让 Agent 认识你

这是决定你的 Agent 是"人工智障"还是"专属助理"的关键一步。很多人装完就开问，但你连自己是谁都没告诉它，它怎么给你想要的答案？

直接把下面这段发给 Agent，结尾加一句「以上内容请永久记住，这是我的基本个人信息」：

身份录入模板我今年 XX 岁，在 XX 城市做 XX 工作，主要负责 XX 内容。
我平时不喜欢太正式的说话方式，你跟我沟通可以随意一点。
我每天 XX 点上班，平时 XX 点睡觉。
我目前在学 XX / 有 XX 习惯，相关内容麻烦多提醒我。
我的时区是 GMT+8。

不用一次写完，随时可以补充。今天告诉它你喜欢健身，明天告诉它你在学法语，这些它都会记下来。

5. 人格定制：SOUL.md

SOUL.md 是 Agent 的灵魂文件 — 人设、行为准则、工作风格全在里面。

文件位置：~/.openclaw/workspace/SOUL.md

SOUL.md 示例（CEO 型大总管）## 核心身份
你是我的首席 AI 助手和数字化总管。你拥有极致的执行力和第一性原理思维，
同时管理多个任务线，从不被压垮。

## 你的角色
- 接收用户指令并拆解成优先级任务
- 分配给正确的 Agent（如有团队成员）
- 冲突时做最终决定
- 向用户汇报状态和进度

## 原则
- 第一性原理思考：把一切拆解到最基本
- 极致负责和执行速度
- 最高标准 —— 绝不容忍平庸
- 彻底透明和数据驱动决策

## 工作风格
说话直接、简洁、带行动力。总是给出清晰的行动计划。
推动实现 10 倍成果，不说废话。

6. 记忆系统

记忆是 OpenClaw 区别于普通聊天机器人的核心能力。有几种方案可选：

推荐方案：MemOS — 直接告诉你的 Agent：

发给 Agent 的安装指令https://github.com/MemTensor/MemOS-Cloud-OpenClaw-Plugin
帮我安装这个插件，并且将记忆功能改为用这个。
你中间可能会改动配置文件，注意要参考 openclaw 的文档，不要把自己改崩了。

然后去 MemOS 控制台申请密钥，填入配置即可。

查看已有记忆：

# 查看记忆文件
cat ~/.openclaw/memory/long-term.json

# 或直接问 Agent
你记得我的哪些信息？

7. 必装 Skills（精选 7 个）

先搞清两个概念：Skill = Agent 能干的活（搜网页、发邮件）；插件 = 给 Agent 加外设（语音、皮肤）。新手先装 Skill，别碰插件。

安装渠道

通用管理命令

# 查看已装 Skills
openclaw skills list --status ready

# 安装
npx clawhub@latest install <skill-slug>

# 卸载 / 启用 / 禁用
openclaw skills uninstall <skill-slug>
openclaw skills enable <skill-slug>
openclaw skills disable <skill-slug>

# 检查更新
npx skills check
npx skills update all

7 个必装清单

1. Capability Evolver — 分析使用习惯，自动优化 Agent 回复和干活逻辑（官方下载量第一，35000+）
2. Self-Improving Agent — 每次干完活自己复盘，记下哪里错了、哪里能优化。和上面是黄金搭档
3. Find Skills — "元 Skill"，帮你快速发现和安装所需技能，不用自己翻市场
4. Tavily Search — 专为 AI 设计的搜索引擎，结果结构化、精准。每月 1000 次免费额度
5. Multi Search Engine — 集成 17 个搜索引擎（8 国内 + 9 国际），无需 API Key
6. Office-Automation — 日程、邮件、文档、Excel 等办公自动化
7. Skill Creator — 让 Agent 帮你自动写新 Skill，零代码扩展能力

8. 浏览器 + 搜索能力

给 Agent 加上"眼睛"，让它能看网页和搜索信息。

浏览器控制

openclaw plugins install @openclaw/browser-control
openclaw config set browser.enabled true
openclaw config set browser.headless false

搜索能力分层

选择原则：有 URL / 指定平台 → L2 | 一句话能答 → L1 | 多源 / "帮我调研" → L3

9. 定时任务：24 小时自动干活

这是 OpenClaw 从"工具"变成"员工"的转折点。设置定时任务后，它不用你催就自己干活。

创建每日简报

直接告诉 Agent：

发给 Agent 的定时任务指令我想让你每天早上 8 点给我发送一份简报，包含：
1. 今天的天气
2. 我的日历安排
3. 未读邮件数量
4. 一句励志的话

管理定时任务

openclaw cron list              # 列出所有定时任务
openclaw cron show <task-id>    # 查看详情
openclaw cron disable <task-id> # 暂停
openclaw cron delete <task-id>  # 删除

推荐定时任务

• 每日晨间简报（天气 + 日程 + 待办）
• 每周五下午自动生成周报
• 每天 18:00 提醒收工
• 竞品价格监控（每 6 小时一次）

10. 多 Agent 协作：组建团队

当一个 Agent 不够用时，可以组建多个 Agent 分工协作。但别上来就拆，先搞清楚什么时候该拆。

拆分原则

按上下文拆分，不按职责拆分。

快速决策流程

1. 需要独立记忆？否 → 用现有 Agent + 新 Skill
2. 上下文会冲突？是 → 创建新 Agent
3. 需要频繁共享信息？是 → 合并为一个 Agent
4. 只是工具/格式不同？是 → 用 Skill 解决

Telegram 多 Agent 搭建

Step 1：用 @BotFather 为每个 Agent 创建独立 Bot Token。

Step 2：定义 Agent 阵容（在 OpenClaw 配置文件中）：

agents 配置示例{
  "agents": {
    "list": [
      { "id": "main",    "default": true, "name": "大总管",
        "workspace": "/root/.openclaw/workspace" },
      { "id": "dev",     "name": "开发助理",
        "workspace": "/root/.openclaw/workspace-dev" },
      { "id": "content", "name": "内容助理",
        "workspace": "/root/.openclaw/workspace-content" }
    ]
  }
}

Step 3：开启 Agent 间通信：

Agent 间通信配置{
  "tools": {
    "agentToAgent": {
      "enabled": true,
      "allow": ["main", "dev", "content"]
    }
  }
}

Step 4：给每个 Agent 配团队通讯录（AGENTS.md）：

AGENTS.md（每个 Agent 的 workspace 里都要放一份）## 团队成员
- **dev**（开发助理） — 代码开发、技术架构、部署
- **content**（内容助理） — 文章、文案、内容创作
需要协作时用 sessions_send 工具，agentId 填对应 id。

Step 5：重启网关，在群里 @ 机器人就能分配任务了。

openclaw gateway restart

11. 安全守则

Agent 权限越大，风险越高。以下是必须遵守的安全实践：

1. 初期用沙盒模式：限制文件系统、网络、Shell 访问范围
2. 不存明文密码：不在配置文件中存储敏感信息
3. 定期审查自动化规则：特别是定时任务和文件操作权限
4. 只启用需要的权限：不用的 Skill 禁用掉
5. 建议用专用设备运行：Mac Mini、旧笔记本或 VPS

# 安全审计
openclaw security audit        # 基础审计
openclaw security audit --deep # 深度审计
openclaw doctor                # 健康检查

12. 常见问题排查

API-Key invalid（模型授权失败）

核对 Key 无拼写错误、无多余空格；确认密钥处于"启用"状态；确认模型提供商选择正确。

Skills 安装网络超时

# 配置国内镜像源
openclaw config set plugins.registry https://registry.npmmirror.com/openclaw-plugins
# 重新安装
npx clawhub@latest install <skill-slug>

端口 18789 被占用

lsof -i:18789           # 查找占用进程
kill -9 <PID>           # 终止进程
openclaw gateway restart # 重启

Skill 安装成功但 "not ready"

openclaw skills enable <skill-slug>
openclaw skills install-deps <skill-slug>
openclaw gateway restart

服务器重启后 OpenClaw 没自动启动

openclaw gateway enable      # 设置开机自启
openclaw gateway is-enabled  # 验证配置
openclaw gateway start       # 手动启动

总结

OpenClaw 不是装完就完事的工具，是需要持续磨合的 AI 员工。但不用一开始就搞复杂玩法 — 先从最小需求开始：

• 今天：装好 + 接通 Telegram + 录入身份信息
• 明天：写 SOUL.md + 装 7 个必备 Skills
• 后天：设置第一个定时任务（每日简报）
• 一周后：根据需要加搜索能力、办公自动化
• 需要时：组建多 Agent 团队

光把身份录入 + SOUL.md + 必装 Skills 搞定，你的 Agent 就已经超过 90% 的新手了。所有熟手，都是从「让它先跑起来」这一步开始的。