AionClaw后端需配置静态Token认证以防止未授权访问;在config.toml中添加[auth]段并设enabled=true及非空ASCII token(如"aion-2026-claw-secure-8f3b"),重启服务后用curl带Bearer Token验证健康接口返回200或401确认生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

给AionClaw后端接口添加身份验证,是为了防止未授权访问其API服务,避免他人调用你的本地智能体执行命令或读取对话历史。这一步必须在后端启动前完成,否则服务会以无鉴权模式暴露在本地网络中。
确认AionClaw是否启用内置Token认证
打开AionClaw安装目录下的config.toml文件,查找auth段落。若不存在该段,则默认关闭Token校验,所有HTTP请求均可直通;若存在且enabled = true,则继续检查token字段值是否为非空字符串。
注意:AionClaw不支持Basic Auth或JWT自动签发,只接受静态Token比对——这意味着你必须手动设定一个固定密钥,并在每次请求Header中携带Authorization: Bearer
配置静态Token并启用认证
在config.toml末尾新增如下内容(不要缩进错误,不要混用中文引号):
[auth]
enabled = true
token = "aion-2026-claw-secure-8f3b"
这串token可任意修改,但【必须是ASCII字符、不含空格、长度建议不少于16位】。曾有用户填入含中文顿号的字符串,导致服务启动失败且日志无明确报错,仅在backend.log首行出现"auth: invalid token format"提示。
验证Token是否生效
方法一:使用curl发送带Token的健康检查请求
终端执行:curl -H "Authorization: Bearer aion-2026-claw-secure-8f3b" http://127.0.0.1:18789/health
返回{"status":"ok"}即表示认证已启用且Token正确。
方法二:故意发送错误Token观察拦截行为
执行:curl -H "Authorization: Bearer wrong" http://127.0.0.1:18789/health → 应返回HTTP 401状态码及{"error":"unauthorized"}响应体。若仍返回200,说明config.toml未被重载或文件路径错误。
重启AionClaw服务使配置生效:关闭客户端→双击桌面图标重新启动,或在终端中执行./bin/stop.sh && ./bin/start.sh(macOS/Linux)/ stop.bat && start.bat(Windows)。

















