什么是OpenClawOpenClaw是一个开源、本地部署的AI 智能体网关它让你可以在自己的电脑或服务器上运行一个智能助手通过聊天平台随时使用这个助手来完成任务。它的目标不是像普通聊天机器人那样只回答问题而是能真正执行动作例如访问本地文件、自动化任务或联动应用等这些都是通过统一的 Gateway 网关实现的。OpenClaw 原名 Clawdbot因 Anthropic 商标顾虑在 2026年1月27日更名为 Moltbot过渡名最终在1月30日确定为 OpenClaw。三个名字本质是同一个项目功能完全一致。核心能力和特点OpenClaw 的设计强调实用性和扩展性它包含一些核心能力本地部署与隐私控制在用户自己的机器上运行你的数据不用上传到第三方服务器。多平台接入支持通过各种消息平台如 Telegram、Discord、企业微信、飞书、QQ 等和智能体互动。技能扩展系统通过“Skills技能”系统来扩展能力例如文件管理、知识管理、自动化操作等。工作原理由 Gateway 驱动Gateway 是核心组件它负责消息路由、会话管理和不同平台的连接。OpenClaw安装为了获得最佳体验我们推荐操作系统Mac强烈推荐原生支持最完善可操作日历、备忘录、截图等系统功能Windows完全可用但部分系统集成功能受限Linux适合开发者配置灵活Mac本地部署推荐最佳体验如果你有Mac电脑强烈推荐本地部署体验最好、功能最全系统要求硬件要求CPUM系列芯片或Intel i5以上内存8GB以上推荐16GB硬盘10GB以上空闲空间系统版本macOS 12 Monterey 或更高版本推荐 macOS 14 Sonoma 或 macOS 15 Sequoia前置软件Node.js 22.0.0会自动安装Homebrew可选用于安装依赖安装步骤第一步打开终端按Command 空格打开 Spotlight输入Terminal或终端按回车打开终端第二步安装 OpenClaw在终端中执行以下命令curl -fsSL https://openclaw.ai/install.sh | bash安装过程会自动检测系统环境安装Node.js如果未安装下载OpenClaw配置环境变量预计时间2-5分钟第三步验证安装安装完成后执行以下命令验证openclaw --version如果显示版本号如2026.2.9说明安装成功第四步初始化配置运行配置向导openclaw onboard配置流程1. 接受风险提示选择Yes继续2. 选择启动模式推荐选择QuickStart快速启动3. 选择AI模型选择你的AI供应商支持国内外主流模型4. 输入API Key根据选择的模型输入对应的API Key5. 选择聊天工具如果要接入飞书/Telegram选择对应选项如果暂时不接入选择None后续可配置6. Gateway端口设置默认18789即可7. 选择Skills使用空格键选择你需要的技能也可以直接跳过8. API Key配置没有的可以选择no跳过9. 启用Hooks推荐启用这三个钩子用于内容引导、日志和会话记录10. 完成配置配置完成后会自动启动Gateway服务并打开Web UIhttp://127.0.0.1:18789/chat第五步验证安装# 检查Gateway状态 openclaw channels status # 应该显示 # Gateway reachable.Windows本地部署Windows用户完全可用但部分系统集成功能受限。系统要求硬件要求CPU2核以上内存4GB以上推荐8GB硬盘10GB以上空闲空间操作系统Windows 10 或 Windows 11前置软件Node.js 22.0.0PowerShell原生部署第一步安装Node.js 22方法一官网下载安装访问 nodejs.org/zh-cn下载Windows安装包LTS版本22.x运行安装程序勾选「自动安装必要的工具」第二步验证Node.js安装# 打开PowerShell node -v npm -v第三步以管理员身份安装 OpenClaw重要必须以管理员身份运行PowerShell。# 安装最新稳定版 npm install -g openclawlatest # 或安装汉化版 npm install -g qingchencloud/openclaw-zhlatest第四步解决安装权限问题如果遇到权限错误# 方法A启用PowerShell脚本执行 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser # 方法B修改npm安装目录 npm config set prefix C:\npm npm config set cache C:\npm-cache # 将目录添加到PATH [Environment]::SetEnvironmentVariable(Path, $env:Path ;C:\npm, User)第五步验证安装version openclaw --help第六步解决常见问题问题sharp模块加载失败# 清理npm缓存 npm cache clean --force # 重新安装 npm install -g openclawlatest --force问题Windows Defender阻止将OpenClaw安装目录添加到Windows Defender排除项C:\Users\你的用户名\AppData\Roaming\npm C:\Users\你的用户名\.openclaw初始化配置安装完成后需要运行初始化向导。启动初始化向导openclaw onboard --install-daemonLinux本地部署Linux用户适合开发者配置灵活。系统要求推荐发行版Ubuntu 20.04Debian 11CentOS 8安装步骤第一步安装Node.js# Ubuntu/Debian curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt-get install -y nodejs # 验证安装 node --version第二步安装 OpenClawcurl -fsSL https://openclaw.ai/install.sh | bash第三步验证安装openclaw --version第四步初始化配置openclaw onboardOpenClaw配置神马中转APIOpenClaw 的配置文件位置通常如下系统文件路径示例Windows:C:Users用户名.openclawopenclaw.jsonmacOS:~/.openclaw/openclaw.jsonLinux:~/.openclaw/openclaw.json需要手动编辑配置文件~/.openclaw/openclaw.json指定baseUrlAPI服务地址apiKey认证密钥apiAPI协议类型如openai-chat、anthropic-messagesmodels模型列表和参数配置神马中转API代理如果你使用API代理服务配置如下{ models: { mode: merge, providers: { whataicc: { baseUrl: https://api.whatai.cc/v1, apiKey: sk-or-v1-你的密钥, auth: api-key, api: openai-chat, models: [ { id: anthropic/claude-sonnet-4-6, name: claude-sonnet-4-6, contextWindow: 200000, maxTokens: 8192 }, { id: openai/gpt-4, name: GPT-4, contextWindow: 128000, maxTokens: 4096 } ] } } }, agents: { defaults: { model: { primary: whataicc/anthropic/claude-sonnet-4-6 } } } }配置参数说明参数说明示例baseUrlAPI服务地址https://api.whatai.ccapiKeyAPI 密钥sk-xxxauth认证方式api-key或bearerapiAPI协议openai-chat、anthropic-messagesid模型IDdeepseek-chatname显示名称DeepSeek ChatcontextWindow上下文窗口64000maxTokens最大输出4096常见API协议类型openai-chatOpenAI兼容接口最常用anthropic-messagesAnthropic Claude接口google-generative-aiGoogle Gemini接口配置后重启服务# 方式1重启Gateway openclaw gateway restart # 方式2停止后重新启动 systemctl --user stop openclaw-gateway.service systemctl --user start openclaw-gateway.service # 方式3完全重启 systemctl --user restart openclaw-gateway.service验证配置# 查看当前配置的模型 openclaw models list # 测试模型连接 openclaw models test whataicc/anthropic/claude-sonnet-4-6常见问题及解决方案问题1找不到配置文件排查步骤:检查配置文件是否存在ls -la ~/.openclaw/openclaw.json ls -la ~/.openclaw/agents/*/openclaw.json运行 doctor 命令openclaw doctor手动创建配置文件mkdir -p ~/.openclaw echo {} ~/.openclaw/openclaw.json问题2多个 Agent 配置混乱解决方案:查看所有 Agentopenclaw agents list查看每个 Agent 的配置openclaw config get --agent main-assistant openclaw config get --agent tech-dev统一管理使用全局配置 Agent 覆盖或者每个 Agent 完全独立配置问题3Node.js版本不对# 检查版本 node --version # 如果低于22升级 nvm install 22 nvm use 22问题4 权限错误# macOS/Linux sudo chown -R $USER ~/.openclaw # Windows # 以管理员身份运行PowerShell问题5API配置问题API Key无效检查是否完整复制包括sk-前缀检查是否有多余空格检查账户余额是否充足模型不可用检查模型ID是否正确检查API服务是否正常尝试切换其他模型Token消耗太快使用更便宜的模型优化提示词定期清理会话历史问题6Gateway问题Q1: Gateway无法启动# 查看日志 tail -f ~/.openclaw/logs/gateway.log # 重启Gateway openclaw gateway restartQ2: 端口被占用# 查看端口占用 lsof -i :18789 # 修改端口 openclaw config set gateway.port 18790