macos 部署 openclaw

河码匠2026-03-12 8:12

一、安装 node

node官方

1. 安装 node 虚拟环境
复制代码 
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
2. 配置 nvm

命令行中可以直接使用 nvm。不配置需要进入到 ~/.nvm 目录执行

复制代码 
# 将下面三行放入 .zshrc 中命令行可以直接使用 nvm 命令。
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # 这行加载 nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion" # 命令补全
3. nvm 相关操作
复制代码 
# 查看远程可安装的 node 版本
nvm ls-remote 

# 安装指定版本 node
nvm install v24.12.0

# 使用指定版本
nvm use v24.12.0

# 查看本地已安装版本
nvm ls

二、安装 openclaw

openclaw 官方

1. 使用 npm 安装 openclaw
复制代码 
npm install -g openclaw@latest
2. 初始化 openclaw
复制代码 
openclaw onboard --install-daemon
  • 这里选 yes
  • 然后选 QuickStart
  • 这里选择模型，我选择的 OpenAI
  • 这里填写 key 或者使用 open Codex。
    我使用的是 Codex
  • 这里会在游览器自动打开一个 openai 的登录页面，登录就行。
  • 然后选择模型版本。这里我要用 0011.ai 代理就选默认了。代理稍后在配置中配置。
  • 然后选择使用的聊天选件。我本地用就不选这个了。skip for now 跳过
  • 然后安装 skills。这个可以后面在安装。
  • 然后是安装 hooks，这里面有几个选项
选项 作用 解释
boot-md 启动时运行 BOOT.md 当 Gateway 启动且内部钩子启用时，此钩子会执行工作区根目录下的 BOOT.md 文件里的指令。 适合放一些启动时需要自动执行的任务 。比如，在 BOOT.md 里写上发送一条"我上线了"的消息，或者初始化某个服务的指令。
bootstrap-extra-files 注入额外的启动文件 在 Agent 启动流程 (agent:bootstrap 事件) 中，这个钩子可以将你额外指定的文件注入到 Agent 的工作区上下文中。 适合让每次对话都自动加载一些特定文件 。比如一些固定的参考文档、代码片段等，不用每次手动/load。
command-logger 记录所有指令日志 它会监听所有的命令事件，并将记录保存到 ~/.openclaw/logs/commands.log 文件中。 相当于一个操作记录员。开启后，在 OpenClaw 里执行过的所有命令都会被记录下来，方便日后排查问题或审计。
session-memory 保存会话记忆 当你执行 /new 命令开始一个新会话时，它会自动将当前会话的上下文保存到你的 Agent 工作区中。 可以让OpenClaw拥有跨会话的长期记忆。即使你开启了新对话，它也能回忆起之前聊过的重要信息，让交互更有连续性。
  • 然后他会安装 gateway。等一会儿就行了，然后选择使用命令行对话还是 UI 对话。建议先用 UI 里面很多信息比较清楚。
  • 完成后会自动在游览器打开 UI 页面。没打开也没事，日志里面可以看到。自己打开就行了
  • 现在可以发送聊天尝试。我这里报错，是因为我要使用 0011.ai 代理。没有配。后面在 openclaw.json 中配置

三、openclaw 目录结构

目录在 ~/.openclaw

复制代码 
.
├── agents
│   └── main
│       ├── agent
│       │   └── models.json
│       └── sessions
│           ├── faf8ec2c-238b-4aa8-88ef-7233dcbcd4e0.jsonl
│           └── sessions.json
├── canvas
│   └── index.html
├── cron
│   └── jobs.json
├── devices
│   ├── paired.json
│   └── pending.json
├── identity
│   ├── device-auth.json
│   └── device.json
├── logs
│   ├── config-audit.jsonl
│   ├── gateway.err.log
│   └── gateway.log
├── memory
│   └── main.sqlite
├── openclaw.json
├── update-check.json
└── workspace
    ├── AGENTS.md
    ├── BOOTSTRAP.md
    ├── HEARTBEAT.md
    ├── IDENTITY.md
    ├── SOUL.md
    ├── TOOLS.md
    └── USER.md
路径 类型 作用
openclaw.json 主配置 OpenClaw 主配置文件，包含 gateway 端口、token、provider API、models、agents 配置
update-check.json 更新记录 记录 OpenClaw 是否检查过新版本
memory/main.sqlite 数据库 Agent 长期记忆数据库（对话、上下文、状态）
logs/gateway.log 日志 Gateway 正常运行日志
logs/gateway.err.log 日志 Gateway 错误日志
logs/config-audit.jsonl 日志 记录配置文件修改历史
workspace/ 工作区 Agent 执行任务、生成代码、存放文件的目录
workspace/AGENTS.md Prompt 定义 Agent 类型和行为
workspace/BOOTSTRAP.md Prompt Agent 启动时的 system prompt
workspace/HEARTBEAT.md Prompt Agent 心跳 / 状态更新规则
workspace/IDENTITY.md Prompt Agent 身份定义
workspace/SOUL.md Prompt Agent 行为哲学 / 规则
workspace/TOOLS.md Prompt Agent 可用工具说明
workspace/USER.md Prompt 用户信息与偏好
identity/ 认证 身份认证
identity/device-auth.json 认证 设备 / 客户端认证信息
identity/device.json 设备信息 记录当前设备标识
cron/ 调度系统 OpenClaw 内置 cron scheduler 的配置目录
cron/jobs.json 定时任务配置 存储 OpenClaw 的 定时任务（cron jobs）
devices/ 设备管理 OpenClaw 的 设备配对系统
devices/paired.json 设备列表 已经授权的设备（Dashboard / CLI / Remote）
devices/pending.json 配对队列 等待授权的设备

四、配置 openclaw。

1. openclaw.json 配置文件
json 复制代码 
{
  "wizard": {
    // 上次运行初始化向导的时间
    "lastRunAt": "2026-03-09T01:29:44.906Z",

    // 上次运行向导时的 OpenClaw 版本
    "lastRunVersion": "2026.3.2",

    // 最后执行的初始化命令（通常是 onboard）
    "lastRunCommand": "onboard",

    // 运行模式：local / cloud
    "lastRunMode": "local"
  },

  "agents": {
    "defaults": {
      // Agent 的工作目录
      // AI 生成文件、执行任务都会在这里
      "workspace": "/Users/xxx/.openclaw/workspace",

      "compaction": {
        // 上下文压缩策略
        // safeguard = 防止上下文爆炸
        "mode": "safeguard"
      },

      // 同时运行的最大 agent 数
      "maxConcurrent": 4,

      "subagents": {
        // 子 agent 最大并发数量
        "maxConcurrent": 8
      }
    }
  },

  "tools": {
    // 工具权限配置。这里控制模型是否有权限访问本机电脑。full 为所有权限
    // messaging / standard / full
    "profile": "messaging"
  },

  "messages": {
    // 消息确认范围
    // group-mentions = 只响应提及
    "ackReactionScope": "group-mentions"
  },

  "commands": {
    // 是否使用本地原生命令
    "native": "auto",

    // 是否自动加载 native skills
    "nativeSkills": "auto",

    // 命令执行失败是否自动重启
    "restart": true,

    // 命令执行者显示方式
    // raw = 显示真实用户名
    "ownerDisplay": "raw"
  },

  "session": {
    // DM 会话范围
    // per-channel-peer = 每个频道独立会话
    "dmScope": "per-channel-peer"
  },

  "hooks": {
    "internal": {
      // 是否启用内部 hook 系统
      "enabled": true,

      "entries": {
        "boot-md": {
          // 启动时加载 workspace 中的 BOOTSTRAP.md
          "enabled": true
        },

        "command-logger": {
          // 记录命令执行日志
          "enabled": true
        },

        "session-memory": {
          // 启用会话记忆系统
          "enabled": true
        }
      }
    }
  },

  "gateway": {
    // OpenClaw Web Dashboard 端口
    "port": 18789,

    // gateway 运行模式
    // local = 仅本地访问
    "mode": "local",

    // 监听地址
    // loopback = 127.0.0.1
    "bind": "loopback",

    "auth": {
      // 认证方式
      // token / none
      "mode": "token",

      // Dashboard 登录 token
      "token": "372ec8cbcfe557ee947ec76bccd63f33022bb673c282de48"
    },

    "tailscale": {
      // 是否启用 Tailscale 远程访问
      "mode": "off",

      // 程序退出时是否重置网络
      "resetOnExit": false
    },

    "nodes": {
      // 禁止 AI 执行的系统命令
      "denyCommands": [
        "camera.snap",
        "camera.clip",
        "screen.record",
        "contacts.add",
        "calendar.add",
        "reminders.add",
        "sms.send"
      ]
    }
  },

  "models": {
    // provider 合并模式
    // merge = 合并多个 provider
    "mode": "merge",

    "providers": {
      "anthropic": {

        // API 代理地址
        "baseUrl": "https://aicoding.2233.ai",

        // API Key
        "apiKey": "sk-c4pBAcG",

        // API 类型
        // anthropic-messages = Claude Messages API
        "api": "anthropic-messages",

        "models": [
          {
            // 模型 ID
            "id": "claude-opus-4",

            // 模型显示名称
            "name": "claude-opus-4"
          }
        ]
      }
    }
  },

  "auth": {
    "profiles": {
      "anthropic:default": {

        // 使用哪个 provider
        "provider": "anthropic",

        // 认证模式
        // api_key / oauth
        "mode": "api_key"
      }
    }
  },
  channels: {

    // 根据聊天平台 + 频道 ID 自动选择模型
    modelByChannel: {
      discord: {
        // Discord 频道 ID
        // 如果用户在这个频道聊天
        // OpenClaw 会使用 Claude Opus
        "123456789012345678": "anthropic/claude-opus-4-6",

      },
      slack: {
        // Slack channel ID
        // 在这个频道里聊天会使用 GPT-4.1
        C1234567890: "openai/gpt-4.1",
      },
      telegram: {
        // Telegram 群 ID
        // 所有消息默认使用 GPT-4.1 mini
        "-1001234567890": "openai/gpt-4.1-mini",
        // Telegram topic (论坛模式)
        // 格式：
        // group_id:topic:topic_id
        //
        // 在 topic 99 里使用 Claude Sonnet
        "-1001234567890:topic:99": "anthropic/claude-sonnet-4-6",
      },
    },
  },
  "meta": {
    // 最后修改配置的 OpenClaw 版本
    "lastTouchedVersion": "2026.3.2",

    // 最后修改时间
    "lastTouchedAt": "2026-03-09T01:29:44.914Z"
  }
}
2. 常用配置
配置 作用
gateway.port Dashboard 端口
gateway.auth.token 登录 token
models.providers AI 模型提供商
agents.defaults.workspace Agent 工作目录
tools.profile 模型权限，full 系统所有权限

五、安装 skill

ClawHub 是 OpenClaw 生态里的 插件 / 模块仓库管理工具。

1. 安装 clawhub
复制代码 
npm install -g clawhub
2. 常用参数和用法
命令 作用 示例
clawhub search 搜索模块 clawhub search discord
clawhub install 安装模块 clawhub install discord
clawhub remove 删除模块 clawhub remove discord
clawhub list 查看已安装模块 clawhub list
clawhub info 查看模块信息 clawhub info discord
clawhub update 更新模块 clawhub update discord
clawhub upgrade 更新所有模块 clawhub upgrade
clawhub enable 启用模块 clawhub enable discord
clawhub disable 禁用模块 clawhub disable discord
clawhub doctor 检查模块问题 clawhub doctor
clawhub repo add 添加仓库 clawhub repo add <url>
clawhub repo list 查看仓库 clawhub repo list
clawhub repo remove 删除仓库 clawhub repo remove <url>

六、openclaw 常用命令

1. 基础命令
命令 作用 示例
openclaw 显示帮助 openclaw
openclaw version 查看版本 openclaw version
openclaw help 查看帮助 openclaw help
openclaw status 查看运行状态 openclaw status
2. 初始化
命令 作用 示例
openclaw onboard --install-daemon 完整安装向导和安装系统服务 openclaw onboard --install-daemon
openclaw onboard 安装向导 openclaw onboard
openclaw start 启动 gateway + agent openclaw start
openclaw stop 停止 OpenClaw openclaw stop
openclaw restart 重启服务 openclaw restart
3. 日志
命令 作用 示例
openclaw logs 查看日志 openclaw logs
openclaw logs --follow 实时日志 openclaw logs --follow
openclaw logs --errors 只看错误日志 openclaw logs --errors
4. 模型管理
命令 作用 示例
openclaw models list 查看可用模型 openclaw models list
openclaw models auth login 登录模型 provider openclaw models auth login
openclaw models auth logout 退出登录 openclaw models auth logout
openclaw models test 测试模型连接 openclaw models test
5. 系统插件
命令 作用 示例
openclaw plugins list 查看插件 openclaw plugins list
openclaw plugins install 安装插件 openclaw plugins install discord
openclaw plugins remove 删除插件 openclaw plugins remove discord
openclaw plugins update 更新插件 openclaw plugins update
6. Agent 管理
命令 作用 示例
openclaw agents list 查看 agent openclaw agents list
openclaw agents add 添加 agent openclaw agents add coder
openclaw agents remove 删除 agent openclaw agents remove coder
openclaw agents restart 重启 agent openclaw agents restart
7. 设备管理
命令 作用 示例
openclaw devices list 查看已配对设备 openclaw devices list
openclaw devices approve 批准设备 openclaw devices approve
openclaw devices remove 移除设备 openclaw devices remove
8. 配置管理
命令 作用 示例
openclaw config show 查看配置 openclaw config show
openclaw config edit 编辑配置 openclaw config edit
openclaw config reset 重置配置 openclaw config reset
9. 调试 / 诊断
命令 作用 示例
openclaw doctor 检查系统问题 openclaw doctor
openclaw debug 调试模式 openclaw debug
openclaw env 查看环境信息 openclaw env
10. 开发工具
命令 作用 示例
openclaw run 运行 agent 任务 openclaw run
openclaw exec 执行命令 openclaw exec
openclaw shell 打开 agent shell openclaw shell
11. 更新
命令 作用 示例
openclaw update 更新 OpenClaw openclaw update
openclaw upgrade 升级组件 openclaw upgrade
相关推荐
gujunge1 小时前
Spring with AI (6): 记忆保持——会话与长期记忆
ai·大模型·llm·openai·qwen·rag·spring ai·deepseek
李彦亮老师(本人)2 小时前
OpenClaw 随机封面摘要标签自动发布测试
openclaw·发布测试
维度攻城狮3 小时前
Docker优雅地运行OpenClaw
运维·docker·容器·openclaw·openclaw安装
YuanDaima20486 小时前
LangChain基础配置与对话模型实战
人工智能·python·langchain·大模型·智能体·langgraph
YUNDUANNET7 小时前
AI驱动，不止于概念 | VeryCloud联合亚马逊云科技深度解读OpenClaw开发范式革命
人工智能·科技·openclaw
何政@9 小时前
Agent Skills 完全指南：从概念到自定义实践
人工智能·python·大模型·claw·404 not found 罗
七夜zippoe9 小时前
OpenClaw 多渠道统一管理：构建全平台智能消息中枢
开发语言·microsoft·github·多渠道·openclaw
2501_9481142410 小时前
OpenClaw数据采集实战：用星链4SAPI给AI采集装上“稳定引擎”
服务器·人工智能·ai·openclaw
韦东东10 小时前
RAGFlow v0.19图文混排：详细拆解+预处理增强案例
人工智能·大模型·agent·ragflow·图文混排
小白电脑技术10 小时前
如何给OpenClaw配置模型提供商API和大模型？
windows·电脑·openclaw
热门推荐
012026年3月AI领域大事件：DeepSeek引领开源风暴02GitHub 镜像站点03Qwen3.5-Omni与Qwen3.6模型全面解析（含测评/案例/使用教程）04围棋-html版本05纯 HTML/CSS/JS 实现的高颜值登录页，还会眨眼睛！少女心爆棚！06Claude Code + GLM4.7 避坑指南：解决 Unable to connect to Anthropic services07“wsl --install -d Ubuntu-22.04”下载慢，中国地区离线安装 Ubuntu 22.04 WSL方法（亲测2025年5月6日）08让 Trae IDE 智能体 “读懂”文档 Excel+PDF+DOCX ：mcp-documents-reader 工具使用指南09UV安装并设置国内源10AI 编程效率翻倍：Superpowers Skills 上手清单 + 完整指南