OpenClaw使用教程：从安装到上手

摘要：OpenClaw是一个开源的自托管AI助手框架。它在你自己的设备上运行，通过你日常用的消息软件（WhatsApp、Telegram、Slack、Discord、飞书、微信等20多个平台）提供AI服务。

OpenClaw是一个开源的自托管AI助手框架。它在你自己的设备上运行，通过你日常用的消息软件（WhatsApp、Telegram、Slack、Discord、飞书、微信等20多个平台）提供AI服务。它不是简单的聊天机器人，而是一个有记忆、能定时干活、能自己执行任务的数字员工。

官网：https://openclaw.ai
文档：https://docs.openclaw.ai
GitHub：https://github.com/openclaw/openclaw

一、环境准备

项目	要求
Node.js	推荐24，最低22.14以上
操作系统	macOS / Linux / Windows（WSL2更稳）
API密钥	Anthropic、OpenAI、Google等提供商的密钥
可选	Docker（沙箱模式）、Tailscale（远程访问）

检查Node版本：

node --version
# 输出应该是 v24.x.x 或 v22.14+

二、安装与初始化

命令行安装（推荐）

macOS / Linux：

curl -fsSL https://openclaw.ai/install.sh | bash

Windows（PowerShell）：

iwr -useb https://openclaw.ai/install.ps1 | iex

或者用npm/pnpm安装：

npm install -g openclaw@latest
# 或
pnpm add -g openclaw@latest

从源码构建

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build

初始化向导

openclaw onboard --install-daemon

向导会一步步带你完成：

选模型提供商（Anthropic、OpenAI、Google等）
输API密钥
配Gateway网关
装守护进程（开机自启）

验证安装

# 看网关状态，默认端口18789
openclaw gateway status

# 打开控制面板
openclaw dashboard

# 发条测试消息
openclaw agent --message "你好，OpenClaw！" --thinking high

三、核心架构

OpenClaw分四层：

通信层（Gateway）：前台接待，统一处理所有消息渠道
调度层（Cron/Heartbeat）：日程表，决定什么时候干什么
执行层（Agent Loop）：顾问本人，思考→行动→观察→判断
记忆层（Memory/Workspace）：工作笔记本，SOUL.md、MEMORY.md这些文件

Agent Loop的工作流程：

用户消息进来 → 思考（分析任务）→ 行动（调工具）→ 观察（看结果）→ 判断（要不要继续）→ 循环

四、基础配置

主配置文件在~/.openclaw/openclaw.json。关键配置：

{
  "gateway": {
    "port": 18789,
    "controlUi": {
      "enabled": true
    }
  },
  "providers": {
    "anthropic": {
      "apiKey": "sk-ant-xxxxx"
    },
    "openai": {
      "apiKey": "sk-xxxxx"
    }
  },
  "agents": {
    "defaults": {
      "model": "claude-sonnet-4-20250514",
      "sandbox": {
        "mode": "non-main"
      }
    }
  },
  "security": {
    "dmPolicy": "pair"
  }
}

配置说明：

providers：放模型提供商和密钥
agents.defaults.model：默认用的模型
agents.defaults.sandbox.mode：non-main表示群消息在Docker沙箱跑
security.dmPolicy：pair表示陌生人私信要配对验证

环境变量

变量	用途
OPENCLAW_HOME	主目录路径
OPENCLAW_STATE_DIR	状态数据目录
OPENCLAW_CONFIG_PATH	配置文件路径

五、接入消息渠道

Telegram（最快上手）

在Telegram找@BotFather，建个Bot，拿到Token
配渠道：

openclaw channels add telegram
# 按提示输Bot Token

或者手改配置文件：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123456:ABC-DEF..."
    }
  }
}

Slack

openclaw channels add slack

Discord

openclaw channels add discord

飞书

openclaw channels add feishu

控制谁能用

用allowFrom限制谁可以跟助手说话：

{
  "channels": {
    "telegram": {
      "allowFrom": ["你的telegram_id"]
    }
  }
}

六、记忆系统

记忆文件结构：

~/.openclaw/
├── SOUL.md          # AI的性格设定
├── USER.md          # 用户偏好、背景
├── MEMORY.md        # 长期记忆
├── AGENTS.md        # 行为规范
├── HEARTBEAT.md     # 心跳任务配置
└── memory/
    ├── 2026-04-01.md
    └── ...

写SOUL.md的例子

# AI助手性格设定

## 基本性格
- 你是一个经验丰富的全栈工程师助手
- 回答简洁、专业、有条理
- 优先用中文交流

## 工作风格
- 先理解需求，再动手实现
- 提供代码时带关键注释

## 技术偏好
- Python: FastAPI + SQLAlchemy
- 前端: Vue 3 + TypeScript
- 数据库: PostgreSQL

写USER.md的例子

# 用户档案

## 基本信息
- 姓名：张工
- 角色：后端开发工程师
- 技术栈：Python, FastAPI, PostgreSQL

## 沟通偏好
- 用中文
- 喜欢简洁的回答

七、定时任务（Cron）

通过聊天就能建定时任务：

用户：帮我每天早上9点整理昨天的Git提交记录

或者手写配置：

{
  "cron": [
    {
      "name": "daily-git-review",
      "schedule": "0 9 * * *",
      "sessionTarget": "isolated",
      "payload": {
        "message": "请执行：1.用git log拿昨天所有提交；2.按模块分类整理；3.生成变更摘要；4.发给我"
      },
      "delivery": {
        "channel": "telegram"
      },
      "timeout": 600
    }
  ]
}

参数说明：

schedule：Cron表达式，0 9 * * *就是每天9点
sessionTarget：推荐isolated，不受主对话干扰
payload.message：具体任务指令
delivery.channel：结果发到哪

Cron表达式速查

* * * * *
│ │ │ │ │
│ │ │ │ └─ 星期几 (0-7)
│ │ │ └─── 月份 (1-12)
│ │ └───── 日 (1-31)
│ └─────── 小时 (0-23)
└───────── 分钟 (0-59)

常用：

0 9 * * *：每天9点
0 9 * * 1-5：周一到周五9点
*/30 * * * *：每30分钟

八、心跳机制

心跳就是保安巡逻。系统每30分钟发一次心跳，Agent读HEARTBEAT.md看要不要干活。

HEARTBEAT.md例子

# 心跳任务清单

## 检查项
1. 检查有没有新邮件
2. 检查监控有没有告警
3. 整理今天的对话，存到MEMORY.md

## 执行规则
- 没事做就回HEARTBEAT_OK
- 有急事主动通知用户

九、技能系统

Skill是可复用的能力包。

# 查看已装技能
openclaw skills list

# 从市场安装
openclaw skills install <技能名>

常用内置技能：

浏览器控制：网页浏览、截图
Web搜索：实时搜信息
文件操作：读写文件
代码执行：沙箱里跑代码

十、实战场景

场景一：每日代码Review

每天早上自动Review代码变更，推团队群。

{
  "name": "daily-code-review",
  "schedule": "30 9 * * 1-5",
  "sessionTarget": "isolated",
  "payload": {
    "message": "对~/projects/my-app做Review：看昨日提交和变更，检查内存泄露、空指针、异常处理，输出结构化报告"
  },
  "delivery": {
    "channel": "slack",
    "target": "#code-review"
  }
}

场景二：个人知识库

用户：我刚读完这篇文章，帮我整理要点存知识库

AI自动把摘要存到memory/tech-notes/日期.md

场景三：服务器监控

在HEARTBEAT.md里写检查项：CPU、内存、磁盘、服务状态、错误日志。超过阈值就主动通知。

场景四：会议纪要

群里说/new开始记录，讨论完说/end-meeting，AI自动生成会议纪要和待办事项。

场景五：自动日报

{
  "name": "daily-work-report",
  "schedule": "0 18 * * 1-5",
  "payload": {
    "message": "生成今日日报：看今天的对话记录和Git提交，汇总完成的任务，列明日计划"
  }
}

十一、常用命令速查

# 安装与启动
openclaw onboard --install-daemon
openclaw gateway status
openclaw dashboard

# 渠道管理
openclaw channels add <渠道名>
openclaw channels list
openclaw channels remove <渠道名>

# 技能管理
openclaw skills list
openclaw skills install <技能名>

# 直接交互
openclaw agent --message "你好"
openclaw agent --message "..." --thinking high

# 配置
openclaw configure

聊天命令

命令	功能
/status	看Agent状态
/new	开始新对话
/think	切换深度思考模式

十二、几个建议

拆任务：别一下子说要做个完整网站，一步一步来
多轮改：不满意就提具体修改意见，别只说重写
用好记忆：认真维护MEMORY.md，记技术栈、常用路径、踩过的坑
三次就自动化：一件事手动做了三次以上，就该做成定时任务
让AI修自己：报错了直接贴错误信息让它分析

安全提醒

生产环境一定要把dmPolicy设成pair
群消息用sandbox.mode: non-main
定期看allowFrom白名单

快速上手清单

装Node.js 24
准备API密钥
装OpenClaw
运行openclaw onboard --install-daemon
看Gateway状态
开Dashboard发第一条消息
写SOUL.md
写USER.md
接一个消息渠道（先试Telegram）
建第一个定时任务
开始积累MEMORY.md

本文内容仅供个人学习、研究或参考使用，不构成任何形式的决策建议、专业指导或法律依据。未经授权，禁止任何单位或个人以商业售卖、虚假宣传、侵权传播等非学习研究目的使用本文内容。如需分享或转载，请保留原文来源信息，不得篡改、删减内容或侵犯相关权益。感谢您的理解与支持！

链接: https://shenqiku.cn/article/FLY_13711