一、前置说明
目标人群
无开发背景
刚接触终端
希望把 AI 变成“自动执行代理”的用户
本教程完成后你将具备：
完整的 OpenClaw 本地运行环境
正确的 API 接入方式
Telegram 报警推送
基础 Skills 与 Hooks 配置
成本控制与日志排错能力
二、硬件与系统准备
1. 基础连接
接通电源
连接显示器
连接键盘与鼠标
首次启动完成 macOS 初始化
2. 更新系统（必须）
进入：
系统设置 → 通用 → 软件更新
升级到最新稳定版本 macOS。
未更新系统可能导致 Homebrew 或 Node 安装异常。
三、开发环境搭建
1. 打开终端
路径：
访达 → 应用程序 → 实用工具 → 终端
后续所有操作均在终端执行。
2. 安装 Homebrew
Homebrew 是 macOS 的包管理器，用于安装 Node 等依赖。
执行：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
安装完成后验证：
brew -v
若提示找不到 brew，执行：
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"
3. 安装 Node.js（建议 LTS）
brew install node
检查版本：
node -v
npm -v
建议 Node ≥ 18。
四、安装 OpenClaw
npm install -g openclaw
验证安装：
openclaw --version
若出现权限报错：
sudo npm install -g openclaw
五、模型接入逻辑（关键理解）
OpenClaw 不是调用 ChatGPT 网页版。
它调用的是 API。
Plus 会员 ≠ API Key
必须单独创建 API Key。
获取 OpenAI API Key
- 登录 https://platform.openai.com
- 进入 API Keys
- 创建新 Key
- 绑定支付方式
保存 Key。
六、初始化 OpenClaw
执行：
openclaw onboard
进入配置向导。
1. 选择模型
推荐选择 OpenAI。
原因：
稳定性高
API 成熟
社区支持广
填写 API Key。
七、Telegram 报警配置
用于接收执行状态通知。
1. 创建 Bot
在 Telegram 搜索：
@BotFather
发送：
/newbot
设置：
机器人名称
username（必须以 bot 结尾）
获得格式如下的 Token：
123456789:AAEJxxxxxxxxxxxxxxxx
2. 获取 chat_id
- 给你的机器人发送一条消息
- 打开浏览器访问：
https://api.telegram.org/bot你的token/getUpdates
在返回 JSON 中找到：
"chat": {
"id": xxxxxxxxx
}
该数字即为 chat_id。
将：
token
chat_id
填入 OpenClaw。
八、Skills 选择建议
使用空格键选择。
建议启用：
apple-notes
apple-reminders
github
imsg
model-usage
obsidian
summarize
说明：
model-usage：监控 Token 消耗
summarize：文本处理核心能力
github：自动代码操作
九、Hooks 建议启用
command-logger
session-memory
作用：
记录行为日志
跨会话记忆上下文
十、测试运行
进入界面：
openclaw tui
测试指令示例：
总结一段文本
创建任务
查看模型使用情况
确认执行链路完整。
十一、日志与排错
查看日志：
openclaw logs
常见问题：
- API 报 401 → Key 错误
- 429 → 超出配额
- 网络错误 → 检查代理
十二、升级与维护
升级：
npm update -g openclaw
卸载：
npm uninstall -g openclaw
十三、成本控制策略
OpenAI API 按 Token 计费。
建议：
设置用量上限
启用 model-usage
避免无限循环任务
OpenClaw 是执行代理系统，不是聊天工具。
若没有任务目标，只会产生无意义消耗。
十四、进阶方向
完成部署后，可探索：
自动日报生成
GitHub 自动提交
Obsidian 知识管理联动
* Telegram 监控通知系统
一、前置说明
目标人群 无开发背景 刚接触终端 希望把 AI 变成“自动执行代理”的用户 本教程完成后你将具备： 完整的 OpenClaw 本地运行环境 正确的 API 接入方式 Telegram 报警推送 基础 Skills 与 Hooks 配置 成本控制与日志排错能力二、硬件与系统准备
1. 基础连接
接通电源 连接显示器 连接键盘与鼠标 首次启动完成 macOS 初始化2. 更新系统（必须）
进入：
系统设置 → 通用 → 软件更新
升级到最新稳定版本 macOS。
未更新系统可能导致 Homebrew 或 Node 安装异常。
三、开发环境搭建
1. 打开终端
路径：
访达 → 应用程序 → 实用工具 → 终端
后续所有操作均在终端执行。
2. 安装 Homebrew
Homebrew 是 macOS 的包管理器，用于安装 Node 等依赖。
执行：
安装完成后验证：
若提示找不到 brew，执行：
3. 安装 Node.js（建议 LTS）
检查版本：
建议 Node ≥ 18。
四、安装 OpenClaw
验证安装：
若出现权限报错：
五、模型接入逻辑（关键理解）
OpenClaw 不是调用 ChatGPT 网页版。
它调用的是 API。
Plus 会员 ≠ API Key必须单独创建 API Key。
获取 OpenAI API Key
保存 Key。
六、初始化 OpenClaw
执行：
进入配置向导。
1. 选择模型
推荐选择 OpenAI。
原因：
稳定性高 API 成熟 社区支持广填写 API Key。
七、Telegram 报警配置
用于接收执行状态通知。
1. 创建 Bot
在 Telegram 搜索：
@BotFather
发送：
设置：
机器人名称 username（必须以 bot 结尾）获得格式如下的 Token：
2. 获取 chat_id
在返回 JSON 中找到：
该数字即为 chat_id。
将：
token chat_id填入 OpenClaw。
八、Skills 选择建议
使用空格键选择。
建议启用：
apple-notes apple-reminders github imsg model-usage obsidian summarize说明：
model-usage：监控 Token 消耗 summarize：文本处理核心能力 github：自动代码操作九、Hooks 建议启用
command-logger session-memory作用：
记录行为日志 跨会话记忆上下文十、测试运行
进入界面：
测试指令示例：
总结一段文本 创建任务 查看模型使用情况确认执行链路完整。
十一、日志与排错
查看日志：
常见问题：
十二、升级与维护
升级：
卸载：
十三、成本控制策略
OpenAI API 按 Token 计费。
建议：
设置用量上限 启用 model-usage 避免无限循环任务OpenClaw 是执行代理系统，不是聊天工具。
若没有任务目标，只会产生无意义消耗。
十四、进阶方向
完成部署后，可探索：
自动日报生成 GitHub 自动提交 Obsidian 知识管理联动* Telegram 监控通知系统