openclaw安装配置

前置条件：

node.js下载：https://nodejs.org/zh-cn/download

一.安装与基础初始化

首先确保你已经安装了 Node.js 24+ 环境，然后在终端执行：

1.npm安装（推荐）

npm install -g openclaw

2.安装完成后验证

openclaw --version

3.初始化配置（配置文件默认生成在 `~/.openclaw/openclaw.json`。）

openclaw setup

二.配置openclaw

1. 配置openclaw.json文件，按需替换 api地址和api key 和访问token，覆盖原来的openclaw.json文件即可，后续可以运行openclaw config命令或者修改openclaw.json文件继续配置。

之前有小龙虾，看下方只添加模型部分
或者可以命令小龙虾自己添加模型

openclaw.json

只添加模型

openclaw.json参考模板

{
"gateway": {
"port": 18789,
"mode": "local",
"auth": {
  "token": "147ai"  //替换自己的访问令牌
},
"trustedProxies": ["127.0.0.1"],
"controlUi": {
  "allowedOrigins": ["*"],
  "allowInsecureAuth": true
}
},
"agents": {
"defaults": {
  "model": {
    "primary": "claude/claude-opus-4-6-thinking",
    "fallbacks": [
      "claude/claude-sonnet-4-6-thinking",
      "gpt/gpt-5.4",
      "gemini/gemini-3.1-pro-preview"
    ]
  },
  "imageModel": {
    "primary": "gemini-3.1-pro-preview"
  },
  "compaction": {
    "mode": "default"
  },
  "maxConcurrent": 4,
  "subagents": {
    "maxConcurrent": 8
  }
}
},
"models": {
"mode": "merge",
"providers": {
  "claude": {
    "baseUrl": "https://api.147ai.cn/v1",
    "apiKey": "sk-",   //替换自己的key
    "api": "anthropic-messages",
    "models": [
      {
        "id": "claude-opus-4-6",
        "name": "Claude Opus 4.6",
        "reasoning": true,
        "input": ["text", "image"],
        "contextWindow": 200000,
        "maxTokens": 16384
      },
      {
        "id": "claude-sonnet-4-6-thinking",
        "name": "Claude Sonnet 4.6 思考版",
        "reasoning": true,
        "input": ["text", "image"],
        "contextWindow": 200000,
        "maxTokens": 8192
      }
    ]
  },
  "gpt": {
    "baseUrl": "https://api.147ai.cn/v1",
    "apiKey": "sk-",   //替换自己的key
    "api": "openai-completions",
    "models": [
      {
        "id": "gpt-5.4",
        "name": "GPT-5.4",
        "reasoning": false,
        "input": ["text", "image"],
        "contextWindow": 200000,
        "maxTokens": 16384
      }
    ]
  },
  "gemini": {
    "baseUrl": "https://api.147ai.cn/v1",
    "apiKey": "sk-",  //替换自己的key
    "api": "openai-completions",
    "models": [
      {
        "id": "gemini-3.1-pro-preview",
        "name": "Gemini 3.1 Pro",
        "reasoning": true,
        "input": ["text", "image"],
        "contextWindow": 1048576,
        "maxTokens": 65536
      },
      {
        "id": "gemini-3-pro-image-preview",
        "name": "Gemini 3 Pro image",
        "reasoning": true,
        "input": ["text", "image"],
        "contextWindow": 1048576,
        "maxTokens": 65536
      }
    ]
  }
}
},
"messages": {
"ackReactionScope": "group-mentions"
},
"commands": {
"native": "auto",
"nativeSkills": "auto",
"restart": true
}
}

2. 验证配置，有报错按提示修改，无报错继续。

openclaw config validate

三.启动服务（启动可能有几十秒延迟）

nohup openclaw gateway --force > /tmp/openclaw.log 2>&1 &

验证是否成功

openclaw health

四.访问 Dashboard（openclaw仪表盘）

浏览器打开(加token验证)：

http://你的服务器IP:18789/#token=你设置的token令牌值

登录页面出现，“pairing”字样就需要验证

回到终端，输入openclaw devices list，出现下图，复制箭头指的Request值

openclaw devices list

再次输入openclaw devices approve 接上(Request值)，如下图

openclaw devices approve (Request值)

返回浏览器，不要刷新，等一会自动连接，没有自动连接的话点概览，点连接

五.接入飞书和Telegram

飞书

创建飞书机器人

进入飞书开放平台：https://open.feishu.cn
1.注册登录账号
2.开发者后台--创建企业自建应用--创建

3.添加应用能力--添加机器人
4.权限管理--开通权限--搜索im:开通所有消息相关权限（可自选）--确认开通

5.创建版本并发布（上方有提示）--填写保存并发布

openclaw连接飞书

1.回到终端输入openclaw config回车

openclaw config

选择(空格勾选，回车选择)：Local--Channels--Configgure/link--feishu(飞书)--Download from npm(安装飞书插件)--Enter App Secret回车--回到飞书开放平台--凭证与基础信息复制App Secret和App ID的内容--返回终端粘贴并回车--再粘贴App ID的内容回车--WebSocket--Feishu.cn China--Open re··--最下面Finished--yes--pairing--Continue

2.启动openclaw

3.回到飞书开放平台--事件与回调--订阅方式--选择长链接并保存--添加事件--搜索接收勾选接收消息--确认添加--权限管理--开通权限--搜索通讯录勾选获取通讯录基本信息--确认开通权限--再次创建版本并发布

4.打开手机飞书app登录--开发者小助手--打开应用--和机器人对话

5.复制箭头指向的最后一段在终端运行

openclaw pairing approve feishu 配对码

回到飞书就能正常对话了

六.常用操作指令

配置openclaw命令（配置向导，自动合并写入openclaw.json文件）

openclaw configure

进程管理

模型切换

临时切换（在聊天中发送）：

/model claude/claude-sonnet-4-6-thinking

模型管理

openclaw models list                    # 列出所有可用模型
openclaw models status                  # 查看当前默认模型
openclaw models set <provider/model>    # 设置默认主模型
openclaw models set-image <provider/model> # 设置图像模型
openclaw models scan                    # 扫描可用模型

配置管理

openclaw config get <key>               # 读取配置值
openclaw config set <key> <value>       # 写入配置值
openclaw config unset <key>             # 删除配置值
openclaw configure                      # 交互式配置

# 示例
openclaw config set openai.api_key "sk-..."
openclaw config set messages.tts.auto "always"

更新

更新后重启

pkill -f "openclaw gateway" && sleep 2 && nohup openclaw gateway --force > /tmp/openclaw.log 2>&1 &

聊天框常见斜杆操作

命令	功能
`/new`	开启全新会话
`/stop`	中止当前运行的任务
`/compact`	释放上下文窗口空间
`/status`	显示健康状态和当前上下文
`/context list`	列出所有上下文贡献者
`/subagents list`	列出子智能体
`/subagents info`	查看子智能体信息
`/model`	查看当前使用的模型
`/model list`	列出所有可用模型
`/model <编号>`	按编号切换模型（如 `/model 3`）
`/model <provider/model>`	按完整 ID 切换模型
`/model status`	查看模型详细状态
`/think`	开启 / 关闭推理模式
`/reasoning on`	开启深度推理
`/tts on`	开启文本转语音
`/tts off`	关闭文本转语音

七.常见问题

Q: 启动报 Invalid config 错误
检查 claude.api 是否为 anthropic-messages，不能写成 anthropic。

Q: 聊天报工具调用错误（function tag mismatch）
同上，claude.api 填错导致，改为 anthropic-messages 重启即可。

Q: systemctl restart openclaw 失败
容器环境无 systemd，使用 pkill + nohup 方式手动重启（见上方进程管理）。

Q: 模型请求超时/无响应
用 curl 直接测试对应 provider 的 key 和 baseUrl 连通性，确认 key 有效后重启服务。

openclaw接入147ai教程

openclaw安装配置#

一.安装与基础初始化#

1.npm安装（推荐）#

2.安装完成后验证#

3.初始化配置（配置文件默认生成在 ~/.openclaw/openclaw.json。）#

二.配置openclaw#

1. 配置openclaw.json文件，按需替换 api地址和api key 和 访问token，覆盖原来的openclaw.json文件即可，后续可以运行openclaw config命令或者修改openclaw.json文件继续配置。#

2. 验证配置，有报错按提示修改，无报错继续。#

三.启动服务（启动可能有几十秒延迟）#

验证是否成功#

四.访问 Dashboard（openclaw仪表盘）#

五.接入飞书和Telegram#

创建飞书机器人#

openclaw连接飞书#

六.常用操作指令#

配置openclaw命令（配置向导，自动合并写入openclaw.json文件）#

进程管理#

模型切换#

配置管理#

更新#

更新后重启#

聊天框常见斜杆操作#

七.常见问题#

openclaw安装配置

一.安装与基础初始化

1.npm安装（推荐）

2.安装完成后验证

3.初始化配置（配置文件默认生成在 `~/.openclaw/openclaw.json`。）

二.配置openclaw

1. 配置openclaw.json文件，按需替换 api地址和api key 和访问token，覆盖原来的openclaw.json文件即可，后续可以运行openclaw config命令或者修改openclaw.json文件继续配置。

2. 验证配置，有报错按提示修改，无报错继续。

三.启动服务（启动可能有几十秒延迟）

验证是否成功

四.访问 Dashboard（openclaw仪表盘）

五.接入飞书和Telegram

创建飞书机器人

openclaw连接飞书

六.常用操作指令

配置openclaw命令（配置向导，自动合并写入openclaw.json文件）

进程管理

模型切换

配置管理

更新

更新后重启

聊天框常见斜杆操作

七.常见问题