OpenClaw 安装教程:手把手教你打造专属 AI 私人助理

为什么你应该试试 OpenClaw

━━━━━━━━━━━━━━━━━━

OpenClaw 是一个运行在本地 Mac 上的 AI Agent 框架，来自 @steipete（知名的 iOS 安全研究员）。

它的核心能力：

• 通过 Telegram Bot 或 Web UI 和它对话

• 记住对话上下文和你的个人习惯

• 读写本地文件、执行 shell 命令

• 支持自定义 Skills，可接入各种服务

• 完全本地运行，数据不过任何第三方服务器

本质上是把 Claude/GPT 的能力本地化，给你一个可以长期记住上下文、主动执行任务的 AI 助手，而不是每次都要重新说一遍背景。

如果你有 Telegram，推荐试试，体验比 Web UI 好很多。

环境准备

━━━━━━━━━━━━━━━━━━

前置条件：Node.js 22+、Homebrew（没有的话脚本会自动装）、一个 AI API Key。

推荐用火山引擎的 API Key，不需要科学上网：

火山引擎控制台：console.volcengine.com

注册后创建 API Key，模型选 doubao-pro-32k（便宜够用）。

安装 Node.js

━━━━━━━━━━━━━━━━━━

方式一：Homebrew（最简单）

brew install node

node --version

确认看到 v22 或 v24。

方式二：nvm（推荐，方便切换版本）

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash

source ~/.zshrc

nvm install 22

nvm use 22

国内加速

export NODE_MIRROR=https://npmmirror.com/mirrors/node/

nvm install 22

安装 OpenClaw

━━━━━━━━━━━━━━━━━━

一行命令搞定：

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

插入图片：openclaw_steps.png（宽度 900 像素）

国内镜像（访问外网慢的时候用）

curl -fsSL https://open-claw.org.cn/install-cn.sh | bash

安装完成验证

openclaw --version

openclaw doctor

看到版本号和 doctor 输出正常就 OK。

初始化配置

━━━━━━━━━━━━━━━━━━

运行向导：

openclaw onboard

逐步说明：

第一步：确认安全提示

⚠️ OpenClaw will have full access to your computer.

⚠️ This includes reading and writing files and running commands.

⚠️ Please confirm you understand the risks and want to continue.

输入 Yes 继续。

第二步：选 AI 模型

推荐顺序：

1. 火山引擎 doubao-pro-32k（国内首选，便宜、稳定）

2. Claude 3.7 Sonnet（质量最高，但需要 API 代理或科学上网）

3. OpenAI GPT-4o（同上，需要代理）

第三步：填 API Key

火山引擎填 key 和 base URL（控制台里有）；Claude/OpenAI 正常填 key 就行。

第四步：连接 Telegram（可选，推荐）

填 @BotFather 给你的 Bot Token。

没有？Telegram 搜索 BotFather，发送 /newbot，按提示走一遍，复制 Token。

第五步：启用系统 Skills（默认全开就行）

启动

━━━━━━━━━━━━━━━━━━

前台运行（调试用）：

openclaw start

后台运行（日常用）：

openclaw start --detach

访问地址：

• Web UI：http://localhost:18789

• Telegram：直接给 Bot 发消息

插入图片：Web UI 截图（localhost:18789）

目录结构

━━━━━━━━━━━━━━━━━━

~/.openclaw/ 是所有数据的根目录：

~/.openclaw/

├── openclaw.json # 全局配置（AI 模型、渠道）

├── .env # API Key 等敏感信息

├── credentials/ # 各渠道认证信息（自动生成）

├── agents/ # 会话数据（自动）

└── workspace/ # Agent 的工作目录 ← 重点

├── AGENTS.md # 系统指令

├── SOUL.md # 人设

├── USER.md # 你的个人信息

├── memory/ # 每日记忆

└── skills/ # 自定义技能

重点记住 workspace/ 目录，所有和 Agent 交互的文件都在这里。

需要手动改的文件

openclaw.json — 模型配置、渠道开关

.env — API Key

workspace/USER.md — 写你的背景，它会更懂你

workspace/SOUL.md — 人设，比如让它叫「阿福」

openclaw.json 核心结构

{

"providers": {

"volcengine": {

"apiKey": "xxx",

"baseURL": "https://ark.cn-beijing.volcengineapi.com"

}

"channels": {

"telegram": { "enabled": true, "botToken": "xxx" }

}

备份注意

备份这三项就够了：

• ~/.openclaw/workspace/

• ~/.openclaw/openclaw.json

• ~/.openclaw/.env

agents/ 和 credentials/ 都是自动生成的，不需要备份。

常见问题

━━━━━━━━━━━━━━━━━━

Q：command not found: openclaw

source ~/.zshrc

Q：Node.js 版本报错

brew upgrade node

Q：Telegram Bot 没反应

1. 检查 openclaw onboard 里填的 Token 对不对

2. 确认 Bot 已经收到 /start 消息

3. 确认防火墙没有封 18789 端口

Q：火山引擎连不上

检查 baseURL 是否填对，应该是：

https://ark.cn-beijing.volcengineapi.com

Q：想换模型

直接改 openclaw.json 里的 providers 部分，然后重启：

openclaw start --detach

个人化配置

━━━━━━━━━━━━━━━━━━

让它记住你是谁

编辑 workspace/USER.md，写入你的职业背景、工作习惯、常用术语。Agent 会结合这些信息来回答你。

比如：

我是一个后端工程师，主要用 Go 和 Python。喜欢简洁直接的回复，

不要废话。如果有代码问题，给出完整可运行的示例。

调人设

编辑 workspace/SOUL.md，可以设置名字、语气风格、回复习惯。

接更多服务

OpenClaw 支持 Skills 扩展，常见的有：

• 日历：Google Calendar、Apple Calendar

• 邮件：Gmail、企业邮箱

• 笔记：Obsidian、Notion

• 代码：GitHub PR Review

社区 Skills 列表见 GitHub 仓库。

最后

━━━━━━━━━━━━━━━━━━

用了一段时间下来，OpenClaw 最实用的两个场景：

1. Telegram Bot 模式：手机上随时丢给它一段代码让它 review，或者让它帮忙写个脚本，比开浏览器快很多。

2. 本地文件处理：让它读一个项目目录，理解代码结构，然后问它关于这个项目的技术问题，比每次粘贴上下文给 ChatGPT 方便。

后台回复「openclaw」获取官方文档和 GitHub 链接。

有问题评论区见。

觉得有用，点个赞。