拥有自己的 AI 助手不是梦。Linux/Mac/Windows 三平台详细步骤，避坑大全。
—
什么是 OpenClaw？
OpenClaw 是一个开源的 AI 助手框架，让你可以：
- • 🤖 拥有专属 AI 助手
- • 💬 连接微信/Telegram/Discord
- • 🧠 管理记忆和上下文
- • 🔌 扩展各种技能
- • 🌐 浏览器自动化
核心优势：
- • 开源免费
- • 支持多平台
- • 技能可扩展
- • 数据本地存储
—
环境要求
硬件要求
| 配置 | 最低 | 推荐 | |——|——|——| | CPU | 2 核 | 4 核 + | | 内存 | 2GB | 4GB+ | | 存储 | 5GB | 10GB+ | | 网络 | 稳定连接 | 稳定连接 |
软件要求
| 系统 | 版本要求 | |——|———-| | Node.js | v18+（推荐 v22） | | npm | v8+ | | 操作系统 | Linux/macOS/Windows |
—
快速安装
方法一：npm 安装（推荐）
`bash
# 全局安装 OpenClaw
npm install -g openclaw
# 验证安装
openclaw –version
`
方法二：源码安装
`bash
# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# 安装依赖 npm install
# 链接到全局
npm link
`
方法三：Docker 安装
`bash
# 拉取镜像
docker pull openclaw/openclaw:latest
# 运行容器
docker run -d \
-v ./workspace:/app/workspace \
-p 3000:3000 \
openclaw/openclaw
`
—
初始化配置
步骤 1：创建工作区
`bash
# 初始化工作区
openclaw init
# 默认创建在 ~/.openclaw/workspace
# 也可指定路径
openclaw init ~/my-ai-workspace
`
步骤 2：配置 AI 模型
编辑配置文件 ~/.openclaw/config.json：
`json
{
“model”: {
“provider”: “qwen”,
“apiKey”: “your-api-key”,
“model”: “qwen-plus”
},
“gateway”: {
“port”: 3000,
“host”: “localhost”
}
}
`
步骤 3：配置模型提供商
#### 通义千问（推荐中文用户）
`json
{
“provider”: “qwen”,
“apiKey”: “从 dashscope.aliyun.com 获取”,
“model”: “qwen-plus”
}
`
#### Claude
`json
{
“provider”: “anthropic”,
“apiKey”: “从 console.anthropic.com 获取”,
“model”: “claude-3-sonnet-20240229”
}
`
#### GPT-4
`json
{
“provider”: “openai”,
“apiKey”: “从 platform.openai.com 获取”,
“model”: “gpt-4-turbo”
}
`
#### 本地模型（Ollama）
`json
{
“provider”: “ollama”,
“baseUrl”: “http://localhost:11434”,
“model”: “qwen2.5:7b”
}
`
—
启动服务
启动 Gateway
`bash
# 启动服务
openclaw gateway start
# 查看状态 openclaw status
# 停止服务 openclaw gateway stop
# 重启服务
openclaw gateway restart
`
验证运行
`bash
# 检查端口
lsof -i :3000
# 或访问网页
open http://localhost:3000
`
—
连接通讯平台
企业微信（WeCom）
`bash
# 1. 创建企业微信应用
# 访问 https://work.weixin.qq.com
# 2. 获取配置信息
- • CorpID
- • AgentID
- • Secret
# 3. 配置到 OpenClaw
openclaw config wecom –corp-id XXX –agent-id XXX –secret XXX
`
Telegram
`bash
# 1. 联系 BotFather 创建 Bot
# 获取 Bot Token
# 2. 配置 openclaw config telegram –token YOUR_BOT_TOKEN
# 3. 启动 Bot
openclaw gateway start
`
Discord
`bash
# 1. 创建 Discord 应用
# 访问 https://discord.com/developers
# 2. 获取 Bot Token
# 3. 配置
openclaw config discord –token YOUR_BOT_TOKEN
`
`bash
# 1. 扫描 QR 码连接
openclaw connect whatsapp
# 2. 用手机 WhatsApp 扫描二维码
# 3. 连接成功后自动保存会话
`
—
安装技能
使用 skillhub（推荐）
`bash
# 搜索技能
skillhub search weather
# 安装技能 skillhub install weather
# 更新技能 skillhub update weather
# 列出已安装
skillhub list
`
常用技能推荐
| 技能 | 功能 | 命令 |
|——|——|——|
| weather | 天气查询 | skillhub install weather |
| browser | 浏览器自动化 | skillhub install browser |
| github | GitHub 操作 | skillhub install github |
| obsidian | 笔记管理 | skillhub install obsidian |
| summarize | 内容摘要 | skillhub install summarize |
手动安装技能
`bash
# 1. 下载技能包
git clone https://github.com/xxx/skill-xxx.git
# 2. 复制到技能目录 cp -r skill-xxx ~/.openclaw/skills/
# 3. 启用技能
openclaw skills enable xxx
`
—
记忆系统
记忆文件结构
`
~/.openclaw/workspace/
├── MEMORY.md # 长期记忆
├── SOUL.md # 人格设定
├── USER.md # 用户信息
├── TOOLS.md # 工具配置
├── IDENTITY.md # 身份定义
├── HEARTBEAT.md # 定期检查任务
└── memory/
├── 2026-03-13.md # 每日日志
├── 2026-03-14.md
└── …
`
记忆管理命令
`bash
# 查看记忆
openclaw memory show
# 搜索记忆 openclaw memory search “关键词”
# 导出记忆 openclaw memory export > backup.md
# 导入记忆
openclaw memory import backup.md
`
记忆最佳实践
1. 定期清理 — 删除过时信息 2. 分类整理 — 按主题组织 3. 备份保存 — 定期导出 4. 隐私保护 — 不存储敏感信息
—
高级功能
浏览器自动化
`bash
# 启动浏览器
openclaw browser start
# 打开网页 openclaw browser open https://example.com
# 截图 openclaw browser screenshot
# 执行脚本
openclaw browser eval “document.title”
`
子代理（Sub-agent）
`bash
# spawn 子任务
openclaw agent spawn “分析这份报告”
# 列出子代理 openclaw agent list
# 查看状态
openclaw agent status
# 终止任务
openclaw agent kill `
定时任务
`bash
# 添加 cron 任务
openclaw cron add “0 9 *” “检查邮件”
# 列出任务 openclaw cron list
# 删除任务
openclaw cron remove `
Heartbeat 定期检查
编辑 HEARTBEAT.md：
`markdown
# 每天早上 9 点检查
- • [ ] 查看未读邮件
- • [ ] 查看日历事件
- • [ ] 查看天气
- • [ ] 查看项目状态
`
—
常见问题
Q1: 安装失败怎么办？
`bash
# 清理 npm 缓存
npm cache clean –force
# 重新安装 npm install -g openclaw –force
# 检查 Node.js 版本
node –version # 需要 v18+
`
Q2: 如何更新？
`bash
# 更新到最新版
npm update -g openclaw
# 或指定版本
npm install -g openclaw@2026.3.8
`
Q3: 支持中文吗？
完全支持！推荐使用：
- • 通义千问（qwen）
- • Claude
- • 本地中文模型
Q4: 数据存在哪里？
`
~/.openclaw/workspace/ # 工作区
~/.openclaw/config.json # 配置文件
`
Q5: 如何备份？
`bash
# 备份整个工作区
tar -czf openclaw-backup.tar.gz ~/.openclaw/
# 恢复
tar -xzf openclaw-backup.tar.gz -C ~/
`
Q6: 端口冲突怎么办？
`bash
# 修改配置
openclaw config gateway –port 3001
# 或编辑 config.json
{
“gateway”: {
“port”: 3001
}
}
`
—
性能优化
内存优化
`json
{
“memory”: {
“maxContextLength”: 4096,
“maxHistoryMessages”: 50
}
}
`
响应速度优化
`json
{
“model”: {
“maxTokens”: 1024,
“temperature”: 0.7
}
}
`
并发优化
`json
{
“gateway”: {
“maxConcurrentSessions”: 10
}
}
`
—
安全建议
1. API Key 保护 – 不要提交到 Git – 使用环境变量 – 定期轮换
2. 访问控制 – 限制 IP 访问 – 启用认证 – 设置防火墙
3. 数据加密 – 敏感数据加密存储 – 使用 HTTPS – 定期备份
4. 日志审计 – 开启操作日志 – 定期检查异常 – 设置告警
—
参考资料
- • 官方文档：[docs.openclaw.ai](https://docs.openclaw.ai)
- • GitHub：[github.com/openclaw/openclaw](https://github.com/openclaw/openclaw)
- • 技能市场：[clawhub.com](https://clawhub.com)
- • Discord 社区：[discord.gg/clawd](https://discord.com/invite/clawd)
—
结语
OpenClaw 让你拥有完全可控的 AI 助手。
下一步： 1. 完成部署 2. 连接通讯平台 3. 安装常用技能 4. 开始使用！
—
💬 部署遇到问题？欢迎在评论区提问！
📚 推荐阅读：
- • [提示词工程的 5 个核心原则](#)
- • [搭建你的第一个自动化工作流](#)
—
本文首发于 [AI 创作网](https://a188.cn) 标签：#OpenClaw #AI 助手 #部署教程
