🦞 OpenClaw 小白安装教程 2026
免费开源的 AI 私人管家 · 支持 Claude / GPT-5.4 / DeepSeek / Ollama 接入 Telegram / 飞书 / Discord 等平台 · 20 分钟完成部署
01 什么是 OpenClaw？
OpenClaw（外号"小龙虾🦞"，原名 ClawdBot / Moltbot）是一个装在我们自己电脑上的 AI 私人管家——帮我们管日历、浏览网页、整理文件、收发邮件、自动写代码并运行、批量处理数据、定时执行复杂任务、在终端里执行各种操作。
🚀 当前最新版 2026.3.8 · 新增数据备份、联网搜索升级、安全加固、支持 GPT-5.4 & Gemini 3.1
简单理解：AI 私人管家 = OpenClaw + 大模型。如果 OpenClaw 是这个管家的身体，大模型就是它的大脑，没有大脑它什么都干不了。这里的"大脑"就是 AI 大模型（比如 Claude、ChatGPT、DeepSeek）。我们需要自己去对应平台申请一个"通行密码"（官方叫 API Key），告诉 OpenClaw 用哪个 AI 当大脑，它才能运转起来。 支持以下主流 AI：
| AI | 说明 |
|---|---|
| 🟣 Anthropic Claude | Claude 3.7 / Sonnet 等，需申请通行密码 |
| 🟢 OpenAI GPT | GPT-5.4 / GPT-4o，最新版已支持 |
| 🔵 DeepSeek | 价格便宜，效果好 |
| 🟡 Google Gemini | Gemini 3.1 Flash-Lite 等 |
| 🟤 Ollama 本地 | 完全离线，隐私最高 |
| 🟠 阿里百炼 | Qwen 系列，国内直连 |
如果不想依赖线上服务，也可以用 Ollama 在自己电脑上本地运行大模型，完全离线。
接入后，我们可以通过以下任意平台与 AI 对话：Telegram、WhatsApp、Discord、飞书 / Lark、Slack、Signal、Microsoft Teams、iMessage。
⚠️ 重要提醒： 不能用 Claude 的普通会员账号直接登录，必须去各 AI 平台单独申请"通行密码"（API Key）才能使用。Claude 去 console.anthropic.com 申请，DeepSeek 去 platform.deepseek.com 申请，OpenAI 去 platform.openai.com 申请。
02 安装方式
🌟 一键脚本（官方推荐）
根据我们的系统，复制对应的命令粘贴到终端里回车，剩下的全自动完成（Node.js 和 Git 会自动安装），结束后自动跳出设置引导程序。
macOS / Linux（终端）：
curl -fsSL https://openclaw.ai/install.sh | bashWindows（PowerShell，以管理员身份运行）：
iwr -useb https://openclaw.ai/install.ps1 | iex💡 如需在安装前检查脚本内容，可直接在浏览器中打开对应链接查看：macOS/Linux 脚本 →
https://openclaw.ai/install.sh，Windows 脚本 →https://openclaw.ai/install.ps1。
命令跑完后会自动跳出设置引导，继续看第 3 步。
03 第一次启动：完成设置引导
安装完成后会自动弹出一个设置引导程序，一步步问我们问题，按提示选就行，整个过程约 10 分钟。
1. 选择快速启动（QuickStart）
第一屏选 QuickStart，自动帮我们把后台参数全配好，不用手动填任何东西。
2. 选择用哪个 AI + 填入通行密码
引导程序会列出所有支持的 AI，选一个，然后把之前申请的通行密码粘贴进去。各平台的通行密码格式类似下面这样：
# Claude 的通行密码长这样：
sk-ant-api03-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# OpenAI / DeepSeek / 阿里百炼 长这样：
sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx3. 选择聊天渠道 —— 以 Telegram 为例（推荐新手）
引导程序会问「想通过哪个平台和 AI 聊天？」，选 Telegram，然后按以下步骤获取 Bot Token：
- 在 Telegram 搜索
@BotFather并打开对话 - 发送
/newbot，按提示设置 Bot 名称和用户名（用户名必须以bot结尾，例如my_assistant_bot） - 复制返回的连接码（格式类似
7890123456:ABCdefGHIjklMNOpqrSTUvwxYZ），粘贴到引导程序中
4. 配置 Search provider（可跳过）
配置完机器人后，引导程序会询问 Search provider（搜索服务）。如果暂时没有对应的 API Key，直接选 Skip 跳过，后续随时可以补充配置（参见第 5 章）。
5. 安装技能和 hooks（可全部跳过）
接下来会依次提示安装技能（skills）和 hooks，这些都可以先选 Skip 跳过，安装完成后随时可以在第 5 章按需安装。
6. 选择聊天方式
引导程序最后会问我们想在哪里开始聊天：
- TUI：在当前终端窗口中直接对话
- Web UI：在浏览器中打开聊天界面（推荐选这个，界面更丰富，能看到更多内容）
选择 Web UI 后浏览器会自动打开，正常收到 AI 的回复说明 OpenClaw 运行正常 🎉
7. 完成 Telegram 机器人配对
回到 Telegram，找到我们之前创建的机器人，开始对话。如果机器人没有回复，发送 /start 触发首条消息。机器人会回复一条包含如下内容的消息：
Ask the bot owner to approve with:
openclaw pairing approve telegram XXXXXXX
将 openclaw pairing approve telegram XXXXXXX 这串指令复制，新开一个终端窗口，粘贴并回车，完成机器人与 OpenClaw 的配对。之后就可以通过 Telegram 机器人与 OpenClaw 正常聊天了，至此小龙虾就算安装好啦 🎉
04 开启完整功能
OpenClaw 提供多种功能模式，根据自己的需要切换，可以在网页上更改，也可以通过命令更改。下面是查看和修改当前模式的命令：
# 第一条：查看当前开了哪些功能
openclaw config get tools
# 第二条：切换到"全功能"模式
openclaw config set tools.profile full
# 第三条：重启让改动生效
openclaw gateway restart| 功能模式 | 能干什么 | 适合谁 |
|---|---|---|
messaging | 只能聊天 | 只需要聊天 |
default | 基础工具 | 一般用户 |
coding | 编程相关工具 | 开发者 |
full ✅ 推荐 | 文件、浏览器、命令等全部功能 | 大多数用户 |
all | 包含测试中的实验性功能 | 喜欢折腾的用户 |
05 给 AI 安装技能
给 AI 安装技能就像给手机装 App——装一个，AI 就多一个本事。
💡 强烈建议装完 OpenClaw 后第一件事就是安装 openclaw-tavily-search，让 AI 拥有实时联网搜索能力，否则 AI 只能依赖训练数据，无法获取最新信息。
第一步：安装 ClawHub（技能管理工具）
这是openclaw官方的技能市场，安装它可以通过命令快速下载相应的技能
npm install -g clawhub@latest
# 或者不安装直接用 npx 临时执行
npx clawhub@latest --version第二步：安装联网搜索技能 openclaw-tavily-search
AI 本身并不具备联网能力——它只能从训练数据中生成回答，无法获取实时信息（比如今天的股价、最新新闻、近期发生的事情）。装了这个技能，AI就能实时上网搜索了。Tavily账号可以免费注册，每月有 1000 次搜索额度，新手完全够用。我们可以直接对小龙虾说'帮我下载openclaw-tavily-search'这个技能，它就会帮忙我们安装好，之后按照提示去Tavily官网注册账号，将我们的 API Key（格式如下）告诉小龙虾：
tvly-dev-xxxxxxxxxxxxxxxx完事后可以说'帮我搜索一下大A今天有什么利好消息'看它是不是能回复。
推荐安装的技能 — 通用类
不想敲命令安装技能？我们也可以通过和小龙虾对话的方式直接说出我们想要安装什么技能，比如'帮我安装agent-browser技能'，它会自己安装好并且告诉我们一些注意事项。
| 技能 | 说明 | 安装命令 |
|---|---|---|
| 🌐 openclaw-tavily-search | 实时联网搜索 | clawhub install openclaw-tavily-search |
| 🔍 find-skills | 让 AI 帮我们搜索推荐合适的技能 | clawhub install find-skills |
| 🌐 agent-browser | 让 AI 自主浏览网页、提取内容 | clawhub install agent-browser |
| 🛡️ skill-vetting | 安装插件前自动安全检查 | clawhub install skill-vetting |
| 🔁 self-improving | 让 AI 根据反馈自动优化回复策略 | clawhub install self-improving |
| 📝 summarize | 一键总结长文、网页、文件 | clawhub install summarize |
| 🔄 auto-updater | 自动更新 OpenClaw 到最新版本 | clawhub install auto-updater |
| 🔍 multi-search-engine | 多搜索引擎聚合搜索 | clawhub install multi-search-engine |
推荐安装的技能 — 开发类
| 技能 | 说明 | 安装命令 |
|---|---|---|
| 🐙 github | 操作 GitHub Issues、PR，写 commit message（需配合 gh CLI 使用） | clawhub install github |
🛡️ ClawHub 曾出现过恶意技能（"ClawHavoc"事件），安装前建议先用
skill-vetting或clawhub inspect <slug>查看权限和代码，确认安全再装。
搜索 / 查看 / 卸载技能
# 搜索关键词匹配的技能
clawhub search "search"
# 查看某技能详情和权限
clawhub inspect openclaw-tavily-search
# 列出已安装的所有技能
clawhub list
# 卸载某技能
clawhub uninstall openclaw-tavily-search06 常用命令速查
| 命令 | 说明 |
|---|---|
openclaw status | 查看 OpenClaw 是否正在运行 |
openclaw gateway --force | 手动强制启动 OpenClaw |
openclaw gateway restart | 重启 OpenClaw |
openclaw logs --follow | 实时查看运行日志 |
openclaw doctor | 自动诊断配置问题 |
openclaw update | 升级到最新版本 |
openclaw daemon install | 安装开机自启守护进程 |
openclaw config set tools.profile full | 切换为完整功能模式 |
07 常见问题 FAQ
Q: AI 只能聊天，文件 / 命令功能不能用
默认 profile 是 messaging，按照第 4 章将 profile 切换为 full 即可。
Q: Claude OAuth 登录提示账号被封
Claude 的普通会员账号不能直接用，必须去 console.anthropic.com 单独申请开发者通行密码才行。
Q: 装了 openclaw-tavily-search 但搜索没有结果
大概率是通行密码没存进去。在终端执行 echo $TAVILY_API_KEY，如果没有输出任何内容，说明密码没存好，按第 5 章重新操作一遍，然后关掉终端重新打开再试。
Q: 如何完全卸载 OpenClaw
详见官方卸载文档，或直接执行：
openclaw uninstall
npm uninstall -g openclaw本教程根据网络公开资料整理 · 仅供学习参考 · 同步至 v2026.3.8 · 欢迎评论区留言