openclaw

关注公众号 jb51net

关闭
AI > openclaw >

OpenClaw安装及正确用法总结指南

熊猫钓鱼>_>

一、什么是OpenClaw？

OpenClaw是一款开源、自托管的AI智能体平台，前身为Clawdbot、Moltbot。它的核心特点是**"真正能干活"**，而不是单纯的聊天机器人。与传统AI助手相比，OpenClaw具备：

二、核心架构与工作原理

三层架构

  1. Gateway网关：核心协调层，通过WebSocket协议（默认ws://127.0.0.1:18789）连接聊天工具和电脑系统

  2. PiAgent运行时：大脑决策层，对接GPT、Claude等大模型，将自然语言指令拆解为操作步骤

  3. 执行层：包含文件操作、浏览器控制、Shell命令执行等工具，在Docker沙箱中运行

混合记忆系统

三、正确安装步骤

系统要求

推荐安装方式（一键脚本）

1# macOS/Linux用户
2curl -fsSL https://openclaw.ai/install.sh | bash
3
4# Windows用户（PowerShell）
5iwr -useb https://openclaw.ai/install.ps1 | iex

初始化配置

1# 运行配置向导并安装后台服务
2openclaw onboard --install-daemon

向导步骤：

  1. 选择本地或远程Gateway

  2. 配置AI模型认证（推荐Anthropic API Key）

  3. 选择聊天平台（如WhatsApp、Telegram）

  4. 安装守护进程（macOS: launchd, Linux/WSL2: systemd）

四、核心配置要点

1. AI模型配置（必须）

推荐模型：

配置文件位置：~/.openclaw/openclaw.json

1{
2  "env": { "ANTHROPIC_API_KEY": "sk-ant-..." },
3  "agents": { 
4    "defaults": { 
5      "model": { "primary": "anthropic/claude-opus-4-5" } 
6    } 
7  }
8}

2. Gateway网关配置

默认设置：

常用命令：

1# 检查服务状态
2openclaw gateway status
3
4# 手动启动网关
5openclaw gateway --port 18789 --verbose
6
7# 查看实时日志
8openclaw logs --follow

3. 聊天平台连接

WhatsApp配置

1# 登录WhatsApp（生成二维码）
2openclaw channels login whatsapp
3
4# 扫描二维码：WhatsApp → 设置 → 已连接设备

飞书配置（国内推荐）

  1. 访问飞书开放平台创建企业自建应用

  2. 获取App ID和App Secret

  3. 安装飞书插件：

1openclaw plugins install @m1heng-clawd/feishu
2openclaw config set channels.feishu.appId "你的AppID"
3openclaw config set channels.feishu.appSecret "你的AppSecret"

钉钉配置（Stream模式）

  1. 钉钉开放平台创建应用，开启Stream模式

  2. 获取Client ID（AppKey）和Client Secret

  3. 配置OpenClaw凭据

五、安全最佳实践

1. 部署环境隔离

绝对不要在主力电脑上部署OpenClaw！推荐以下安全环境：

环境适用场景优点
虚拟机（Lima/Orbstack）个人尝鲜完全隔离，免费
云服务器（阿里云/腾讯云）生产环境7x24在线，安全隔离
Docker容器开发测试轻量级，易于管理

2. 权限控制

1{
2  "fileSystem": {
3    "allowedPaths": ["/home/user/documents"],
4    "blockedPaths": ["/etc", "/var", "/root"]
5  },
6  "agents": {
7    "defaults": {
8      "sandbox": { "mode": "non-main" }
9    }
10  }
11}

3. 成本控制策略

OpenClaw的token消耗是按量计费，需特别注意：

高消耗原因：

成本控制方法：

  1. 定期使用/new命令：开始新对话，重置token累积

  2. 选择合适模型：简单任务用轻量模型（如Haiku）

  3. 监控使用量：定期运行/usage cost查看费用

  4. 设置预算提醒：在API平台设置费用上限

六、实用命令大全

1. 基础管理命令

1# 查看整体状态
2openclaw status
3
4# 检查网关健康状态
5openclaw health
6
7# 运行深度安全审计
8openclaw security audit --deep

2. 聊天中斜杠命令

命令功能使用场景
/new新开对话切换任务、节省token
/status查看会话状态监控当前会话
/model <模型名>切换模型根据任务复杂度选择
/compact压缩上下文长对话时节省token
/usage full查看完整用量成本监控
/exec host=sandbox设置执行环境安全执行命令
/approve <id> allow-once批准操作安全权限管理

3. 技能管理

1# 列出可用技能
2openclaw skills list
3
4# 安装技能（如网络搜索）
5openclaw skills install web-search
6
7# 启用技能
8openclaw skills enable github
9
10# 更新所有技能
11openclaw skills update all

七、实用场景与指令示例

1. 办公自动化

1"请帮我：
21. 提取桌面『销售数据.xlsx』中A列的客户名称和C列的成交金额
32. 筛选出金额大于1万的记录
43. 生成新的Excel文件保存到『重要客户』文件夹"

2. 邮件处理

1"请检查我的收件箱，整理出：
21. 未读的重要邮件（来自老板或重要客户）
32. 需要回复的邮件列表
43. 本周收到的Newsletter摘要"

3. 文档处理

1"从~/Downloads/report.pdf中提取：
21. 关键数据指标
32. 主要发现
43. 建议措施
5生成一份不超过500字的摘要"

4. 定时任务

1"每天早上8点帮我：
21. 检查GitHub热点
32. 生成中文简报
43. 通过WhatsApp发送给我"

5. 浏览器自动化

1"请去MIT公开课官网：
21. 搜索Python课程
32. 下载课件到桌面
43. 解压文件
54. 将第一节课的课件发给我"

八、常见问题解决

1. 服务连接问题

症状：控制界面连接超时 解决：

  1. 重新生成Token：cat ~/.clawdbot/clawdbot.json | grep tok

  2. 检查18789端口是否放行

  3. 重启服务：openclaw gateway restart

2. 模型调用失败

症状：百炼模型调用无响应 解决：

  1. 检查API Key有效性

  2. 开通对应模型调用权限

  3. 调整请求频率，避免速率限制

3. 平台对接故障

症状：钉钉/飞书消息推送失败 解决：

  1. 确认回调地址格式正确

  2. 检查App ID/App Secret配置

  3. 开启事件订阅功能

4. 性能优化

症状：服务运行卡顿 解决：

  1. 升级实例规格（至少4核8GB）

  2. 定期清理缓存目录

  3. 启用断点续执行功能

九、进阶功能

1. 多代理设置

1# 为不同场景创建独立代理
2openclaw agents add work
3openclaw agents add personal
4
5# 切换代理
6openclaw agents switch work

2. 本地模型部署

1# 使用llama.cpp运行本地模型
2git clone https://github.com/ggerganov/llama.cpp.git
3cd llama.cpp
4make -j$(nproc) llama-cli llama-server
5
6# 配置OpenClaw使用本地模型
7{
8  "models": {
9    "providers": {
10      "local-llama": {
11        "baseUrl": "http://localhost:8080/v1",
12        "apiKey": "sk-no-key-required"
13      }
14    }
15  }
16}

3. 技能开发

十、重要提醒

1. 成本意识

2. 安全第一

3. 合理期望

十一、学习资源

官方资源

社区支持

最后建议：将OpenClaw视为实验平台或自动化脚本构建器，而不是稳定可靠的日常助手。从安全隔离的环境开始，掌握基础功能后再逐步探索高级应用。务必做好成本监控和数据备份，确保在安全可控的前提下享受AI自动化带来的便利。

到此这篇关于OpenClaw安装及正确用法总结指南的文章就介绍到这了,更多相关OpenClaw安装及用法内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多支持脚本之家！