OpenClaw安装配置及简介OpenClaw安装配置及简介 1. OpenClaw安装介绍（Mac电脑） 1.1 ho

OpenClaw安装配置及简介

1. OpenClaw安装介绍（Mac电脑）

1.1 homebrew配置国内源

# 1. 替换 Homebrew 核心仓库 (brew git repo)
# 如果你在中国大陆，推荐使用清华源或中科大源
echo "==> 替换 Homebrew 核心仓库..."
git -C "$(brew --repo)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git

# 2. 替换 Homebrew Core 公式仓库 (homebrew/core)
echo "==> 替换 Homebrew Core 公式仓库..."
git -C "$(brew --repo homebrew/core)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git

# 3. 替换 Homebrew Cask 应用仓库 (homebrew/cask) - 如果安装了图形界面应用需要这个
echo "==> 替换 Homebrew Cask 仓库..."
git -C "$(brew --repo homebrew/cask)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-cask.git

# 4. 配置预编译二进制包 (Bottles) 下载源
# 这一步最关键，决定了下载软件包的速度
echo "==> 配置 Bottles 下载源..."
export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles

# 5. 将环境变量写入配置文件，使其永久生效
# 根据你的 Shell 类型选择 (macOS 默认是 zsh)
if [[ $SHELL == *"zsh"* ]]; then
  echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles' >> ~/.zprofile
  echo 'export HOMEBREW_API_DOMAIN=https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api' >> ~/.zprofile
  source ~/.zprofile
  echo "✅ 已写入 ~/.zprofile 并生效"
elif [[ $SHELL == *"bash"* ]]; then
  echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles' >> ~/.bash_profile
  echo 'export HOMEBREW_API_DOMAIN=https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api' >> ~/.bash_profile
  source ~/.bash_profile
  echo "✅ 已写入 ~/.bash_profile 并生效"
fi

echo "🎉 配置完成！请尝试运行 'brew update' 测试速度。"

1.2 安装node.js（版本>=22）

brew install node@22    # 请注意这个版本
echo 'export PATH="/usr/local/opt/node@22/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

1.3 npm安装目录权限问题

# 修改安装目录
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

# 查看 npm 全局前缀，应该显示你的家目录路径
npm config get prefix

# 尝试安装一个测试包（比如 cowsay），不应该报错
npm install -g cowsay

1.4 安装OpenClaw

1.4.1 curl命令安装

curl -fsSL https://openclaw.ai/install.sh | bash

1.4.2 从源码安装

以下是从源码安装并调试 OpenClaw 的完整流程：

---

## 第一步：先卸载全局安装版本

避免和源码版冲突：

```bash
npm rm -g openclaw
```

---

## 第二步：克隆源码

```bash
git clone https://github.com/openclaw/openclaw.git
cd openclaw
```

> 如果需要完整 git 历史（调试用），不要加 `--depth=1`。

---

## 第三步：安装依赖并构建

```bash
pnpm install
pnpm ui:build
pnpm build
```

---

## 第四步：链接到全局（让 `openclaw` 命令指向源码）

```bash
pnpm link --global
```

验证是否指向源码目录：

```bash
which openclaw
# 应该指向源码里的 bin，而不是 npm 全局目录
```

---

## 第五步：初始化（复用已有配置）

因为你已经装过，直接启动 gateway 即可，无需重新 onboard：

```bash
openclaw gateway start
```

如果想全新初始化：

```bash
openclaw onboard --install-daemon
```

---

## 调试技巧

**前台运行 Gateway（可以看到所有日志）：**
```bash
openclaw gateway start --foreground
```

**开启详细日志：**
```bash
OPENCLAW_LOG_LEVEL=debug openclaw gateway start --foreground
```

**实时跟踪日志：**
```bash
openclaw logs --follow
```

**检查配置是否正常：**
```bash
openclaw doctor
```

**修改源码后重新构建：**
```bash
pnpm build
openclaw gateway restart
```

---

## 不用 link 的轻量调试方式

也可以跳过 `pnpm link`，直接在仓库目录内用 `pnpm` 运行：

```bash
pnpm openclaw gateway start --foreground
pnpm openclaw doctor
```

这样改完代码 `pnpm build` 后立即生效，不影响全局环境。

1.5 大模型coding plan

minimax开放平台（选择CN模型）：platform.minimaxi.com/user-center…
阿里云百炼平台：bailian.console.aliyun.com/cn-beijing/…

1.6 配置模型api key

openclaw configure

1.7 打开web ui界面

http://127.0.0.1:18789/

1.8 代理配置

# 设置 HTTP/HTTPS 代理
export http_proxy=http://127.0.0.1:7897
export https_proxy=http://127.0.0.1:7897
export all_proxy=socks5://127.0.0.1:7897

# 取消代理
unset http_proxy https_proxy all_proxy

2.配置飞书连接教程

参考b站视频：www.bilibili.com/video/BV1kN…

实现文档：my.feishu.cn/wiki/RDopw0…

3. openclaw常用cli命令

🔧 初始化与配置

openclaw onboard          # 引导安装向导（推荐首次使用）
openclaw configure        # 交互式配置向导（模型、频道、技能）
openclaw config get <key> # 读取配置项
openclaw config set <key> <value>  # 写入配置项
openclaw config unset <key>       # 删除配置项
openclaw --version        # 查看版本号
openclaw tui   # 进入命令行交互窗口

🚪 Gateway 管理

openclaw gateway start    # 启动 Gateway
openclaw gateway stop     # 停止 Gateway
openclaw gateway restart  # 重启 Gateway（配置变更后使用）
openclaw gateway install  # 安装为系统服务（开机自启）
openclaw gateway uninstall # 卸载系统服务
openclaw gateway status   # 查看 Gateway 详细状态 
openclaw gateway health   # 快速健康检查
openclaw gateway probe    # 连接探测
openclaw gateway discover # 发现本地网络中的 Gateway

📊 诊断与调试

openclaw doctor           # 健康检查 + 自动修复建议
openclaw doctor --fix     # 自动修复问题
openclaw doctor --deep    # 深度扫描（含系统服务）
openclaw status           # 查看频道、会话、Gateway 综合状态
openclaw status --deep    # 发送实时探针检查每个频道
openclaw status --all     # 完整本地诊断
openclaw health           # 向 Gateway 请求完整健康快照
openclaw logs             # 查看日志（最近 500 行）
openclaw logs --follow    # 实时跟踪日志
openclaw logs --follow --local-time  # 实时日志（本地时间）
openclaw logs --json      # JSON 格式输出（可配合 jq 过滤）
openclaw security audit   # 安全审计

📡 频道管理

openclaw channels list    # 列出所有已配置的频道
openclaw channels status  # 检查所有频道健康状态
openclaw channels status --channel telegram  # 检查指定频道
openclaw channels add     # 添加新频道（向导模式）
openclaw channels remove  # 移除频道
openclaw channels login   # 频道登录/重新连接
openclaw channels logout  # 频道登出
openclaw channels logs    # 查看频道日志

🤖 模型管理

openclaw models list      # 列出可用模型
openclaw models status    # 查看模型状态
openclaw models set       # 设置默认模型
openclaw models scan      # 扫描发现可用模型
openclaw models aliases list|add|remove    # 管理模型别名
openclaw models fallbacks list|add|remove  # 管理备用模型
openclaw models auth add  # 添加模型认证
openclaw config set agents.defaults.model.primary "bailian/MiniMax-M2.5"   # 设置默认的模型

🧠 技能与插件

openclaw skills list      # 列出已安装的技能
openclaw skills info <名称>  # 查看技能详情
openclaw skills check     # 检查技能状态
openclaw skills list --eligible   # 查看已加载并确认可用的技能
openclaw plugins list     # 列出已加载的插件
openclaw plugins install <插件名>  # 安装插件
openclaw plugins enable <插件名>   # 启用插件
openclaw plugins disable <插件名>  # 禁用插件

🧩 其他实用命令

openclaw sessions         # 查看会话列表
openclaw sessions --active 120  # 查看最近 2 小时内活跃会话
openclaw memory status    # 查看记忆索引状态
openclaw memory search --query "关键词"  # 搜索记忆
openclaw cron list        # 列出定时任务
openclaw cron add         # 添加定时任务
openclaw cron status      # 查看定时任务状态
openclaw browser status   # 查看浏览器工具状态
openclaw browser open <url>  # 打开网页
openclaw update           # 更新 OpenClaw
openclaw dashboard        # 在浏览器中打开控制台

💡 小提示：任何命令后加 --help 可查看该命令的完整参数说明，例如 openclaw gateway --help。

文件权限配置

# 方式一：切换到 coding profile（包含完整文件读写权限）
openclaw config set tools.profile coding
openclaw gateway restart

# 方式二：用 tools.allow 明确指定工具组
openclaw config set tools.allow '["group:fs"]'
openclaw gateway restart

# 方式三：同时开启文件系统 + 命令执行（功能最完整）
openclaw config set tools.allow '["group:fs", "group:runtime"]'
openclaw gateway restart

clawhub常用命令

以下是 ClawHub 的常用命令速查表：

---

## 🔧 安装 CLI

```bash
npm i -g clawhub
# 或
pnpm add -g clawhub
```

---

## 🔐 认证

```bash
clawhub login                    # 浏览器登录（OAuth）
clawhub login --token <token>    # 用 API token 登录
clawhub logout                   # 退出登录
clawhub whoami                   # 查看当前登录用户
```

---

## 🔍 搜索技能

```bash
clawhub search "calendar"            # 自然语言搜索
clawhub search "web scraping" --limit 10  # 限制结果数量
```

---

## 📦 安装技能

```bash
clawhub install <skill-slug>                    # 安装最新版
clawhub install <skill-slug> --version 1.2.0   # 安装指定版本
clawhub install <skill-slug> --force            # 强制覆盖已有版本
```

---

## 🔄 更新技能

```bash
clawhub update <skill-slug>   # 更新指定技能
clawhub update --all          # 更新全部已安装技能
```

---

## 📋 管理已安装技能

```bash
clawhub list                  # 列出已安装技能
clawhub info <skill-slug>     # 查看技能详情
clawhub uninstall <skill-slug> # 卸载技能
```

---

## 📤 发布技能

```bash
clawhub publish <path>        # 发布技能到注册表
clawhub sync                  # 同步本地技能与注册表
```

---

## ⚙️ 全局选项

| 选项 | 说明 |
|------|------|
| `--workdir <dir>` | 指定工作目录 |
| `--dir <dir>` | 技能安装子目录（默认 `skills`） |
| `--no-input` | 非交互模式，禁用所有提示 |
| `--registry <url>` | 覆盖注册表 API 地址 |
| `-V` | 查看 CLI 版本 |

---

## 🌍 环境变量

| 变量 | 说明 |
|------|------|
| `CLAWHUB_WORKDIR` | 默认工作目录 |
| `CLAWHUB_REGISTRY` | 注册表 API 地址 |
| `CLAWHUB_SITE` | 网站地址 |
| `CLAWHUB_CONFIG_PATH` | CLI 配置文件路径 |

---

安装的技能会记录在工作目录的 `.clawhub/lock.json` 中。技能安装后，需要**重启 OpenClaw 会话**才能加载新技能。

4. 常见问题

4.1 删除配置的模型接口

你可以通过以下方式删除 OpenClaw 中配置的 MiniMax 模型：

方法一：用交互式配置向导

openclaw configure

选择模型/Model 相关选项，移除 MiniMax。

方法二：直接编辑配置文件

nano ~/.openclaw/openclaw.json

找到 models.providers.minimax 整个块，删除它。大致就是删掉这部分：

"minimax": {
    "baseUrl": "https://api.minimax.io/anthropic",
    "api": "anthropic-messages",
    "authHeader": true,
    "models": [
        {
            "id": "MiniMax-M2.5",
            ...
        }
    ]
}

同时检查 agents.defaults.model 部分，如果 primary 设的是 minimax/MiniMax-M2.5，也要改成其他模型。

保存后重启网关：

openclaw gateway restart

4.2 如何开启debug日志？

编辑配置文件：

nano ~/.openclaw/openclaw.json

添加或修改 logging 部分：

"logging": {
    "level": "debug",
    "consoleLevel": "debug"
}

然后重启网关，实时查看日志：

openclaw gateway restart
openclaw logs --follow

4.3 tavily-search 联网搜索配置

方式一：环境变量（推荐）

在终端中设置环境变量：

# 临时设置（当前会话有效）
export TAVILY_API_KEY="tvly-your-api-ke y-here"

# 永久设置（添加到 shell 配置文件）
echo 'export TAVILY_API_KEY="tvly-your-api-ke y-here"' >> ~/.zshrc
source ~/.zshrc

# ~/.openclaw/.env
export TAVILY_API_KEY="tvly-your-api-ke y-here"

获取 Tavily API Key

访问 tavily.com 注册账号
进入 Dashboard
生成 API Key（格式以 tvly- 开头）

免费套餐每月提供 1000 credits，基础搜索消耗 1 credit，高级搜索（--deep）消耗 2 credits，个人使用完全够用。

配置后重启生效

openclaw gateway restart

测试 tavily-search是否可用

export TAVILY_API_KEY=xxx
node ~/.openclaw/workspace/skills/tavily-search/scripts/search.mjs "hello world"

4.4 skill-vetter安装（安装skill之前的检查）

clawhub.ai/donovanpank…

4.5 openclaw核心模块

4.5.1 核心模块

1. CLI & 入口 (`src/cli/`, `src/index.ts`, `src/entry.ts`)

命令行界面，基于 Commander.js 构建，包含配置、网关、频道、代理、模型等子命令。

2. Gateway (`src/gateway/`)

核心控制平面和消息路由枢纽：

频道健康监控、消息路由、认证/限速、Canvas 能力协商

3. Agents (`src/agents/`)

多智能体编排：

ACP (Agent Capability Protocol) 协议
认证 profile、API Key 轮转、Anthropic 集成

4. Channels (`src/channels/`)

跨频道抽象层：

Session 管理、allowlist 路由、指令门控、消息格式化、thread 绑定

5. 内置频道实现

src/telegram/ — Telegram bot
src/discord/ — Discord
src/slack/ — Slack
src/signal/ — Signal
src/imessage/ — iMessage
src/web/ — WhatsApp Web

6. Commands (`src/commands/`)

高层命令实现：onboarding、配置向导、health check、session 管理、backup/reset

7. Config (`src/config/`)

配置加载与验证：Zod schema 驱动、legacy 迁移、env 变量注入

8. Plugins (`src/plugins/`)

插件系统：发现/加载/注册、Hook 机制（8+ 生命周期钩子）、工具集成

9. Media (`src/media/`)

媒体处理流水线：FFmpeg、图像处理、PDF 提取、MIME 检测

10. Memory & Context (`src/memory/`, `src/context-engine/`)

长期记忆 + RAG：OpenAI/Gemini/Voyage 向量嵌入后端，批处理架构

11. Infra (`src/infra/`)

系统级基础设施：mDNS 发现、设备配对、端口管理、错误处理

12. Browser & Node Host (`src/browser/`, `src/node-host/`)

无头浏览器自动化（CDP）+ Node.js 沙箱执行

4.5.2 扩展模块 (`extensions/` — 41 个包)

频道扩展：msteams, matrix, feishu, zalo, googlechat, twitch, irc 等 20+ 个
功能扩展：voice-call, memory-lancedb, llm-task, phone-control, diagnostics-otel 等
Auth 代理：copilot-proxy, google-gemini-cli-auth, qwen-portal-auth 等

4.5.3 应用层 (`apps/`)

平台	技术栈
macOS	Swift/SwiftUI，SPM，menubar 集成
iOS	Swift/SwiftUI，WatchApp，ShareExtension
Android	Kotlin/Jetpack Compose，Gradle

4.5.4 整体架构说明

Gateway 作为中心 daemon，统一路由各频道消息到 Agent 系统；Plugin Hook 体系提供高度可扩展性；Config/Zod schema 驱动所有运行时行为。

用户消息
  └─> 频道适配层 (Telegram / Discord / Slack / ...)
        └─> Gateway（路由 + 认证 + 健康监控）
              └─> Agent 系统（ACP 协议 + 多智能体调度）
                    ├─> LLM Provider（Anthropic / OpenAI / ...）
                    ├─> 插件 Hook（工具调用 / 记忆 / 媒体）
                    └─> Memory / Context Engine（RAG）

参考资料

openclaw官方文档：docs.openclaw.ai/zh-CN
openclaw github 地址：github.com/openclaw/op…
AI Agent基本概念及OpenClaw，15分钟给你讲清楚！ www.bilibili.com/video/BV1ZT…
openclaw连接飞书：www.bilibili.com/video/BV1kN…
openclaw 配置tavily-search：www.bilibili.com/video/BV1P7…
tavily-search 登录页面：app.tavily.com/home
skill.sh skills.sh/

OpenClaw安装配置及简介