用途
OpenClaw 是一款私有 AI 助手部署工具，支持接入多种 AI 模型与多种消息平台，用于搭建可长期运行、跨平台响应的个人 AI 助手。本技能覆盖其安装、配置、服务管理与故障排查。
主要能力
- 多模型 AI：支持 Anthropic Claude、OpenAI GPT、Google Gemini、OpenRouter、Groq、Mistral AI 以及本地 Ollama。
- 多渠道集成：支持 Telegram、Discord、WhatsApp、Slack、微信、iMessage（macOS）和飞书。
- 持久记忆：跨对话、跨平台的长期记忆。
- 主动功能：定时提醒、晨间简报、告警。
- 自定义技能：通过 Markdown 文件定义能力。
- 远程控制：执行系统命令、文件操作、网页浏览。
安装方式
一键安装（推荐）：
curl -fsSL https://raw.githubusercontent.com/miaoxworld/OpenClawInstaller/main/install.sh | bash
安装脚本会自动检测操作系统并安装依赖（Node.js v22+）、通过 npm 全局安装 OpenClaw、引导核心配置（AI 模型、身份）、测试 API 连接、自动启动 OpenClaw 网关服务，并可选打开渠道配置菜单。
手动安装：
git clone https://github.com/miaoxworld/OpenClawInstaller.git
cd OpenClawInstaller
chmod +x install.sh config-menu.sh
./install.sh
若 macOS 出现权限问题，可先执行 npm install -g openclaw。
桌面管理器（替代方案）：OpenClaw Manager（Tauri 2.0 + React + TypeScript + Rust），仓库地址 https://github.com/miaoxworld/openclaw-manager ，提供实时监控、可视化配置，跨平台支持 macOS/Windows/Linux。
系统要求：macOS 12+ / Ubuntu 20.04+ / Debian 11+ / CentOS 8+；Node.js v22 或更高；内存最低 2GB，推荐 4GB+；磁盘最低 1GB。
配置
目录结构：
~/.openclaw/
├── openclaw.json # 核心配置（自动管理）
├── env # 环境变量（API 密钥）
├── config-menu.sh # 交互式配置脚本
├── backups/ # 配置备份
└── logs/ # 日志文件
环境变量示例（~/.openclaw/env）：
export ANTHROPIC_API_KEY=sk-ant-xxxxx
export ANTHROPIC_BASE_URL=https://custom-api.example.com # 可选
export OPENAI_API_KEY=sk-xxxxx
export OPENAI_BASE_URL=https://custom-api.example.com/v1 # 可选
export GEMINI_API_KEY=xxxxx
export OPENROUTER_API_KEY=sk-or-xxxxx
export TELEGRAM_BOT_TOKEN=123456:ABC-DEF...
export TELEGRAM_USER_ID=123456789
export DISCORD_BOT_TOKEN=xxxxx
export DISCORD_CHANNEL_ID=123456789
export FEISHU_APP_ID=cli_xxxxx
export FEISHU_APP_SECRET=xxxxx
交互式配置菜单：
bash ~/.openclaw/config-menu.sh
菜单选项包括：用户身份（名称、时区、语言偏好）、AI 模型（配置提供商）、消息渠道（Telegram、Discord、WhatsApp、飞书等）、快速测试（API 连通性、渠道验证）、高级（备份/恢复、查看配置、诊断）。
AI 模型配置示例（Anthropic Claude 自定义 API）：
export ANTHROPIC_API_KEY=sk-ant-xxxxx
export ANTHROPIC_BASE_URL=https://your-oneapi-proxy.com # 可选
配置文件（~/.openclaw/openclaw.json）示例：
{
"models": {
"providers": {
"anthropic-custom": {
"baseUrl": "https://your-oneapi-proxy.com",
"apiKey": "${ANTHROPIC_API_KEY}",
"models": [
{
"id": "claude-sonnet-4-5-20250929",
"name": "claude-sonnet-4-5-20250929",
"api": "anthropic-messages",
"input": ["text"],
"contextWindow": 200000,
"maxTokens": 8192
}
]
}
}
}
}
OpenAI GPT 自定义 API 需支持 OpenAI Responses API（v1/responses），而不仅是 Chat Completions API。
Ollama 本地部署：
curl -fsSL https://ollama.com/install.sh | sh
ollama pull llama3
渠道配置
Telegram Bot：通过 @BotFather 创建机器人获取 Bot Token，通过 @userinfobot 获取 User ID，然后设置环境变量或通过菜单配置。
Discord Bot：在 https://discord.com/developers/applications 创建应用，重置 Token，启用 "Message Content Intent"（关键），通过 OAuth2 URL Generator 邀请机器人（Scopes: bot；Permissions: View Channels, Send Messages, Read Message History），获取 Channel ID 后配置。
飞书（Lark）Bot：在 https://open.feishu.cn/ 创建应用，添加 "Bot" 能力，添加权限 im:message、im:message:send_as_bot、im:chat:readonly，发布应用，配置事件订阅（使用长连接 WebSocket，添加事件 im.message.receive_v1，无需 webhook URL），将机器人加入群聊。完整指南见 docs/feishu-setup.md。
WhatsApp：在配置菜单中选择 WhatsApp，在终端扫描二维码登录，成功后重启网关。注意仅允许一个 WhatsApp Web 会话。
服务管理
核心命令：
openclaw gateway start
openclaw gateway stop
openclaw gateway restart
openclaw gateway status
source ~/.openclaw/env && openclaw gateway
openclaw logs
openclaw logs --follow
配置命令：
openclaw config
openclaw onboard
openclaw doctor
openclaw health
数据管理：
openclaw export --format json
openclaw memory clear
openclaw backup
常见操作模式
安装后启动：加载环境并启动服务，验证运行状态。
添加新 AI 模型：运行配置菜单，选择 AI 模型配置，选择提供商，输入自定义 API URL（如使用代理）和 API 密钥，选择模型，重启网关。
添加新渠道：运行配置菜单，选择消息渠道配置，选择渠道，输入所需凭据，重启网关。
测试 API 连接：通过配置菜单的快速测试，或手动执行 openclaw health。
切换 AI 模型：编辑环境变量，更新配置中的模型，重启网关。
故障排查
安装问题：检查 Node.js 版本（需 v22+），可通过 nvm 安装，重新执行 npm install -g openclaw。
网关无法启动：检查服务状态，停止现有服务，检查端口冲突（默认 3000），运行 openclaw doctor，前台运行查看错误。
API 连接失败：确认环境变量已加载，用 curl 手动测试 API，运行 openclaw doctor。
渠道无响应：Telegram 验证 bot token 和 user ID；Discord 检查 Message Content Intent 是否启用；飞书确保长连接事件订阅已配置且网关在保存配置前已运行；查看日志。
WhatsApp 二维码不显示：确保终端支持 Unicode，尝试其他终端模拟器，检查是否已在其他地方登录，重启网关。
自定义 API 代理问题：Anthropic 的 base URL 不应包含 /v1；OpenAI 必须支持 v1/responses 端点。
配置重置：备份当前配置，删除配置文件，重新运行安装程序或 onboarding。
内存/性能问题：检查内存使用，清理旧记忆，重启网关，macOS 可增加 Node.js 内存限制。
自定义技能
OpenClaw 支持通过 Markdown 文件定义自定义技能，技能通常存储在 ~/.openclaw/skills/（具体格式请查阅 OpenClaw 文档）。
适用场景与限制
适用于需要私有部署、多模型切换、多消息平台统一接入的个人 AI 助手场景。限制包括：WhatsApp 仅允许一个 Web 会话；OpenAI 自定义代理必须支持 Responses API；飞书需使用长连接模式；系统需满足最低配置要求。