houhuan/openclaw-home-pc

Fork 0

huan 8dd73a1d62 OpenClaw 完整备份 - 2026-03-21

2026-03-21 15:31:06 +08:00

5.4 KiB

Raw Blame History

5 分钟搭建你的专属 AI 助手：OpenClaw 超详细安装指南

🦐 一只住在你的服务器里，随时待命的数字小龙虾

先说说 OpenClaw 是啥

想象一下：你有一个 AI 助手，7×24 小时在线，可以通过微信、Telegram、Discord 随时找到它。它不是云端服务，而是跑在你自己的服务器上，数据完全掌控在自己手里。

这就是 OpenClaw —— 一个自托管的多通道 AI 网关。

它能做什么？

📱 微信消息秒回：把 WhatsApp/企业微信接入 AI
💬 多平台统一：Telegram、Discord、iMessage 全部打通
🤖 AI 编码助手：连接 Pi 等 AI Agent，帮你写代码、查问题
🔒 数据私有：所有对话记录都在自己服务器上
📸 媒体支持：发图片、语音、文件都能处理

为什么要自托管？

云端 AI 服务	OpenClaw 自托管
对话数据存在别人服务器	数据完全自己掌控
每月订阅费用不菲	只需付 API 调用费
功能受限于平台政策	想怎么改就怎么改
断网就歇菜	可以本地部署离线能力

开始安装（超简单）

系统要求

✅ macOS、Linux 或 Windows（推荐 WSL2）
✅ 能上网（需要下载依赖）
✅ 一个 AI 服务商的 API Key（比如阿里云百炼、OpenAI 等）

Node.js？ 不用管！安装脚本会自动帮你装好 Node 22+。

方法一：一键安装脚本（强烈推荐⭐）

这是最简单的方式，一条命令搞定所有：

macOS / Linux / WSL2

打开终端，复制粘贴：

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

然后按提示操作就行，脚本会：

检测并安装 Node.js 22+
安装 OpenClaw
启动配置向导

Windows（PowerShell）

右键点击 PowerShell，选择「以管理员身份运行」：

iwr -useb https://openclaw.ai/install.ps1 | iex

方法二：npm 安装（适合老手）

如果你已经装了 Node 22+，可以直接用 npm：

npm install -g openclaw@latest
openclaw onboard --install-daemon

💡 遇到 sharp 报错？加上这个环境变量：
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

方法三：Docker 部署（适合服务器）

想用 Docker？官方有完整镜像：

docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  openclaw/openclaw:latest

详细文档：https://docs.openclaw.ai/install/docker

安装后的配置向导

安装完成后，会自动启动 openclaw onboard 向导。跟着提示走：

1️⃣ 选择 AI 服务商

支持的服务商：

阿里云百炼（通义千问）
OpenAI（GPT-4）
Anthropic（Claude）
智谱 AI
Moonshot（月之暗面）
以及其他 OpenAI 兼容接口

推荐国内用户：阿里云百炼或 Moonshot，速度快、价格低。

2️⃣ 输入 API Key

去对应的服务商官网申请 API Key，粘贴进去。

3️⃣ 选择聊天通道

想用什么聊天？

✅ WhatsApp（需要手机号接收验证码）
✅ Telegram（需要 Bot Token）
✅ Discord（需要 Bot Token）
✅ 企业微信（需要 Webhook）

新手推荐：Telegram 最简单，5 分钟搞定。

4️⃣ 安装后台服务

向导会问你是否安装为系统服务（开机自启），选是就对了。

验证安装

打开终端，运行：

# 检查状态
openclaw status

# 打开网页控制台
openclaw dashboard

# 诊断问题
openclaw doctor

如果一切正常，你会看到：

✓ Gateway is running
✓ Channels configured
✓ All systems operational

常见问题

❓ `openclaw` 命令找不到

这是 PATH 问题，运行：

export PATH="$(npm prefix -g)/bin:$PATH"

然后把这个加到你的 ~/.bashrc 或 ~/.zshrc 里。

❓ 安装时卡住不动

可能是网络问题，试试：

换个网络环境
使用国内镜像源
检查防火墙设置

❓ WhatsApp 扫码失败

WhatsApp 需要稳定的国际网络，建议：

使用 Telegram 替代
或者配置好代理后再试

❓ 服务启动失败

查看日志：

openclaw gateway logs

常见问题：

端口被占用 → 换个端口 --port 18790
配置文件错误 → openclaw doctor 检查

下一步做什么？

安装完成后，你可以：

打开网页控制台：http://127.0.0.1:18789
配置更多通道：openclaw channels login
自定义 AI 行为：编辑 ~/.openclaw/workspace/SOUL.md
添加定时任务：比如每天推送天气、新闻
开发自己的技能：参考官方文档写插件

资源链接

📚 官方文档：https://docs.openclaw.ai
💬 Discord 社区：https://discord.com/invite/clawd
🐙 GitHub 源码：https://github.com/openclaw/openclaw
🔧 技能市场：https://clawhub.com

结语

OpenClaw 最大的魅力在于完全掌控：

你的数据，你做主
你的 AI，你定制
你的服务，你运维

花 5 分钟安装，收获一个 24 小时待命的专属 AI 助手。这笔买卖，值！

🦐 皮皮虾提示：安装过程中遇到任何问题，欢迎在评论区留言，我会尽力解答～

觉得有用？点赞 + 在看，让更多小伙伴用上私有 AI 助手！ 🚀

5.4 KiB Raw Blame History Unescape Escape