☰
信创环境 OpenClaw 配 TaoToken:Chromium 浏览器安装与 settings.json 骨架
2026/9/28 18:51:56 网站建设 项目流程

1. 信创 arm64 环境里,OpenClaw 为什么非要自己装 Chromium

在统信 UOS 或麒麟的 arm64 机器上折腾 OpenClaw,最先卡住的往往不是模型,而是浏览器。OpenClaw 的 browser 能力需要调用一个真实的 Chromium 内核来渲染页面、执行点击、抓取 DOM,可你打开应用商店会发现:Chrome 官方压根没出 arm64 的 Linux 桌面版,装不上;系统自带的浏览器又常常是裁剪过的,缺少远程调试端口和 headless 支持,OpenClaw 连不上。

这就是信创环境最典型的尴尬:CPU 架构换了,软件生态没跟上。Chromium 作为 Chrome 的开源上游,天生支持 arm64,而且统信 UOS ARM64 和麒麟 ARM64 都能跑,所以它成了 OpenClaw 在信创机器上最稳的浏览器底座。你要做的三件事很明确:装一个能用的 Chromium、让 OpenClaw 找到它、再通过 TaoToken 的统一 Key 把模型调用链路接上。

这篇就按这个顺序来,命令都能直接复制。适合正在国产化平台做 AI Agent 落地、被 arm64 浏览器坑过的同学。装完之后,OpenClaw 的 browser 工具就能正常拉起窗口,配合 TaoToken 的 API 通道完成页面理解和操作。

2. 动手前:TaoToken 统一 Key 与 OpenClaw 的关系

OpenClaw 本身是个 Agent 框架,它负责调度浏览器、读写文件、跑命令,但真正“思考”的那部分要接大模型。信创机器上直连各家模型 API 经常遇到网络和账号问题,TaoToken 在这里扮演的是统一入口:一个 Key、一套 OpenAI 兼容协议,就能调用多个模型,省去在每台国产机器上分别配账号的麻烦。

你需要提前准备两样东西:

一是 TaoToken 的 API Key。登录官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 注册后,进控制台 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 创建,在 API Keys 页面 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 复制出来,形如sk-开头的一串。

二是确认接口地址。TaoToken 的 API 基址是https://taotoken.net/api,兼容 OpenAI 的/v1/chat/completions格式,OpenClaw 里填 base_url 时用这个即可。文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ,遇到参数不确定可以对照。

注意:Key 只存在本机配置文件里,别提交到 Git,也别贴到聊天窗口。信创内网机器建议单独建一个只读账号跑 OpenClaw。

如果你后面要长期跑编码类 Agent 任务,可以了解下 Coding Plan https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ,额度模型更适合高频调用;只是临时验证模型通不通,用模型对话页 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 先测一下更省事。

3. 可复制配置:Chromium 安装 + settings.json 骨架

3.1 安装 arm64 Chromium

先把 Chromium 的 deb 包下载到同一个目录,比如~/chromium-deb/。统信 UOS ARM64 和麒麟 ARM64 通用,下载来源参考社区整理的 arm64 包即可。放好后进目录批量安装:

cd ~/chromium-deb sudo dpkg -i *.deb

如果提示依赖缺失,补一条自动修复:

sudo apt-get -f install -y

装完验证版本和架构:

chromium --version uname -m

uname -m输出aarch64就说明是 arm64 环境,chromium --version能打印版本号就代表装好了。这一步是整个链路的地基,装不上后面全白搭。

3.2 OpenClaw 侧 settings.json 骨架

OpenClaw 的配置文件在~/.openclaw/openclaw.json,用 nano 打开:

nano ~/.openclaw/openclaw.json

在文件里加入或修改 browser 段和模型段。下面是一份可直接套用的骨架,把sk-你的Key换成自己的:

{ "browser": { "enabled": true, "defaultProfile": "clawd", "headless": false, "color": "#FF4500", "executablePath": "/usr/bin/chromium", "remoteDebuggingPort": 9222 }, "model": { "provider": "openai-compatible", "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的Key", "model": "gpt-4o-mini" } }

几个参数说明一下。enabled打开浏览器控制;defaultProfile用独立配置目录,避免和你日常浏览器串数据;headless调试阶段设 false,能看到窗口方便排查;executablePath指向刚装的 chromium,不确定路径就用which chromium查;remoteDebuggingPort是 OpenClaw 和浏览器通信的端口,别和系统其他服务冲突。

提示:如果which chromium返回的是/usr/bin/chromium-browser,把 executablePath 改成那个路径。不同发行版软链名字不一样。

保存退出后重启网关:

openclaw-cn gateway restart

3.3 参数对照表

配置项作用建议值
browser.enabled是否启用浏览器控制true
browser.headless是否无头运行调试 false,生产 true
browser.executablePathChromium 可执行文件路径which chromium 的结果
browser.remoteDebuggingPort远程调试端口9222
model.baseUrl模型接口基址https://taotoken.net/api
model.apiKeyTaoToken 统一 Keysk- 开头

4. 验证请求:从浏览器状态到模型连通

配置改完别急着上业务,先分两步验证。

第一步看浏览器状态:

openclaw-cn browser status

正常会返回 enabled 为 true、profile 为 clawd 之类的信息。如果显示 disabled,说明 json 没生效,检查是不是有语法错误,比如多了逗号或少了引号。

第二步启动浏览器:

openclaw-cn browser start

成功的话会自动弹出一个 Chromium 窗口,标题栏或 UI 带一点橙色标识(就是 color 配的 #FF4500)。窗口能打开,说明 OpenClaw 已经成功接管浏览器。

第三步验证模型通道。用 curl 直接打 TaoToken 的接口,确认 Key 和网络都通:

curl https://taotoken.net/api/v1/chat/completions \ -H "Authorization: Bearer sk-你的Key" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-4o-mini", "messages": [{"role": "user", "content": "回复 ok"}] }'

返回 JSON 里choices有内容,就说明模型链路通了。这一步和浏览器是两条独立链路,分开验证能快速定位问题出在哪边。

两条都通之后,在 OpenClaw 里发一个带浏览器动作的指令,比如让它打开某个页面并读取标题。窗口里能看到页面加载、DOM 被读取,整条链路就算跑通了。

5. 本篇常见错排查

dpkg 报依赖错误:多半是缺库,跑sudo apt-get -f install -y自动补齐。信创源里如果没有对应包,换官方源或离线包补。

browser status 显示 disabled:json 语法问题最常见。用python3 -m json.tool ~/.openclaw/openclaw.json校验一下,能格式化输出就说明语法没问题。

browser start 没反应或闪退:先确认 executablePath 对不对,手动在终端敲chromium看能不能起来。arm64 上如果缺图形库,装libnss3、libatk-bridge2.0-0这类依赖。

curl 返回 401:Key 错了或没带 Bearer 前缀。回控制台重新复制一次,注意别把空格带进去。

curl 返回超时:检查机器能不能访问taotoken.net,内网机器确认 DNS 和出口策略。这一步和浏览器无关,单独排查。

端口 9222 被占用:换一个端口,比如 9223,同时改 json 里的 remoteDebuggingPort,重启网关。

改了配置不生效:OpenClaw 读的是重启时的配置,改完必须openclaw-cn gateway restart,只改文件不重启没用。

6. 接下来怎么走

浏览器和模型两条链路都验证通过后,你就可以在 OpenClaw 里跑真正的 Agent 任务了。日常高频调用建议把 Key 换成 Coding Plan 的额度,长期跑更划算;只是偶尔测模型,用模型对话页快速验证就行。接入过程中如果报错,优先看 API Keys 和接入文档两处,大部分配置问题都能对上。

信创 arm64 这条路不好走,但 Chromium 加 TaoToken 这套组合实测下来是能稳定跑通的。装的时候耐心点,把依赖和路径确认清楚,后面就顺了。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询