记录于2026年3月9号个人博客现转录CSDN在 Ubuntu 上用 OpenClaw 搭建个人 AI 助手核心是一行命令安装 → 配置大模型 API → 启动服务 → 用 Web / 微信 / Telegram 交互。全程本地部署、数据可控、支持自动任务与自定义技能。系统要求Ubuntu系统Ubuntu 20.04 / 22.04 / 24.04 LTS推荐 22.04CPU2 核 内存最低 2GB推荐 4GB硬盘2GB 可用空间依赖Node.js ≥ 22、curl、git1安装openclaw相关运行环境nodejs#步骤 1安装依赖工具 sudo apt update sudo apt install -y curl gnupg2 ca-certificates lsb-release #添加 NodeSource 源 # 安装 Node.js 20.xLTS 稳定版 curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - #安装 sudo apt install -y nodejs #安装完成后检查版本确认是否成功 # 检查 Node.js 版本 node -v # 检查 npm 版本npm 会随 Node.js 自动安装 npm -vgit#步骤 1更新系统包列表 sudo apt update #步骤 2安装 Git sudo apt install -y git #步骤 3验证安装是否成功 git --version # 配置全局用户名替换成你的名字 git config --global user.name Your Name # 配置全局邮箱替换成你的邮箱 git config --global user.email your.emailexample.com #验证 git config --listopenclaw## 国内一键安装脚本自动配置、引导 curl -fsSL https://open-claw.org.cn/install-cn.sh | bash # 安装 pnpm推荐速度更快 npm install -g pnpm # 配置国内镜像必做否则下载慢 pnpm config set registry https://registry.npmmirror.com/ # 全局安装 OpenClaw pnpm add -g openclawlatest # 验证 openclaw --version安装openclaw onboard 以 阿里百炼qwen 模型 为例随后接入大模型LLM可选择厂商模型也可以选择本地模型。常用指令# 启动初始化向导配置模型、网关等 openclaw onboard # 启动网关服务 openclaw gateway start # 查看状态 openclaw status --all # 停止现有服务 openclaw gateway stop # 强制重新安装系统服务刷新版本号 openclaw gateway install --force # 重新启动 openclaw gateway start # 查看日志确认无报错 openclaw logs --follow # 先修复配置 openclaw doctor --fix # 重新安装服务同步新配置和Token openclaw gateway install --force # 重启网关 openclaw gateway restart2配置大模型apiKey核心配置文件openclaw.json本人选择千问-3.5plus,阿里百炼提供免费次数举例apiKey: __OPENCLAW_REDACTED__,搜索阿里云百炼登录后 点击模块广场搜Qwen3.5-plus滚动可查看免费额度剩余选择你对应大模型的apikey此处使用手动配置简单{ meta: { lastTouchedVersion: 2026.3.2, lastTouchedAt: 2026-03-09T05:42:38.743Z, }, wizard: { lastRunAt: 2026-03-08T11:52:24.041Z, lastRunVersion: 2026.3.2, lastRunCommand: onboard, lastRunMode: local, }, auth: { profiles: { kimi-coding:default: { provider: kimi-coding, mode: api_key, }, }, }, models: { mode: merge, providers: { bailian: { baseUrl: https://dashscope.aliyuncs.com/compatible-mode/v1, apiKey: __OPENCLAW_REDACTED__, api: openai-completions, models: [ { id: qwen3.5-plus, name: qwen3.5-plus, api: openai-completions, reasoning: false, input: [ text, image, ], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, }, contextWindow: 1000000, maxTokens: 65536, }, { id: qwen3-coder-next, name: qwen3-coder-next, api: openai-completions, reasoning: false, input: [ text, ], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, }, contextWindow: 262144, maxTokens: 65536, }, ], }, }, }, agents: { defaults: { model: { primary: bailian/qwen3.5-plus, }, models: { bailian/qwen3.5-plus: {}, bailian/qwen3-coder-next: {}, }, workspace: /home/admin1/.openclaw/workspace, compaction: { mode: safeguard, }, }, }, tools: { profile: messaging, }, commands: { native: auto, nativeSkills: auto, restart: true, ownerDisplay: raw, }, session: { dmScope: per-channel-peer, }, hooks: { internal: { enabled: true, entries: { command-logger: { enabled: true, }, bootstrap-extra-files: { enabled: true, }, boot-md: { enabled: true, }, }, }, }, gateway: { port: 18789, mode: local, bind: lan, controlUi: { allowedOrigins: [ http://localhost:18789, http://127.0.0.1:18789, http://192.168.29.130:18789, http://192.168.29.1:18789, ], }, auth: { mode: token, token: __OPENCLAW_REDACTED__, }, tailscale: { mode: off, resetOnExit: false, }, }, }3使用主机访问虚拟机openclaw虚拟机与主机关系NAT连接配置端口转发修改虚拟机网关配置allowedOrigins 是 OpenClaw 网关Gateway的 CORS 跨域来源白名单用于控制哪些网页地址Origin可以访问其 Web 控制面板Control UI是核心安全配置。核心作用安全机制当在浏览器访问 http://192.168.29.130:18789 时浏览器会自动发送当前页面的 Origin 给网关网关校验只有在 allowedOrigins 列表中的 Origin 才允许连接不在列表 → 直接拒绝浏览器报 origin not allowed 错误本质防止未授权网页 / 域名调用你的 OpenClaw 网关接口allowedOrigins:[http://localhost:18789,// 本机域名访问http://127.0.0.1:18789,// 本机回环IPhttp://192.168.29.130:18789,// 本机局域网IP你的设备http://192.168.29.1:18789// 路由器/网关地址]作用允许本机 内网这 4 个地址访问控制面板场景你在本机 / 局域网打开 OpenClaw 控制台bind: “lan” 必须配 allowedOrigins当前 bind: “lan”监听所有网卡允许外网 / 内网访问# 1. 查看当前配置 cat ~/.openclaw/config.json # 2. 修改 host 为 0.0.0.0 gateway bind: lan, // 核心修改从 0.0.0.0 改成 lan # 3. 重启网关 openclaw gateway restart # 4. 验证应该看到 0.0.0.0:18789 ss -tlnp | grep 18789之后能配置token主机访问报错#查看并授权待批准的设备 openclaw devices list # 授权指定 Request ID openclaw devices approve c74f9c91-ssss-aaa-be8c-ssss #全部授权 openclaw devices approve --all完成效果展示