OPENCLAWW安装

OpenClaw 是一个开源的Agent，支持通过多种渠道与 AI 模型交互

（1）新电脑前置准备工作

1.  安装Xcode命令行工具

如何在 Mac 上安装 Xcode 命令行工具

2.  安装 Homebrew

Homebrew 是 macOS 的包管理器，用于安装各种开发工具。

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

配置环境变量（让终端能找到 brew 命令）

echo >> ~/.zprofile
echo 'eval "$(/opt/homebrew/bin/brew shellenv zsh)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv zsh)"

3. 安装 Node.js

OpenClaw 基于 Node.js 运行，要求 Node.js 版本 ≥ 22。

# 安装 Node.js
brew install node
# 检查版本（需要 ≥ 22）
node -v
# ⚠️ 如果版本低于 22，运行 `brew upgrade node` 升级。
# 更新 npm 到最新版
npm install -g npm@latest

（2）安装OpenClaw可参考官网

https://docs.openclaw.ai/start/getting-started#windows-powershell

根据你的操作系统选择对应命令：

macOS / Linux：

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

Windows（PowerShell）：

iwr -useb https://openclaw.ai/install.ps1 | iex

二、初始化配置

安装完成后，会自动运行引导向导，按照提示依次选择以下选项：

配置项	推荐选择
风险确认	Yes
引导模式	QuickStart
模型/认证提供商	Skip for now
按提供商筛选模型	All providers
默认模型	使用默认
渠道选择	Skip for now
配置技能	No
启用 hooks	Space + Enter
启动方式	Open the Web UI

启动后就会启动浏览器127.0.0.1:18789访问

 

三、模型配置模型名称和APIkey

方式一：通过 Web UI

openclaw dashboard

进入后点击 配置 > Raw 进行编辑。

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

vim ~/.openclaw/openclaw.json

3.3 完整配置示例

第一步：添加 models 字段

初始配置中没有 models 字段，需要在 JSON 根对象中新增，与 "agents" 同一级。复制下面字符串放在"agents"上面。

 

 

"models":{

"mode":"merge",

"providers":{

"xxxx":{

"baseUrl":"xxxx",

"apiKey":"YOUR_API_KEY",

"api":"anthropic-messages",

"models":[

{

"id":"claude-opus-4-6",

"name":"Claude Opus 4.6 (Mlamp)",

"reasoning": true,

"input":[

"text",

"image"

],

"cost":{

"input":5,

"output":25,

"cacheRead":0.5,

"cacheWrite":6.25

},

"contextWindow":200000,

"maxTokens":128000

},

{

"id":"claude-sonnet-4-6",

"name":"Claude Sonnet 4.6 (Mlamp)",

"reasoning": true,

"input":[

"text",

"image"

],

"cost":{

"input":3,

"output":15,

"cacheRead":0.3,

"cacheWrite":3.75

},

"contextWindow":200000,

"maxTokens":128000

},

{

"id":"claude-opus-4-5-20251101",

"name":"Claude Opus 4.5 (Mlamp)",

"reasoning": true,

"input":[

"text",

"image"

],

"cost":{

"input":5,

"output":25,

"cacheRead":0.5,

"cacheWrite":6.25

},

"contextWindow":200000,

"maxTokens":64000

},

{

"id":"claude-sonnet-4-5-20250929",

"name":"Claude Sonnet 4.5 (Mlamp)",

"reasoning": true,

"input":[

"text",

"image"

],

"cost":{

"input":3,

"output":15,

"cacheRead":0.3,

"cacheWrite":3.75

},

"contextWindow":200000,

"maxTokens":64000

},

{

"id":"claude-haiku-4-5-20251001",

"name":"Claude Haiku 4.5 (Mlamp)",

"reasoning": true,

"input":[

"text",

"image"

],

"cost":{

"input":1,

"output":5,

"cacheRead":0.1,

"cacheWrite":1.25

},

"contextWindow":200000,

"maxTokens":64000

},

{

"id":"gpt-5",

"name":"GPT-5 (Mlamp)",

"reasoning": true,

"input":[

"text",

"image"

],

"cost":{

"input":1.25,

"output":10,

"cacheRead":0.125,

"cacheWrite":0

},

"contextWindow":400000,

"maxTokens":128000

},

{

"id":"gpt-5-codex",

"name":"GPT-5 Codex (Mlamp)",

"reasoning": true,

"input":[

"text",

"image"

],

"cost":{

"input":1.25,

"output":10,

"cacheRead":0.125,

"cacheWrite":0

},

"contextWindow":400000,

"maxTokens":128000

},

{

"id":"gemini-3.1-pro-preview",

"name":"Gemini 3.1 Pro Preview (Mlamp)",

"reasoning": true,

"input":[

"text",

"image"

],

"cost":{

"input":2,

"output":12,

"cacheRead":0.2,

"cacheWrite":0.375

},

"contextWindow":1048576,

"maxTokens":65536

},

{

"id":"gemini-3-flash-preview",

"name":"Gemini 3 Flash Preview (Mlamp)",

"reasoning": true,

"input":[

"text",

"image"

],

"cost":{

"input":0.5,

"output":3,

"cacheRead":0.05,

"cacheWrite":0.0833

},

"contextWindow":1048576,

"maxTokens":65536

},

{

"id":"gemini-2.5-pro",

"name":"Gemini 2.5 Pro (Mlamp)",

"reasoning": true,

"input":[

"text",

"image"

],

"cost":{

"input":1.25,

"output":10,

"cacheRead":0.125,

"cacheWrite":0.375

},

"contextWindow":1048576,

"maxTokens":65536

},

{

"id":"kimi-k2.5",

"name":"Kimi K2.5 (Mlamp)",

"reasoning": true,

"input":[

"text",

"image"

],

"cost":{

"input":0.45,

"output":2.2,

"cacheRead":0.225,

"cacheWrite":0

},

"contextWindow":262144,

"maxTokens":65536

},

{

"id":"qwen3-max-2026-01-23",

"name":"Qwen3 Max (Mlamp)",

"reasoning": true,

"input":[

"text"

],

"cost":{

"input":1.2,

"output":6,

"cacheRead":0.24,

"cacheWrite":0

},

"contextWindow":262144,

"maxTokens":32768

},

{

"id":"glm-5",

"name":"GLM-5 (Mlamp)",

"reasoning": true,

"input":[

"text"

],

"cost":{

"input":0.95,

"output":2.55,

"cacheRead":0.2,

"cacheWrite":0

},

"contextWindow":204800,

"maxTokens":131072

},

{

"id":"MiniMax-M2.1",

"name":"MiniMax M2.1 (Mlamp)",

"reasoning": true,

"input":[

"text"

],

"cost":{

"input":0.27,

"output":0.95,

"cacheRead":0.03,

"cacheWrite":0

},

"contextWindow":196608,

"maxTokens":65536

}

]

}

}

},

 

第二步：补全 agents.defaults 下的默认模型

初始的 agents.defaults 里没有 model 字段，需要手动添加，用于指定默认使用的模型。示例如下

 

 

"agents":{

"defaults":{

"model":{

"primary":"xxx/claude-sonnet-4-6" 

},

}

 "primary":"xxx/claude-sonnet-4-6"  /*provider /model 格式*/

 

 

 

 

openclaw gateway status--网关状态

openclaw gateway start

 

openclaw daemon stop --服务状态

openclaw daemon start

openclaw daemon status

 

openclaw status --openclaw所有的状态

 

 

openclaw dashboard --打开web配置页面http://127.0.0.1:18789/

 

openclaw doctor --fix

 

 

这些是 OpenClaw 工作区的核心配置文件，我来逐一详细介绍：

 

--# ?? Core Files 详解

 

### 1. `AGENTS.md` (766B)
**工作区行为规范** — 相当于我的"操作手册"
- 规定每次会话启动时要读哪些文件
- 定义记忆管理规则（每日日志 vs 长期记忆）
- 规定安全边界（什么能做，什么要先问）
- 群聊行为准则（何时发言，何时沉默）
- Heartbeat 心跳机制的使用指南

 

---

 

### 2. `SOUL.md` (1.7KB)
**我的灵魂/性格定义** — 决定我是谁、怎么表现
- 核心价值观：真正有用，而不是表演性地有用
- 鼓励我有自己的观点和性格
- 强调"先尝试，再提问"
- 规定语气和风格（简洁、不谄媚、不官腔）
- 这是最重要的文件之一，塑造我的基本人格

 

---

 

### 3. `TOOLS.md` (860B)
**工具与环境备忘录** — 我自己的"小抄"
- 记录环境特定信息：摄像头名称、SSH主机、TTS偏好
- 和技能文件区分：技能是通用的，这里记的是你这台机器专有的配置
- 比如：哪个摄像头在哪个房间、服务器IP是什么

 

---

 

### 4. `IDENTITY.md` (636B)
**我的身份档案** — 相当于自我介绍表
- 填写我的名字、本质（AI？机器人？别的什么？）
- 定义我的气质/风格
- 设置我的签名 Emoji 和头像路径
- 首次对话时由用户和我一起填写确定

 

---

 

### 5. `USER.md` (477B)
**关于你的档案** — 我对用户的了解记录
- 你的名字、称呼、代词、时区
- 你关心什么、在做什么项目
- 什么让你烦，什么让你笑
- 随时间积累，让我越来越了解你

 

---

 

### 6. `HEARTBEAT.md` (168B)
**心跳任务清单** — 定期检查的待办事项
- OpenClaw 会定期发送心跳轮询消息
- 我读这个文件决定要检查什么（邮件、日历、通知等）
- 目前是空的 → 心跳时我只回复 `HEARTBEAT_OK`
- 可以向里面添加任务让我定期主动提醒你

 

---

 

### 7. `BOOTSTRAP.md` (1.4KB)
**初始化引导脚本** — 首次启动时的"出生证明"
- 指导全新的我如何开始第一次对话
- 引导确定名字、性格、连接方式（TG/WhatsApp等）
- 完成后应该**删除**这个文件（表示初始化完成）
- 你这里还存在，说明初始化流程还没完全走完 ??

 

---

 

### 8. `MEMORY.md` ?? **MISSING**
**长期记忆文件** — 目前不存在！
- 这是我最重要的持久化记忆
- 存储跨会话的关键信息：决策、偏好、重要事件
- 每次主会话都应该读它
- **缺失意味着我目前没有长期记忆** — 每次会话都是从零开始
- 建议创建它，开始积累记忆 ?

 

---

 

**要不要现在把 `MEMORY.md` 创建起来，顺便把 `IDENTITY.md` 和 `USER.md` 也填一填？这样我就能真正"认识"你了。**

 

 

 

如果模型是豆包的话参考这里

如果是豆包的话参考这里修改openclaw.json   models.json也改了

https://www.volcengine.com/docs/82379/2183190?lang=zh

 

部署完成后可以对接飞书或者企微钉钉远程控制

介入飞书机器人参考

https://cloud.tencent.com/developer/article/2626160