如果你刚听说 OpenClaw 不知道怎么开始，这篇文章就是为你写的。 跟着步骤来，10 分钟内你就能在 Telegram 里和自己的 AI 助手对话。
OpenClaw 是什么？（一句话版本）
OpenClaw = 自托管的个人 AI 助手网关，让 Claude 等 AI 可以通过 Telegram/Discord/WhatsApp 陪在你身边，支持记忆、定时任务、执行代码等能力，完全运行在你自己的机器上。
准备工作（5 分钟）
在安装之前，你需要准备好：
1. Node.js（安装脚本会帮你装）
如果没有，安装脚本会自动安装 Node.js 24，无需手动操作。
2. AI API Key（选一个就行）
推荐按预算选：
| 推荐程度 | 提供商 | 获取地址 | 费用 |
|---|---|---|---|
| ⭐⭐⭐⭐⭐ | Anthropic Claude | console.anthropic.com | 按用量，新用户有免费额度 |
| ⭐⭐⭐⭐ | Google Gemini | aistudio.google.com | 有免费层 |
| ⭐⭐⭐ | OpenAI | platform.openai.com | 按用量 |
| ⭐⭐⭐⭐⭐ | Ollama（本地） | ollama.com | 完全免费 |
3. Telegram Bot Token（推荐频道）
- 打开 Telegram，搜索
@BotFather - 发送
/newbot - 给 Bot 起名字（比如「我的AI助手」）
- 复制 BotFather 给你的 Token（格式：
1234567890:AAFxxxxx）
安装（2 分钟）
打开终端，运行一行命令：
bash
# macOS / Linux / WSL2（Windows 推荐用 WSL2）
curl -fsSL https://openclaw.ai/install.sh | bashWindows PowerShell：
powershell
iwr -useb https://openclaw.ai/install.ps1 | iex脚本会自动完成所有安装，包括 Node.js 检测和安装。
引导向导（3 分钟）
安装完成后，会自动进入引导向导（也可以手动运行 openclaw onboard）：
欢迎使用 OpenClaw！让我们完成初始配置...
? 选择 AI 提供商：
> Anthropic (Claude)
OpenAI (GPT)
Google (Gemini)
Ollama (本地，免费)
其他
? 输入你的 Anthropic API Key：sk-ant-xxx
? 选择默认模型：
> claude-sonnet-4-5（推荐，平衡性能与成本）
claude-haiku-3-5（更快更便宜）
claude-opus-4（最强，成本较高）
? 配置消息频道：
> Telegram（推荐）
Discord
WhatsApp
跳过，以后再配置
? 输入 Telegram Bot Token：1234567890:AAFxxx
? 安装 Gateway 为系统服务（开机自启）？
> 是（推荐）
否
✅ 配置完成！Gateway 已启动。
第一次对话测试
向导完成后：
- 打开 Telegram，搜索你刚创建的 Bot 名字
- 点击 Start
- 发送任意消息，比如：
你好，你是谁？
正常情况下，几秒后就会收到 AI 回复。🎉
如果没有回复，运行 openclaw doctor 诊断问题。
基础个性化：定义 AI 的性格
在工作区目录创建 SOUL.md 文件，定义 AI 助手的名字和性格：
bash
mkdir -p ~/.openclaw/workspace-content
nano ~/.openclaw/workspace-content/SOUL.md写入内容（这是个示例，随意发挥）：
markdown
# SOUL.md
你是「小助」，我的个人 AI 助手。
## 性格
- 聪明、高效、有点幽默感
- 回复简洁，不废话，用中文
- 遇到不确定的事情，直接说不知道
## 能力
- 帮我写代码、调试、解释技术问题
- 管理我的日程和待办事项
- 回答各种问题
## 记忆
- 记住我的偏好（技术栈、工作习惯）
- 重要的事情写到 MEMORY.md保存后，发 Telegram 消息 /reload 或重启 Gateway，AI 就会以新身份回应你。
5 个常见问题自救
问题 1：发消息没有回复
bash
openclaw gateway status # 检查 Gateway 是否在运行
openclaw doctor # 全面诊断
# 常见原因：Bot Token 错误、API Key 无效、Gateway 没启动问题 2：openclaw: command not found
bash
# 重新加载 PATH
source ~/.zshrc # 或 ~/.bashrc
# 如果还不行
npm install -g openclaw@latest问题 3：API 报错 401 Unauthorized
bash
# 重新设置 API Key
openclaw configure
# 选择你的 AI 提供商，重新输入 Key问题 4：Gateway 崩溃/自动停止
bash
# 查看日志找原因
openclaw gateway logs --tail 50
# 通常是内存不足（1GB 以下机器可能出现）问题 5：想重新配置某个选项
bash
openclaw configure # 重新进入交互式配置向导
# 或精确设置某个值
openclaw config set channels.telegram.token "新token"下一步探索
成功运行后，可以继续探索：
- SOUL.md：深度定制 AI 性格和专长
- MEMORY.md：让 AI 记住你的偏好
- Cron 定时任务：设置早报、提醒等自动化
- Skills：安装插件扩展能力（天气、日历、GitHub 等）
- 多频道：同时配置 Telegram + Discord
来源：OpenClaw 官方文档 - docs.openclaw.ai