OpenClaw 核心认知
OpenClaw（曾用名 ClawdBot、Moltbot）是一个本地优先、开源免费的 AI 智能体框架。它主打从'聊天'到'执行'的跨越，支持在本地或云端私有化部署，能够直接操作文件、浏览器和终端，并轻松接入飞书、钉钉、微信等渠道，实现 7×24 小时自动化任务执行。
核心特性
- 本地存储：通过 SOUL.md（人格配置）、SKILL.md（技能配置）及本地文件记忆，确保数据留存本地，降低泄露风险。
- 模型无关：兼容 GPT、Claude、通义千问、DeepSeek、Ollama 等主流大模型，本地或云端模型均可接入。
- 多渠道接入：支持 Web 控制台、Telegram、飞书、钉钉、企业微信、微信等，随时随地操控 AI 智能体。
- 技能化扩展：内置大量社区技能，覆盖办公自动化、代码开发、服务器运维、日常生活等全场景。
环境准备
本教程适配 Windows、macOS、Ubuntu 全平台。新手优先选择一键部署，30 秒即可上手；进阶用户可查看核心配置文件进行自定义优化。
- 硬件要求：最低 8GB 内存 +2 核 CPU（推荐 16GB+4 核），磁盘空间≥40GB。
- 系统要求：Windows 10 及以上、macOS 12 及以上、Ubuntu 22.04 及以上。
- 依赖项：Node.js 22+、Git、curl（一键脚本会自动安装，无需手动操作）。
- 必备资源：大模型 API Key（通义千问/OpenAI/Claude 任选其一）。
国内加速配置（解决网络卡顿问题）：
npm config set registry https://registry.npmmirror.com/
快速部署
官方提供一键安装脚本，自动配置环境、安装依赖、初始化服务。复制以下命令到终端执行即可：
curl -fsSL https://openclaw.ai/install.sh | bash
安装完成后，验证是否成功（终端输入以下命令）：
openclaw --version
若输出版本号（如 v2.6.0），则说明安装成功。
初始化配置
执行以下命令，启动配置向导，自动生成守护进程，支持开机自启：
openclaw onboard --install-daemon
向导关键步骤建议：
- 安全警告：输入 Yes（同意安全协议）。
- 安装模式：选择 QuickStart（快速启动模式，默认端口 18789，适合新手）。
- 模型提供商：选择你的 API Key 对应厂商（无 API Key 则选 Skip，后续再配置）。
- 消息渠道：选择 Skip for now（先只用 Web 控制台，后续再添加飞书/钉钉等渠道）。
- 技能配置：选择 No（后续按需安装技能，避免初始加载过慢）。
- Hooks 配置：选择 Skip for now（进阶功能，新手无需配置）。
配置完成后，终端会输出带 Token 的 Web 控制台链接，直接复制链接到浏览器打开即可进入可视化控制台。
核心配置文件详解
OpenClaw 的核心配置文件路径为 ~/.openclaw/openclaw.json（JSON5 格式，支持热重载，修改后无需重启服务即可生效）。
最小可用配置示例：
{
"gateway": {
"port": 18789
},
"agents": {
"defaults": {
"workspace": "~/.openclaw/workspace",
"model": {
"primary": "bailian/qwen3.5-plus",
"fallbacks": ["openai/gpt-4o"]
}
}
},
"channels": {
"web": {
"enabled": true
}
}
}
关键配置项解读：
- 模型配置：支持多模型故障转移，国内用户优先选 bailian（阿里云百炼），无需科学上网；国外用户可选 openai 系列。
- 渠道配置：若需接入飞书/钉钉，需在配置文件中添加 AppID+AppSecret；Telegram 需填写 Bot Token。
- 安全配置：添加
dmPolicy: allowlist，可设置仅允许指定用户访问，提升安全性。 - 热重载：修改配置文件后，无需重启 Gateway，系统会自动加载新配置。
服务管理
适合服务器部署或需要长期使用的用户，实现后台常驻和开机自启。
手动启动 Gateway（临时使用）：
openclaw gateway --port 18789
Systemd 服务配置（服务器推荐，Ubuntu 系统）：
- 创建启动脚本
openclaw-gateway.sh，赋予执行权限（chmod +x openclaw-gateway.sh）。 - 配置 Systemd 服务文件（路径：
/etc/systemd/system/openclaw-gateway.service），设置开机自启。 - 常用命令：
sudo systemctl start openclaw-gateway
sudo systemctl restart openclaw-gateway
sudo systemctl status openclaw-gateway
sudo systemctl enable openclaw-gateway
常见问题排查
- command not found: openclaw：将 npm 全局路径加入系统 PATH，重启终端即可。
- Gateway 未启动：手动执行
openclaw gateway，查看终端报错信息。 - 模型调用失败：检查 API Key 是否正确、BaseURL 是否配置（国内模型需配置国内 BaseURL）、模型名称是否匹配。
- 外部无法访问 Web 控制台：将 Gateway 绑定模式改为 lan，配置端口转发，开放对应端口（如 18789）。
生态开源项目汇总
官方核心项目
- OpenClaw 主项目：GitHub 地址 https://github.com/openclaw/openclaw。AI 智能体网关，支持多模型、多渠道接入，所有用户必装。
- ClawHub：GitHub 地址 https://github.com/openclaw/clawhub。官方技能市场，收录 5400+ 社区技能，可直接搜索、安装、管理。
- OpenClaw Skills：GitHub 地址 https://github.com/openclaw/skills。官方技能库，覆盖文件管理、浏览器自动化、代码开发等基础技能。
一键部署工具
- OpenClawInstaller：GitHub 地址 https://github.com/miaoxworld/OpenClawInstaller。国内优化版一键部署工具，可视化菜单配置，小白也能轻松部署。
- OneClaw：GitHub 地址 https://github.com/oneclaw/oneclaw。桌面版一键安装包，Windows/macOS 系统双击即可安装。
技能扩展库
- Awesome OpenClaw Skills：GitHub 地址 https://github.com/VoltAgent/awesome-openclaw-skills。第三方技能汇总，按办公、运维、开发、生活等类别整理。
- Clawra：GitHub 地址 https://github.com/SumeLabs/clawra。数字人格插件，支持情感交互、自拍生成，让 AI 更具人格化。
国内渠道接入
- 飞书连接器：GitHub 地址 https://github.com/m1heng/clawdbot-feishu。实现飞书机器人接入，支持文件/图片处理、定时任务触发。
- 钉钉连接器：GitHub 地址 https://github.com/DingTalk-Real-AI/dingtalk-moltbot-connector。接入钉钉群聊/私聊，适配企业办公场景。
- 企业微信接入：GitHub 地址 https://github.com/BytePioneer-AI/moltbot-china。整合飞书、钉钉、企业微信三大国内渠道。
- 微信接入：GitHub 地址 https://github.com/MaoTouHU/openclaw-wechat。通过 iPad 协议接入微信，建议使用小号测试规避风险。
增强工具
- memU：GitHub 地址 https://github.com/NevaMind-AI/memU。长期记忆组件，结构化存储对话记录、用户行为、偏好设置。
- Awesome Claw：GitHub 地址 https://github.com/qhkm/awesome-claw。资源大全，汇总各类教程、插件、实战案例、配置模板。
部署推荐方案
根据不同用户场景，推荐最优部署方案：
- 个人新手：一键脚本部署 + Web 控制台 + Awesome OpenClaw Skills（零代码，快速上手）。
- 办公用户：飞书/钉钉接入 + 办公类技能 + 定时任务（提升办公效率）。
- 开发者：源码部署 + 自定义技能开发 + 多模型切换（灵活拓展）。
- 企业用户：云端 Docker 部署 + 沙箱安全配置 + 多智能体隔离（稳定可靠）。
OpenClaw 凭借本地部署、数据安全、技能丰富、国内适配完善的核心优势，成为个人提升效率、企业落地自动化的优选方案。本文覆盖了从零到一的配置全流程以及全生态开源项目汇总，新手可直接复制部署命令，开发者可快速拓展能力。
