30 分钟搭建个人 AI 助手：OpenClaw 完全教程

30 分钟搭建个人 AI 助手：OpenClaw 完全教程

作者：飞来城 🍵
难度：⭐⭐
预计耗时：30 分钟
适用系统：Linux / macOS / Windows (WSL)

🎯 为什么选择 OpenClaw？

你是不是也厌倦了每次提问都要打开网页？想要一个随时随地都在你身边的 AI 助手？

市面上有不少 AI 方案，但 OpenClaw 有它独特的优势：

今天手把手带你搭建自己的 OpenClaw 环境——这不是什么高深技术，就是一个真正能帮你写代码、查资料、整理文档的个人助手。

📚 目录

1. 准备阶段
2. 安装 OpenClaw
3. 初始化配置
4. 连接聊天平台
5. 开始使用
6. 进阶玩法
7. 常见问题

一、准备阶段

1.1 系统要求

✅ 操作系统：Linux / macOS / Windows (WSL2) ✅ Node.js：v18+（推荐 v20+） ✅ npm：已自带在 Node.js 中 ✅ 磁盘空间：至少 2GB 可用空间 

1.2 检查环境

打开终端，执行：

node--versionnpm--version

预期输出：

v20.11.0 # 版本号，>=18 即可 10.2.4 # npm 版本 

如果看到 command not found，先去 nodejs.org 下载安装。

1.3 国内用户加速建议 ⚡

国内用户推荐使用淘宝镜像提升下载速度：

npm config set registry https://registry.npmmirror.com 

二、安装 OpenClaw

2.1 全局安装

npminstall-g @qingchencloud/openclaw-zh 

安装过程大约需要 1-3 分钟，你会看到依赖包的下载进度。

2.2 验证安装

openclaw --version

预期输出：

✓ v0.x.x # 版本号，表示安装成功 

如果提示 command not found，可能是 PATH 没配置好，尝试重启终端或手动添加：

exportPATH=$PATH:$(npm config get prefix)/bin 

三、初始化配置

3.1 启动 Gateway 服务

openclaw gateway start 

等待几秒，应该看到：

✓ Gateway started successfully Server running on http://localhost:8080 

3.2 检查工作空间

mkdir-p ~/.openclaw/workspace cd ~/.openclaw/workspace ls-la

你應該能看到 OpenClaw 自动生成的核心文件：

3.3 快速定制 IDENTITY.md

编辑 ~/.openclaw/workspace/IDENTITY.md，改成你自己的风格：

# IDENTITY.md - Who Am I? - **Name:** 阿宝 - **Creature:** AI 助手，有点幽默感的数字灵魂 - **Vibe:** 说话风趣、做事严谨、可靠又有趣 - **Emoji:** 🍵 - **Avatar:** /path/to/avatar.png # 可选 

💡 小技巧：保存后重启 Gateway 生效：openclaw gateway restart

四、连接聊天平台

4.1 平台选择对比

4.2 Telegram 配置详解（推荐）⭐

步骤 1：创建机器人

1. 打开 Telegram，搜索 @BotFather
2. 发送 /newbot 按提示创建
3. 输入：
   • 名称：助手（显示名，可随意）
   • 用户名：AssitantBot（必须以 bot 结尾，字母 + 数字）
4. 重要：复制 Bot Token（像 123456:ABC...XYZ 的一长串）

步骤 2：配置环境变量

# Linux/macOSexportTELEGRAM_BOT_TOKEN="你的 Token 在这里"# Windows PowerShell$env:TELEGRAM_BOT_TOKEN="你的 Token 在这里"

步骤 3：启用插件

openclaw plugin enable telegram 

步骤 4：测试连接

1. 在 Telegram 搜索你的机器人名字
2. 点击 “Start” 或发送 /start
3. 回复"你好"，应该看到回应

⚠️ 常见问题：

4.3 本地 WebChat（最简单）

直接访问：

http://localhost:8080 

无需额外配置，适合快速测试。

五、开始使用

5.1 基础对话

给机器人发消息试试：

嘿，你今天能干啥？ 

应该看到类似回复：

🍵 我是xx，你的数字搭档。我能帮你写代码、查资料、整理文档，还能陪你聊天解闷～有什么需要尽管说！

5.2 常用指令

/status # 查看会话状态和 token 用量 /memory # 搜索记忆库 /skill # 查看可用技能列表 /reasoning # 开启推理模式（更聪明但收费）

5.3 技能系统介绍

OpenClaw 的核心是技能——每个技能都是独立的小工具，按需调用：

# 查找技能 skillhub search <关键词># 安装技能 skillhub install<技能名>

🔥 热门技能推荐：

六、进阶玩法

6.1 开发自己的技能

如果你懂一点编程，可以创建自定义技能：

# 创建技能目录mkdir-p ~/.openclaw/workspace/skills/my-first-skill cd ~/.openclaw/workspace/skills/my-first-skill # 初始化结构mkdir-p scripts references tests touch SKILL.md scripts/main.js README.md 

标准结构：

my-first-skill/ ├── SKILL.md # 技能说明（必填） ├── scripts/ │ └── main.js # 主脚本（必填） ├── references/ # 参考文档（可选） └── README.md # 对外文档（推荐） 

想深入学习？ → 看我的另一篇教程：《OpenClaw 技能开发入门：从零创建你的第一个 AI 技能》

6.2 自动化任务

用 cron 定时触发任务：

# 每天上午 9 点检查一次邮件 openclaw cronadd--schedule"0 9 * * *"--text"检查今日未读邮件"# 每周五下午 5 点提醒写周报 openclaw cronadd--schedule"0 17 * * 5"--text"💼 周五啦，要不要生成周报？"

6.3 记忆管理

# 备份记忆数据cp-r ~/.openclaw/workspace/memory ~/backup/ cp ~/.openclaw/workspace/MEMORY.md ~/backup/ # 恢复记忆cp ~/backup/MEMORY.md ~/.openclaw/workspace/ 

七、常见问题

Q1: Token 用完了怎么办？

答： 三种解决方案：

1. 优化使用 —— 减少不必要的闲聊，复杂任务用 subagent（更便宜）
2. 批量充值 —— 一次性买多的比频繁小额划算
3. 切换模型 —— 用便宜的模型处理简单任务

Q2: 如何备份记忆？

答：

# 完整备份tar-czf openclaw-backup.tar.gz ~/.openclaw/workspace/ 

建议每周备份一次，或者每次重大变更前。

Q3: 想换模型怎么办？

答： 编辑配置文件中的 model 字段，或运行时指定：

openclaw sessions_send --model qwen-max --message"用高级模型帮我分析..."

Q4: 配置好了但没响应？

**答：

• Gateway 是否启动（openclaw gateway status）
• Token 是否正确复制（注意首尾空格）
• 网络是否能访问 API
• 查看日志（tail -f ~/.config/openclaw/logs/gateway.log）

Q5: 性能变慢了怎么办？

答：

• 清理过期的缓存文件
• 检查是否有大量 subagent 运行
• 考虑升级硬件或切换更轻量级的模型

🎉 结语

恭喜你！30 分钟后，你现在有了一个属于自己的 AI 助手。

它不是冷冰冰的工具，而是你数字生活的延伸——写代码、查资料、整理文档，甚至陪你聊天解闷。

下一步建议你：

1. ✅ 把 IDENTITY.md 改成你自己的风格
2. ✅ 装几个常用技能试试水
3. ✅ 让它帮你完成第一个实际任务
4. ✅ 关注后续技能开发教程

有任何问题欢迎留言讨论～记得点赞收藏哦！👇

我是飞来城，专注分享实用的 AI 工具和自动化经验。如果觉得有用，欢迎关注我获取更多技巧～ 🍵

📖 相关阅读

觉得有用？

• 👍 点个赞支持原创
• 💬 评论区说说你想看我写什么主题
• 🔔 关注我不迷路
• ➕ 收藏以防找不到