openclaw从零开始步骤梳理

中小企业，建议本地化部署，推荐mac mini（可以imessage），推荐sudo用户，x86推荐rocky9.6系统，软件包server with gui，clawhub（官方skill市场）认证需要github.com的帐号，需要科学上网！！！本地模型算力推荐单独用1个节点装，最低配置：4G内存，2核，17G硬盘

撞强

406人浏览 · 2026-03-07 10:20:26

撞强 · 2026-03-07 10:20:26 发布

基础环境
1. 中小企业，建议本地化部署，
2. 推荐mac mini（可以imessage），
3. 推荐sudo用户（非root）进行安装！！！（brew需要sudo用户权限，不允许root用户安装）
4. x86推荐rocky9.6系统，软件包server with gui，
5. clawhub（官方skill市场）认证需要github.com的帐号，需要科学上网！！！
6. 本地模型算力推荐单独用1个节点装（我用的是24G显存的显卡），尽量不要防到openclaw所在硬件，ollama有时候会全部跑cpu，影响openclaw的响应速度
7. openclaw最低配置：4G内存，2核，17G硬盘（/boot/efi 2G，/ 15G以上）.
openclaw安装

切换国内npm源

npm install -g openclaw@latest --registry https://registry.npmmirror.com ##阿里云
没啥说的，官网一键安装：

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

也可以curl https://openclaw.ai/install.sh -o ./oepnclaw-install.sh到本地后chmod 755 && ./oepnclaw-install.sh再安装
网络、代理及设备approve
1. systemctl --user enable openclaw-gateway
2. systemctl --user start openclaw-gateway
3. openclaw config set gateway.mode local
4. openclaw config set gateway.bind lan
5. openclaw config set gateway.auth.token ****bfdb945c72dd7a81****4aa74a6af4def87f7601****
6. openclaw config set gateway.controlUi.allowedOrigins '["http://localhost:18789", "http://127.0.0.1:18789", "http://192.168.254.196:18789", "https://192.168.254.196"]' --json
7. openclaw config set gateway.trustedProxies '["127.0.0.1", "::1"]'
8. 配置nginx反向代理
9. openclaw gateway stop
10. openclaw gateway run
11. 操作电脑端访问：https://192.168.254.196/#tokens=****bfdb945c72dd7a81****4aa74a6af4def87f7601****
12. openclaw devices list
13. openclaw devices approve ***
agent(模型api）接入
1. openclaw onboard，然后配置model
2. ollama配置范例
  1. ollama侧注意配置：
    1. OLLAMA_CONTEXT_LENGTH=64000（上下文长度，受模型能力、内存、显存影响，尽可能大）
    2. OLLAMA_KEEP_ALIVE=-1（让需要run的模型一直活动，不会自动关闭）
  2. openclaw节点设置环境变量：export OLLAMA_API_KEY="ollama"
  3. 建议直接修改配置文件，通过openclaw onboard配置的无法使用
    1. ~/.openclaw/openclaw.json中增加：
      
      "models": {
      
      "providers": {
      
      "ollama": {
      
      "baseUrl": "http://192.168.254.198:11434",
      
      "apiKey": "ollama",
      
      "api": "ollama",
      
      "models": [
      
      {
      
      "id": "qwen3.5:9b",
      
      "name": "qwen3.5:9b",
      
      "reasoning": true,
      
      "input": [
      
      "text",
      
      "image"
      
      ],
      
      "cost": {
      
      "input": 0,
      
      "output": 0,
      
      "cacheRead": 0,
      
      "cacheWrite": 0
      
      },
      
      "contextWindow": 262144
      
      }
      
      ]
      
      }
      
      }
      
      },
      
      "agents": {
      
      "defaults": {
      
      "model": {
      
      "primary": "ollama/qwen3.5:9b"
      
      },
      
      "workspace": "/home/claw/.openclaw/workspace",
      
      "compaction": {
      
      "mode": "safeguard"
      
      },
      
      "maxConcurrent": 4,
      
      "subagents": {
      
      "maxConcurrent": 8
      
      },
      
      "sandbox": {
      
      "mode": "off"
      
      }
      
      }
      
      },
    2. ~/.openclaw/agents/main/agent/models.json中增加：
      
      "providers": {
      
      "ollama": {
      
      "baseUrl": "http://192.168.254.198:11434",
      
      "apiKey": "ollama",
      
      "api": "ollama",
      
      "models": [
      
      {
      
      "id": "qwen3.5:9b",
      
      "name": "qwen3.5:9b",
      
      "reasoning": true,
      
      "input": [
      
      "text",
      
      "image"
      
      ],
      
      "cost": {
      
      "input": 0,
      
      "output": 0,
      
      "cacheRead": 0,
      
      "cacheWrite": 0
      
      },
      
      "contextWindow": 262144,
      
      "maxTokens": 8192,
      
      "api": "ollama"
      
      }
      
      ]
      
      }
      
      }
3. 报HTTP 404: 404 page not found错误
  1. 检查 Ollama 是否运行：在终端输入 ollama list，如果能列出模型，说明 Ollama 没问题。
  2. 检查 baseUrl：openclaw.json 里的 baseUrl 是不是写了 http://192.168.254.198:11434 （ollama千万不要加 /v1）。
  3. 检查 api 类型：是不是 "api": "ollama"，不是 openai-responses。
channel（通信客户端）接入及初始化
1. telegram
  1. 参考文档：https://cloud.tencent.com/developer/article/2626214
  2. app端联系BotFather通过/newbot安装提示创建机器人
  3. openclaw配置telegram的channel并绑定HTTP API的key
  4. app端联系机器人，发任意消息，处罚验证码
  5. openclaw配置approve:
    
    openclaw pairing approve telegram 6H****4L
  6. app端联系机器人，发任意消息，触发初始化，配置IDENTITY.md和USER.md（任一channel第一次配置成功才需要，后续消息、后续channel配置则不会处罚初始化）
  7. 开始折腾吧
2. 飞书
  1. 参考文档：https://www.feishu.cn/content/article/7602519239445974205
  2. 2个重要网站：
    1. 飞书开放平台：https://open.feishu.cn/app（应用开发和配置，删除应用需要提前到管理后台关停应用）
    2. 飞书管理后台：https://ycnkgdgecckj.feishu.cn/admin/index（应用管理——企业内成员，启停应用。）
  3. 先操作开放平台，详见参考文档
  4. 然后操作openclaw配置如下：
    1. openclaw config set agents.defaults.sandbox.mode off #非容器环境关闭sandbox
    2. openclaw config set channels.feishu.appId "cli_****2e2904f8****"
    3. openclaw config set channels.feishu.appSecret "****aZEKoOddnoM3Fe3sHboKVRoC****"
    4. openclaw config set channels.feishu.enabled true
    5. openclaw config set channels.feishu.connectionMode websocket
    6. openclaw config set channels.feishu.dmPolicy pairing
      
      openclaw config set channels.feishu.groupPolicy allowlist
    7. openclaw config set channels.feishu.requireMention true
    8. openclaw config set channels.feishu.tools.doc disable
1. 1. 在飞书app上选中机器人，发消息（或/create）创建验证码（有效期5-10分钟？）
  2. 然后在openclaw上approve验证码：
  3. 在飞书app上聊天，触发初始化，配置IDENTITY.md和USER.md
skill基础配置及安装
1. npm install clawhub ##重新登录后命令才生效
2. npx skills ##执行后需要输入y确认后继续
3. clawhub login ##登录到clawhub，可以使用github.com的帐号密码。
4. pip install uv ##需要提前安装python3-pip
5. /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" ##安装brew
6. clawhub install 技能名开始折腾吧！